Home

X-Stream Oscilloscopes Remote Control Manual

Contents

1. AuxOutput ActiveChannels Auto Enum Auto H E ExtCoupling undef Enum c2 ExternalClockRate Double From 0 to le C3 HorOffset Double From 0 000 T HorOffsetOrigin Double From 0 to 10 i3 c HorScale DoubleLockstep From 1 009 Channels HorScaleDown Action 4 n a Horizontal HorScaleUp Action 4 41 1 Trigger HorUnits String R Any number H E WaitObject MaxSamples 8000000 DoubleLockstep From 8e 00 E I Cursors MaxSamplesDown Action 4 n a CustomDSO MaxSamplesUp Action 4 is NumOfFAdcs 2 Integer R From 1 to 12 P Display NumPoints 1000 Integer R From 2 to 10 4 21 Ethernet NumSegments 10 Integer g From 2 to 40 H E Hardcopy ReferenceClock Enum INT EXT Help RISType BetterCentered Enum Replace Bett Math SampleClock Internal Enum Internal Exte EN SampleMode RealTime Enum RealTime RIS Measure 5 88 Memory SampleRate 1000000000 DoubleLockstep From 500 to T SamplingRate 2000000000 Double From 1 to 2e i PassFail SamplingRateDown Action nja H E SamplingRateUp Action nja Preferences SequenceTimeout Double From to 5 5 1 SaveRecall EAE i Pa 52 app Acquisition Horizontal HorScale 2 The statement at the bottom of the screen is the one that will be placed in the clipboard when the icon is clicked The column labeled F contains Flags and Status values For example R means read and
2. inneren 39 Introduction to Software 5 40 Using ActiveDSQ 5 noinine suede 40 CONTROL nnns enne 40 CHAPTER FOUR UNDERSTAND AND MANAGE WAVEFORMS 50 Know Your Wave fOr 51 EOGIGAE DATA BLOCKS rrt ter Ere e e tort ueste burgo ceu 51 INSPECT WAVEFORM 12000 0000 000 nennen senten nennen nennen ns 52 USE THE WAVEFORM QUERY 54 INTERPRET VERTICAL DATA ret 57 CALCULATE DATA POINT S HORIZONTAL 58 USE THE WAVEFORM COMMAND sese nennen nnns nnns en nennen 60 Transfer Waveforms at High Speed 61 CHAPTER FIVE CHECK WAVEFORM STATUS 62 Use Status Registers eoe erre pecudis 63 OVERVIEW ii rueda ette E er per 63 STATUS BYTE REGISTER 5 65 STANDARD EVENT STATUS REGISTER 65 STANDARD EVENT STATUS ENABLE REGISTER 66 SERVICE REQUEST EN
3. 278 APPENDIX Il WAVEFORM TEMPLATE 279 Waveform Template 279 281 Decoding Floating Point 291 How to Construct a Floating Point Number from Four 296 WM RCM E Rev D ISSUED February 2005 V BLANK PAGE ISSUED February 2005 WM RCM E Rev D INTRO D U C TION About this Manual This manual explains how to control the instrument from a computer using commands keyed or programmed into an external controller This controller is usually a computer but it could be a simple terminal The manual includes a complete list of the commands that you will need to perform remote control operations with the instrument The manual has two main parts Part One About Remote Control covers the principles of remote control and offers practical examples Part Two Commands describes each of the remote control commands and queries for instrument operations It starts with two special indexes that list the commands by short name and by category Use these to find the command or query you want to use As an additional guide each chapter is prefaced by a summary of its contents Watch for these icons and the information they signal TIPs offer additional hints on how
4. cesse 86 APPENDIX PROGRAMMING EXAMPLES 259 Introduction to Instrument Software Tools 259 EXECUTABLE PROGRAMS esses 259 Source Code Example 1 260 USE THE INTERACTIVE GPIB PROGRAM 260 Source Code Example 2 261 USE THE GPIB PROGRAM FOR PC HIGH LEVEL FUNCTION CALLS 261 Source Code Example 263 USE THE GPIB PROGRAM FOR LOW LEVELFUNCTION CALLS 263 Source Code Example ActiveDSO 1 and 2 sese 266 Source Code Example ActiveDSO 3 and 268 Source Code Example ActiveDSO 5 eese entente 271 Translation 271 Introduction to 9 0 272 USING Active DSO i iii m 273 INStANTIATIO NN siisii naa a A aa Aa iaia 273 Example Using PowerPoint 97 eene nennen nennen nnne nnn nnn nnn nnns 274 Example Mm E
5. EPS 182 197 PART Two CURSOR DESCRIPTION all parameters Amplitude Area Base Cycles on screen Delay Delta delay Delta time at level duration of acquisition duty cycle Duty cycle at level Edges at level Fall time 80 to 20 Fall time 90 to 10 Fall at levels COMMANDS PARAMETER VALUE PAVA Query The PARAMETER_VALUE query returns the current values of the pulse waveform parameters and mask tests for the specified trace Traces do not need to be displayed or selected to obtain the values measured by the pulse parameters or mask tests AVAILABLE ON ALL MODELS First cursor Frequency EV Clock to data time Last cursor position Maximum value Mean value 5 Minimum value lt go 2 phase difference Z Overshoot negative Overshoot positive Peak to peak Period Phase difference Population of bin at x RISE Rise time 10 to 90 RISE28 Rise 20 to 80 RLEV Rise time at levels MS root mean square SETUP Data edge to clock edge SDEV Standard deviation TLEV Time at level S 5 5 B WID E gt amp WIDLV XMAX Pos of max data value XMIN Pos if min data value XAPK Nth highest hist peak CUSTn Custom parameter The numbers in the terms CUST1 through CUSTS refer to the line numbers
6. FILE IRHCP1 PNG AREA GRIDAREAONLY PRINTER G NEVSVRHP4050RD J The following example selects output to the printer named Local Printer CMD HCSU DEST PRINTER PRINTER Local Printer CALL IBWRT SCOPE CMDS SCREEN_DUMP Hard copy command parameters are grouped in pairs The first in the pair names the variable to be modified while the second gives the new value to be assigned Pairs can be given in any order and can be restricted to those variables to be changed Omitted variables will be unaffected ISSUED February 2005 WM RCM E Rev D DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties HOR_MAGNIFY HMAG Command Query The HOR_MAGNIFY command horizontally expands the selected expansion trace by a specified factor Magnification factors not within the range of permissible values will be rounded off to the nearest legal value The VAB bit bit 2 in the STB register see table on page 225 is set when a factor outside the legal range is specified The HOR MAGNIFY query returns the current magnification factor for the specified expansion function lt exp_trace gt Hor_MAGnify lt factor gt lt exp_trace gt F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TD TA through TD are included for backward compatibility with software designed for earlier LeCroy instruments These fou
7. PRE 16 CALL IBWRT SCOPE CMDS IST ISSUED February 2005 213 PART Two COMMANDS RCL SAVE RECALL SETUP Command DESCRIPTION The RCL command sets the state of your instrument using one of the six non volatile panel setups Panel 1 to Panel 6 by recalling the complete front panel setup of the oscilloscope Entering panel setup 0 corresponds to the default panel setup The RCL command produces an effect the opposite of the SAV command If the desired panel setup is not acceptable the EXecution error status Register EXR is set and the EXE bit of the standard Event Status Register ESR is set COMMAND SYNTAX RCL lt panel_setup gt lt panel_setup gt 0 to 6 EXAMPLE GPIB The following instruction recalls your instrument setup previously stored in panel setup 3 CMD RCL 3 CALL 5 CMDS RELATED COMMANDS PANEL_SETUP SAV EXR 214 ISSUED February 2005 WM RCM E Rev D SAVE RECALL SETUP DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties RECALL PANEL RCPN Command The RECALL_PANEL command recalls a front panel setup from the current directory on mass storage ReCall PaNel DISK device FILE lt filename gt device FLPY HDD filename A string of up to eight characters with the extension LSS Include the path to the file for example
8. Histogram base Histogram percentile Histogram right bin Histogram bin population Histogram median RANGE Histogram range Histogram RMS SIGMA Histogram standard dev Histogram top TOTP Histogram total pop Histogram left bin XAPK Histogram Nth peak Histogram max pop PARAMETER COMPUTATION STATES averaged over several up to 100 periods Signal partially in overflow greater than given value OK Deemed to be determined without problem invalid value insufficient data provided OU Signal partially in overflow and underflow less than given value Window has been period truncated no pulse waveform UF signal partially in underflow MASK TEST NAMES all points of waveform inside SOME_IN some points of waveform inside mask mask TRUE 1 FALSE 0 TRUE 1 FALSE 0 all points of waveform outside SOME_OUT some points of waveform outside mask mask TRUE 1 FALSE 0 TRUE 1 FALSE 0 WM RCM E Rev D ISSUED February 2005 20 1 PART Two COMMANDS QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB 202 trace PArameter VAlue lt parameter gt lt parameter gt trace F1 F2 F3 FA F5 F6 F7 F8 TA TB TC TD C1 C2 C3 C4 TA through TD are for backward compatibility and are not returned by queries NOTE When PAVA Is used to query a Custom parameter the prefix is returned for consistency However the source for the measurement is the
9. CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RSP PRINT RSP Response message STB 0 ALL_STATUS CLS PRE SRE ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties ADDITIONAL INFORMATION STATUS BYTE REGISTER STB Bit Bit Value Bit Name Description Note 7 128 DIO7 0 reserved for future use 6 64 MSS RQS at least 1 bit in STB masked by SRE is 1 service is requested 5 32 ESB 1 an ESR enabled event has occurred 4 16 1 output queue is not empty i 3 8 DIO3 0 reserved 2 4 VAB a command data value has been adapted 1 2 DIO1 reserved 0 1 1 an enabled internal state change has occurred NOTE For the above table 1 The Master Summary Status MSS indicates that the oscilloscope requests service while the Service Request status when set specifies that the oscilloscope issued a service request Bit position 6 depends on the polling method Bit 6 MSS if an STB quety is received RQS if serial polling is conducted Example If SRE 10 and STB 10 then MSS 1 If SRE 010 and STB 100 then MSS 0 The Event Status Bit ESB indicates whether or not one or more of the enabled IEEE 488 2 events have occurred since the last reading or clearing of the Standard Event Status Register ESR ESB is set if an enabled event becomes true 1 The Message AVailable bit MAV indicates whether or not the Output queue is empty The MAV summary b
10. CALL IBWRTF SCOPE FILES RCL SAV ISSUED February 2005 1 81 PART Two COMMANDS CURSORS DESCRIPTON COMMAND SYNTAX QUERY SYNTAX RESPONSE SYNTAX EXAMPLE GPIB 182 PARAMETER PARM Command Query This command turns statistics and histicons on or off PARM lt type gt readout Type CUST HPAR VPAR OFF Readout STAT HISTICON BOTH OFF Without argument state of histograms and statistics is unchanged Unlike CRMS PARM does not change the state of cursors or pass fail PARAMETER or PARM PARM The fol lt type gt lt readout gt llowing instruction turns the histicons on CMD PARM CUST HISTICON CALL IBWRT SCOPE CMDS I SSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties CURSOR PARAMETER CLR PACL Command DESCRIPTION The PARAMETER CLR command clears all the current parameters from the 8 line list used in the Custom and Pass Fail modes COMMAND SYNTAX PArameter_CLr RELATED COMMANDS PARAMETER DELETE PARAMETER VALUE WM RCM E Rev D ISSUED February 2005 183 PART Two CURSOR DESCRIPTION COMMANDS PARAMETER CUSTOM PACU Command Query The PARAMETER CUSTOM command controls the parameters that have customizable qualifiers and can also be used to assign any parameter for histogramming NOTE When PAVA is used to query a Custom parameter the prefix is re
11. The COMM HEADER command controls the way the oscilloscope formats responses to queries There are three response formats LONG in which responses start with the long form of the header word SHORT where responses start with the short form of the header word and OFF for which headers are omitted from the response and units in numbers are suppressed Unless you request otherwise the SHORT response format is used gt This command does not affect the interpretation of messages sent to the oscilloscope Headers can be sent in their long or short form regardless of the COMM_HEADER setting gt Querying the vertical sensitivity of Channel 1 may result in one of the following responses COMM_HEADER RESPONSE LONG C1 VOLT_DIV 200E 3 V SHORT C1 VDIV 200E 3 V OFF 200 3 Comm_HeaDeR lt mode gt mode SHORT LONG OFF Comm_HeaDeR Comm_HeaDeR lt mode gt The following code sets the response header format to SHORT CMD CHDR SHORT CALL IBWRT SCOPE CMDS COMM_HELP_LOG ISSUED February 2005 1 0 9 PART Two COMMANDS COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 110 COMM_HELP CHLP Command Query The COMM_HELP command controls the level of operation of the diagnostics utility Remote Control Assistant which assists in debugging remote control programs Selected using your instrument s Utilities menu Rem
12. This ActiveX control enables LeCroy oscilloscopes to be controlled by and to exchange data with a variety of Windows applications that support the ActiveX standard MS Office programs Internet Explorer Visual Basic Visual C Visual Java and MATLAB v5 3 are a few of the many applications that support ActiveX controls ActiveDSO is available on the internet at http www lecroy com tm library software With ActiveDSO you can develop your test program using standard GPIB commands For easy integration of your scope data with your Windows Application through GPIB or Ethernet 10BaseT 100BaseT ActiveDSO helps you Generate a report by importing scope data right into Excel or Word e Archive measurement results on the fly in a Microsoft Access Database e Automate tests using Visual Basic Java C Excel VBA e The ActiveDSO control hides the intricacies of programming and provides a simple and consistent interface to the controlling application With less than 10 lines of VBA Visual Basic for Applications code in an Excel macro the spreadsheet can recover pre scaled waveform data from a remote instrument e The ActiveDSO control can also be embedded visually in any OLE automation compatible client and can be used manually without any need for programming It will run on any PC running Windows 95 Windows 98 or Windows NT There are two fundamental ways to use the control e As a visible object embedded in OLE Autom
13. 08 5 1 4 149 08 S 58 ISSUED February 2005 WM RCM E Rev D CHAPTER FOUR Understanding and Managing Waveforms Sequence waveforms are really many independent acquisitions so each segment will have its own horizontal offset These can be found in the TRIGTIME array For the nth segment HORIZ INTERVAL x i TRIGGER_OFFSET n The TRIGTIME array can contain up to 200 segments of timing information with two eight byte double precision floating point numbers for each segment RIS Random Interleaved Sampling waveforms are composed of many acquisitions interleaved together The descriptor parameter RIS SWEEPS gives the number of acquisitions The point will belong to the segment where m modulo RIS SWEEPS will have a value between 0 and RIS SWEEPS 1 Then with j i m x HORIZ INTERVAL x j RIS OFFSET m where the RIS_OFFSETs can be found in the RISTIME array There can be up to 100 eight byte double precision floating point numbers in this block The instrument tries to get segments with times such that RIS PIXEL OFFSET i 0 5 x HORIZ INTERVAL Thus taking as an example a RIS with RIS SWEEPS 10 HORIZ INTERVAL 1 ns and PIXEL OFFSET 0 0 we might find for a particular event that RIS OFFSET 0 0 5 ns RIS_OFFSET 2 1 6 ns RIS OFFSET 4 3 4 ns RIS OFFSET 6 5 6 ns RIS OFFSET 8 7 6 ns RIS OFFSET I 0 4 ns RIS_OFFSET 3 2 6 ns
14. 1 ANSI IEEE Std 488 2 1987 IEEE Standard Codes Formats Protocols and Common Commands The Institute of Electrical and Electronics Engineers Inc 345 East 47th Street New York NY 10017 USA WM RCM E Rev D ISSUED February 2005 33 PART ONE ABOUT REMOTE CONTROL Scope Rear Panel The LAN connector is shown in the illustration above item 8 e Supports IEEE 802 3 Ethernet standards e Supports 10Base T and 100Base T Ethernet Connection The instrument operates over a standard 10Base T 100Base T Ethernet connection The instrument can be plugged into a network or operated from a direct connection to a host computer A different type of cable is required for each of these connections For a direct connection to the PC a crossover cable is required whereas the network connection is made using a straight cable Headers for LAN Data Transfers The format of the header sent before each data block both to and from the instrument is set out in the following table Operation Header Version Sequence Number Spare reserved for future expansion Block Length bytes of data LSB Block Length bytes of data Block Length bytes of data Block Length bytes of data MSB The sequence number is used to synchronize write read operations to simulate 488 2 discard unread response behavior Valid range is 1 to 255 zero is omitted intentionally 3 4 ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Control by LA
15. MT FAIL ACTIONS MT OPC MT COUNTERS MT SELECT TEST 17 4 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties 5 STATE MTTS ET PMT Command Query DESCRIPTION Controls the test execution RUN STOP or PAUSE CONTINUE COMMAND SYNTAX MT TEST STATE test state test state RUN STOP CONTINUE PAUSE QUERY SYNTAX MTTS RESPONSE FORMAT MTTS test state test state RUN STOP CONTINUE PAUSE RELATED COMMANDS CUSTOM APPLICATION CUSTOM OPTIONS MT FAIL ACTIONS MT OPC MT COUNTERS MT SYMBOL WM RCM E Rev D ISSUED February 2005 175 PART Two COMMANDS ET PMT DESCRIPTION COMMAND SYNTAX RELATED COMMANDS 176 MT_VERTICAL ALIGN MTVA Command Performs offset alignment for STM 1E STS 3E and 139M MT_VERTICAL_ALIGN CUSTOM APPLICATION CUSTOM OPTIONS MT FAIL ACTIONS MT OPC MT COUNTERS MT SYMBOL ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties OFFSET OFST Command Query The OFFSET command allows adjustment of the vertical offset of the specified input channel The maximum ranges depend on the fixed sensitivity setting See the Operators Manual for specifications If an out of range value is entered the oscilloscope is set to the closest possible value an
16. Remote Control Commands and Queties The following instruction sets the trigger delay to 20 s post trigger CMD TRDL 20S CALL IBWRT SCOPE CMDS DIV TRIG COUPLING TRIG LEVEL MODE TRIG SELECT TRIG SLOPE ISSUED February 2005 239 PART Two COMMANDS ACQUISITION DESCRIPTION COMMAND SYNTAX NOTE The unit V is optional QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB RELATED COMMANDS 240 TRIG LEVEL TRLV Command Query The TRIG_LEVEL command adjusts the trigger level of the specified trigger source An out of range value will be adjusted to the closest legal value and will cause the VAB bit bit 2 in the STB register to be set The TRIG_LEVEL query returns the current trigger level lt trig_source gt TRig_LeVel lt trig_level gt lt trig_source gt C1 C2 C3 C4 EX EX10 ETM10 trig source TRig_LeVel trig source TRig LeVel trig level trig source C3 only on four channel instruments The following instruction adjusts the trigger level of Channel 2 to 3 4 V CMD 2 C2 TRLV 3 4V CALL IBWRT SCOPE CMDS TRIG COUPLING TRIG DELAY TRIG MODE TRIG SELECT TRIG SLOPE ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties ACQUISITION TRIG MODE TRMD Command Query DESCRIPTION The TRIG_MODE command specifies the trigger mode TRIG MO
17. 5 Hither select the Run Run Sub UserForm ot press function key F5 NOTE For more information see the ActiveDSO on line Help On line Help contains VisualC example explanations of ActiveDSO Methods and Properties 885 27 8 ISSUED February 2005 WM RCM E Rev D APPENDIX II Waveform Template Waveform Template This appendix contains the Waveform Template that describes the contents of the Waveform Descriptor that is produced by the commands WF DESC and WF ALL After the template are explanations of the construction of floating point numbers from bytes in the descriptor followed by program fragments that show a method of performing the calculations Waveform Template This template is the oscilloscope s response to a TMPL query 00 000000 LECROY 2 3 TEMPLATE 8 66 111 Explanation of the formats of waveforms and their descriptors on the LeCroy Digital Oscilloscopes Software Release 8 1 0 98 09 29 A descriptor and or a waveform consists of one or several logical data blocks whose formats are explained below Usually complete waveforms are read at the minimum they consist of the basic descriptor block WAVEDESC a data array block Some more complex waveforms e g Extrema data or the results of a Fourier transform may contain several data array blocks When there are more blocks they are in the following sequence the basic descriptor block WAVEDESC the history text descriptor block USERTEXT may or may not be
18. COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 232 TIME DIV TDIV Command Query The TIME DIV command modifies the timebase setting The new timebase setting can be specified with units NS for nanoseconds US for microseconds MS for milliseconds S for seconds or KS for kiloseconds Alternatively you can use exponential notation 10E 6 for example An out of range value causes the VAB bit bit 2 in the STB register see table on page 225 to be set The TIME DIV query returns the current timebase setting Time_DIV lt value gt lt value gt See the Operators Manual for specifications The unit S seconds is optional Time_DIV Time_DIV lt value gt he following instruction sets the time base to 500 MDS TDIV 500US CALL IBWRT SCOPE CMD T The following instruction sets the time base to 2 msec div MD TDIV 0 002 CALL IBWRT SCOPE CMDS TRIG_DELAY TRIG_MODE ISSUED February 2005 WM RCM E Rev D MISCELLANEOUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties TST Query The TST query performs an internal self test the response indicating whether the self test has detected any errors The self test includes testing the hardware of all channels the timebase and the trigger circuits Hardware failures
19. COMMANDS RESPONSE FORMAT AVAILABILITY EXAMPLES GPIB RELATED COMMANDS 162 lt trace gt INSPect lt string gt lt string gt A string giving name s and value s of a logical block or a variable trace C3 C4 only on four channel oscilloscopes The following instruction reads the value of the timebase at which the last waveform in Channel 1 was acquired CMDS C1 INSP TIMEBASE CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RSPS PRINT RSPS Response message Cl INSP TIMEBASE 500 US DIV The following instruction reads the entire contents of the waveform descriptor block CMD C1 INSP WAVEDESC COMM FORMAT TEMPLATE WAVEFORM SETUP ISSUED February 2005 WM RCM E Rev D DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties INTENSITY INTS Command Query The INTenSity command sets the intensity level of the grid The command TRACE n is accepted for backward compatibility but the actual trace intensity is always 100 INTenSity GRID lt value gt TRACE lt value gt PCT lt value gt 0 to 100 in percent GRID and TRACE may be interchanged the order is immaterial INTenSity INTenSity TRACE lt value gt GRID lt value gt The following example sets the grid intensity to 70 CMD INTS GRID 70 CALL IBWRT SCOPE CMDS ISSUED
20. D NApplicationsNUSB2MSetupsNCHIRP MEAS LSS The following instruction recalls the front panel setup from file P012 LSS on the floppy disk CMDS RCPN DISK FLPY FILE P012 LSS CALL IBWRT SCOPE CMDS PANEL SETUP SAV STORE PANEL RCL ISSUED February 2005 21 5 PART Two COMMANDS ACQUISITION REFERENCE CLOCK Command Query DESCRIPTION The REFERENCE CLOCK command allows you to choose between the internal reference clock and an external reference clock COMMAND SYNTAX Reference CLocK state lt state gt INTERNAL EXTERNAL QUERY SYNTAX Reference CLocK RESPONSE FORMAT lt state gt The following instruction sets the instrument to use an external reference clock EXAMPLE GPIB CMD RCLK EXTERNAL CALL IBWRT SCOPE CMD 216 ISSUED February 2005 WM RCM E Rev D SAVE RECALL SETUP DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties RST Command The RST command initiates a device reset RST sets all eight traces to the GND line and recalls the default setup RST The following instruction resets the oscilloscope CMDS RST CALL IBWRT SCOPE CMDS CAL RCL ISSUED February 2005 21 7 PART Two COMMANDS ACQUISITION SAMPLE CLOCK SCLK Command Query DESCRIPTION The SAMPLE CLOCK command allows you to choose between the internal sample cloc
21. F1 DEF EQN AVG C1 AVGTYPE SUMMED SWEEPS 200 I CALL IBWRT SCOPES CMD CALL IBWRT SCOPES CMD The following instruction defines Trace F1 to compute the product of Channel 1 and Channel 2 CMD F1 DEF EQN Cl C2 CALL IBWRT SCOPE CMD WM RCM E Rev D ISSUED February 2005 13 1 PART Two COMMANDS The following instruction defines Trace 1 to compute the Power Spectrum of the FFT of Channel 1 The window function is Rectangular CMDS F1 DEF EQN PS FFT C1 WINDOW RECT CALL IBWRT SCOPE CMDS The following instruction defines Trace F2 to compute the Power Average of the Power Spectrum of Channel 1 over a maximum of 244 sweeps CMD F2 DEF EQN AVG FFT C1 TYPE POWERSPECTRUM WINDOW RECTA NGULAR ALGORITHM POWER2 FILLTYPE TRUNCATE SUPPRESSDC ON AVERAGETYPE SU MMED SWEEPS 244 The following instruction defines Trace F3 to construct the histogram of the rise time measurements made on source Channel 1 The tise time measurement is defined on custom line 2 The histogram has a linear vertical scaling accumulates up to 1000 parameter values and rescales automatically The rise time parameter values are binned into 100 bins CMDS PACU 2 RISE C1 CALL IBWRT SCOPE CMDS CMD F3 DEF EQN HIST P2 VALUES 1000 BINS 100 HORSCALE 1 S CENTER 0E 12 S VERSCALETYPE LINEAR AUTOFINDSCALE ON CAL
22. February 2005 1 63 PART Two COMMANDS ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE RELATED COMMANDS 164 INTERLEAVED ILVD Command Query The INTERLEAVED command enables or disables random interleaved sampling RIS for timebase settings where both single shot and RIS mode ate available RIS is not available for sequence mode acquisitions If sequence mode is on ILVD ON turns it off The response to the INTERLEAVED query indicates whether the oscilloscope is in RIS mode InterLeaVeD mode mode ON OFF InterLeaVeD InterLeaVeD mode The following instructs the oscilloscope to use RIS mode CMD ILVD ON CALL IBWRT SCOPES CMD TIME DIV TRIG MODE MEMORY SIZE SEQUENCE ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties IST Query The IST Individual STatus query reads the current state of the IEEE 488 1 defined ist local message The ist individual status message is the status bit sent during a parallel poll operation IST IST value value 0 or 1 The following instruction causes the contents of the IST bit to be read CMD 2 IST CALL IBWRT SCOPE CMDS CALL IBRD SCOPES RSP PRINT RSP Response message IST O PRE ISSUED Fe
23. ISSUED February 2005 WM RCM E Rev D MISCELLANEOUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties CAL OUTPUT COUT Command Query The CAL OUTPUT command is used to set the type of signal put out through the instrument front panel s CAL BNC connector Cal OUTput lt mode gt level rate Cal OUTput PULSE lt width gt mode OFF CALSQ PF TRIG LEVEL ENABLED lt level gt 5 mV to 1 00 V into 1 MQ rate 5 Hz to 5 MHz Cal OUTput Cal OUTput lt mode gt lt level gt lt rate gt The following instruction sets the calibration signal to give a 0 to 0 2 volt 10 kHz square wave CMD COUT CALSQ 0 2 V 10 kHz CALL IBWRT SCOPE CMDS PASS FAIL DO ISSUED February 2005 99 PART Two COMMANDS ADDITIONAL INFORMATION NOTATION Provides a square signal Provides a DC signal at the requested level Provides no signal ground level Pass Fail mode Provides a single pulse Trigger Out mode 10 0 ISSUED February 2005 WM RCM E Rev D FUNCTION DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties CLEAR_MEMORY CLM Command The CLEAR_MEMORY command clears the specified memory Data previously stored in this memory are erased and memory space is r
24. Look for in command string If InStr NextData Query gt 0 Then Collect response from instrument Worksheets Sheet1 11 Row Column 2 Value o ReadString 1000 End If Check for Error If o ErrorFlag True Then Show error message Worksheets Sheet1 11 Row Column 2 Value o ErrorString Waiting True HoldOff 0 ErrorFound Tru Store command line for restart Worksheets Sheet1 115 2 6 Value Row 1 End If End If Next Counter h Release the control Call o SetRemoteLocal 0 Set o Nothing End Sub ActiveDSOExcel4 is a similar program using the Pass Fail system WM RCM E Rev D 27 0 ISSUED February 2005 GPIB Program Examples EXAMPLE ACTIVEDSO 5 The picture below shows the screen of program Active DSOVB1 a Visual Basic program using ActiveDSO w ACTIVEDSO VISUAL BASIC EXAMPLE ONE p MAX 154E 3 VLOK MAX 154E 3 MAX 154E 3 50 Triggers in total This example shows how to arm the trigger get a parameter from the X Stream DSO get waveforms and draw them on the screen of the PC TRANSLATION EXAMPLES Some source code examples are available for decoding binary waveform files These are TranWM in Microsoft Visual Basic and TraceLook in VBA Microsoft Excel WM RCM E Rev D ISSUED February 2005 271 APPENDIX I Program Examples INTRODUCTION TO ACTIVEDSO
25. RIS OFFSET 5 4 5 ns RIS 6 4 ns RIS OFFSET 9 8 5 ns and therefore x 0 RIS OFFSET 0 0 5 ns 1 RIS OFFSETT 1 0 4 ns x 9 7 RIS OFFSET 9 8 5 ns x 10 1 ns x 10 0 5 9 5 ns x 11 7 1nsx 10 0 4 10 4 ns x 19 1ns 10 8 5 18 5 ns x 20 1 ns 20 0 5 19 5 ns WM RCM E Rev D ISSUED February 2005 59 PART ONE ABOUT REMOTE CONTROL USE THE WAVEFORM COMMAND Waveforms you read with the WAVEFORM query can be sent back into your instrument using WAVEFORM and related commands Since the descriptor contains all of the necessary information you need not be concerned with any of the communication format parameters The oscilloscope will learn all it needs to know from the waveform TIP Because waveforms can only be sent back to the instrument memory traces M1 MZ M3 M4 consider removing or changing the prefix C1 or CHANNEL 1 in the response to the WF query See Part Two for examples To ensure that the descriptor is coherent however when you synthesize waveforms for display or comparison 5 EX read out a waveform of the appropriate size and then replace the data with the desired values Here are among the many ways to use WAVEFORM and its related commands to simplify or speed up work Partial Waveform Readout Use WAVEFORM SETUP to specify a short part of a waveform for readout as well as to select a sparsing factor for reading every nth data point o
26. Shift a waveform in time by a specified amount WM RCM E Rev D ISSUED February 2005 127 PART Two COMMANDS ERES lt source gt lt bits gt EXCELMATH lt soutce1 gt lt source2 gt lt sourcel cell gt lt soutce2cell gt lt outputcell gt lt sourcelheadercell gt lt source 2headercell gt lt outputheadercell gt lt withheader gt lt output enable gt lt sourcelenable gt lt source2enable gt lt newsheet gt lt advanced gt lt scaling gt lt spreadsheetfilename gt EXP lt source gt EXP10 lt source gt EXTR lt source gt lt sweeps gt FFT lt source gt lt type gt lt window gt lt algorithm gt lt filltyp e gt lt suppressde gt FILTER lt source gt lt firoriir gt lt filterkind gt lt filtertype gt lt window gt lt kaiserbeta gt lt gaussianbt gt lt cosinebeta gt lt t ransitionwidh gt lt 8dbwidth gt lt stopbandattenuation gt lt p assbandripple gt lt lowfreqstop gt lt lowfreqpass gt lt 8dbfre q gt lt cornerfreq gt lt centerfreq gt lt highfreqstop gt lt highfre qpass gt lt rolloff gt lt numberoftaps gt lt numberofstages gt lt advanced gt lt autolength gt FIR lt source gt lt type gt lt window gt lt cutoff gt lt coefficien ts gt FLOOR lt soutce gt lt sweeps gt GFILL lt source gt lt samplesperperiod gt lt sourcefrequen cy gt lt time1 gt lt time2 gt lt setwindow gt lt areatofill gt lt wind owstart gt lt wi
27. Visual Basic for Applications code in an Excel macro the spreadsheet can recover pre scaled waveform data from a remote instrument The ActiveDSO control can also be embedded visually in any OLE automation compatible client and can be used manually without any need for programming It will run on any PC running Windows 95 Windows 98 or Windows NT e There are two fundamental ways to use the control a visible object embedded an OLE Automation compatible Client PowerPoint for example showing a captured display image See Embedded Control Example for more details an invisible object accessed via a scripting language Visual Basic for Applications for example to remotely control an instrument See Accessing from VBA for details e Visual Basic for Applications is the programming language built into many of the more recent Windows applications It is a subset of Visual Basic that makes it very simple to utilize the services of OLE Automation Servers and ActiveX Controls following VBA subroutine demonstrates how easy it is to connect to an instrument and send remote commands to it Sub LeCroyDSOTest Dim o As Object Set o CreateObject LeCroy ActiveDSOCtrl 1 Call o AboutBox Present the control s About box Call o MakeConnection IP 172 28 11 26 Connect to device on LAN Call o WriteString BUZZ BEEP True Make the DSO beep End Sub Example Syntax e Boolean control
28. and the initial position of the trace trace Vert POSition trace Vert POSITION display offset The following instruction shifts Trace A TA upwards by 3 divisions relative to the position at the time of acquisition CMD F1 VPOS 3DIV CALL IBWRT SCOPES CMD VERT MAGNIFY ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties ACQUISITION VOLT DIV VDIV Command Query DESCRIPTION The VOLT DIV command sets the vertical sensitivity in Volts div The VAB bit bit 2 in the STB register see table on page 225 is set if an out of range value is entered The probe attenuation factor is not taken into account for adjusting vertical sensitivity The VOLT_DIV query returns the vertical sensitivity of the specified channel COMMAND SYNTAX channel Volt DIV lt v_gain gt channel C1 C2 C3 C4 NOTE The unit V is optional lt v_gain gt See Operators Manual for specifications QUERY SYNTAX lt channel gt Volt_DIV RESPONSE FORMAT lt channel gt Volt_DIV lt v_gain gt AVAILABILITY lt channel gt C3 C4 only available on four channel oscilloscopes EXAMPLE The following instruction sets the vertical sensitivity of channel 1 to 50 mV div CMD 2 C1 VDIV 50MV CALL IBWRT SCOPE CMDS WM RCM E Rev D ISSUED February 2005 25 1 PART Two COMMANDS STATUS WAI Command DESCRIPTION WAI WAIt to continue command required by t
29. lt header gt optionally followed by one or several parameters lt data gt separated by commas lt header gt lt data gt lt data gt The notation shows that the question mark is optional turning the command into a query There is a space between the header and the first parameter Use commas between parameters The terminator is not shown because usually it is automatically added by the interface driver routine writing to GPIB TIP Set the controller I O timeout conditions to three or more seconds to give the scope time to respond An incorrect query will not get a response and if Remote Control Assistant is enabled a beep will sound Following are examples of how program messages ate made up of commands and queries GRID DUAL This program message consists of a single command that instructs the oscilloscope to display a dual grid BUZZ BEEP DISPLAY OFF DATE This program message consists of two commands followed by a query They instruct the oscilloscope to beep once turn off the display and then ask for the current date Again the terminator is not shown DATE 15 JAN 1993 13 21 16 This command instructs the oscilloscope to set its date and time to 15 JAN 1993 13 21 16 The command header DATE indicates the action the 6 data values specify it in detail WM RCM E Rev D ISSUED February 2005 7 PART ONE ABOUT REMOTE CONTROL HEADERS The header is the mnemonic form of the operation t
30. lt hfractionht gt Histogram left bin Histogram highest peak Where lt sourceN gt C1 C2 C3 C4 F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TD TA through TD are for compatibility with existing software with earlier instruments These four mnemonics are not returned by queries lt slopeN gt POS NEG FIRST lt edgeN gt POS NI ISSUED February 2005 191 PART Two COMMANDS QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE 1 Command Example Query Response Examples 5 For Parameter Math option 192 lt clock edge gt POS NEG ALL lt levelN gt lt low gt lt high gt 1 to 99 if level is specified in percent PCT or lt leveIN gt lt low gt high Level in lt sourceN gt in the units of the waveform lt delay gt 100 PCT to 100 PCT freq 10 to 1e9 Hz Narrow Band center frequency lt hysteresis gt 0 01 to 8 divisions lt length gt 1 9 to 0 001 seconds operator ADD SUB MUL DIV rank 1 to 100 lt threshold gt 0 to 100 percent lt angular unit gt PCT DEG RAD lt cyclic gt OFF ON PArameter CUstom column PArameter Custom column parameter lt qualifier gt qualifier lt soutceN gt C3 C4 only on four channel oscilloscopes DTLEV PACU 2 DTLEV C1 POS 345E 3 C2 NEG 789E 3 PACU 2 returns PACU 2 DTLEV C1 POS 345E
31. 2 F3 F4 F5 F6 F7 F8 Equivalent to F1 through F4 for backward compatibility with other LeCroy DSOs EX EX10 EX5 External trigger LINE LINE source for trigger Example C1 OFST 300 MV Command to set the offset of Channel 1 to 300 mV You need only specify a header path once Subsequent commands with header destinations not indicated are assumed to refer to the last defined path For example the queries C2 VDIV C2 OFST ask What is the vertical sensitivity and the offset of channel 2 While the queries C2 VDIV OFST ask exactly the same questions without repeating the path 8 ISSUED February 2005 WM RCM E Rev D CHAPTER ONE Overview NOTE If you use of the older trace labels for example any response from the scope uses the new label for example it substitutes F3 for TC DATA Whenever a command or query uses additional data values the values are expressed as ASCII characters There is a single exception the transfer of waveforms with the command query WAVEFORM where the waveform can be expressed as a sequence of binary data values See Chapter 4 Waveform Structure ASCII data can have the form of character numeric string or block data CHARACTER DATA These are simple words or abbreviations to indicate a specific action Example ON In this example the data value ON commands the trace F3 to be turned on the data value OFF will have the opposite effect Ho
32. 2 6 DIV HDIF 7 4 DIV CALL IBWRT SCOPE CMDS CURSOR MEASURE CURSOR SET PER CURSOR VALUE ISSUED February 2005 20 9 PART Two COMMANDS DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 210 PERSIST_LAST PELT Command Query The PERSIST LAST command controls whether or not the last trace drawn in a persistence data map is shown This command checks or unchecks the Show Last Trace checkbox in the Persistence dialog The response to the PERSIST_LAST query indicates whether the last trace is shown within its persistence data map P lt T y Ersist LasT lt state gt state ON OFF Ersist LasT Ersist LasT lt state gt ERSIST PERSIST COLOR ERSIST SETUP ISSUED February 2005 he following instruction ensures the last trace is visible within its persistence data map CMDS PELT ON CALL IBWRT SCOPE CMDS ERSIST SAT WM RCM E Rev D DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties PERSIST SAT PESA Command Query The 515 SAT command sets the level at which the color spectrum of the persistence display is saturated The level is specified in terms of percentage PCT of the total persistence data map population A level of 100 PCT corresponds to the color s
33. 32 time lt i ms TTL 128 Reply from 172 28 15 75 bytes 32 time lt i ms TTL 128 Ping statistics for 172 28 15 75 Packets Sent 4 Received 4 Lost z loss Approximate round trip times in milli seconds Minimum ms Maximum 16ms Average 4ms Network Connection Check with your network administrator before connecting the oscilloscope to a network Incorrect addresses on a network can cause both the network and the oscilloscope to behave strangely However a network connection ought to be as simple as plugging the oscilloscope into the network Proper connection can be verified by following the verification instructions in the previous section If you are concerned mainly with system throughput network connection is not recommended because the network traffic will slow down the oscilloscope s data transfer rate Note The default Gateway is assigned as 172 25 0 1 Unless your network has this Gateway available you must ensure that the computer and the oscilloscope are on the same subnet Changing IP Address Once the IP address is changed the unit will no longer respond to the original address If the network settings are unknown or accidentally set to invalid values they can be recovered by following the procedure above WM RCM E Rev D ISSUED February 2005 39 PART ONE ABOUT REMOTE CONTROL Introduction to Software Tools The instrument software tools allow you to develop your own application specif
34. Acquisition WaveMaster Acquisition Set Horizontal Acquisition Horizontal Horizontal SampleClock Internal Horizontal ExternalClockRate 1 Horizontal HorScale 0 0000005 Horizontal HorOffset 0 Horizontal HorOffsetOrigin 5 Horizontal SampleMode Sequence etc You could of course choose a much shorter word than Horizontal For example you could write Set Horiz WaveMaster Acquisition Horizontal Horiz HorScale 0 000001 ACTIONS Besides the Control Variables automation also provides for Actions For example we might want to Clear Sweeps on a particular trace The XStreamBrowser example below shows the command for clearing a persistence trace 76 ISSUED February 2005 WM RCM E Rev D CHAPTER SIX LINKING WITH AUTOMATION File Vertical Timebase Trigger Display Cursors Measure Math Analysis Utilities XStream Browser File Edt Help 2 H LeCroy xStreamDs 4 Acquisition Cursors Name Value Type Flags Sta Range Helpstrir C4PrintColor 0 255 0 Color N From 0 to 167772 ceps Customdso DisableExternalMonitor Acbon Display DisplayMode Scope Scope WebEdit ElectricalTelecor EnableExternalMonitor Acbon Chor 255 195 0 Color N From 0 to 16777 4 Ethernet F1PrintColor 0 128 0 Color From 0 to 16777 ee Dj 500 mViditv 40 0 mV ofst The statement in your script or program wo
35. Device WM RCM E Rev D ISSUED February 2005 43 PART ONE ABOUT REMOTE CONTROL 9 44 Enter the instrument s IP address and click OK Network Device Enter network address of device If the device uses a static address then enter the IP address directly i e 169 12 4 1 If the device has a DNS name then enter that directly i e mydesktopcomputer fi 72 28 15 79 Note that static IP addresses should not be used to identify devices that use DHCP to define their address DHCP can cause a device to change it s address at any time Older LeCroy DSOs LCxxx WaveRunner WavePro require static IP addresses XStream based DSOs can use either static IP address or DHCP Note Remote control of a networked scope uses TCP port 1861 Ensure that this port is open on any firewalls between the PC and the DSO Cancel The addtess can also be specified in URL form or 127 0 0 1 if you are running the controlling application on the instrument ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Control by LAN 10 Right click the object again and select the Refresh Image menu item A captured waveform will be displayed similar to the one shown here Microsoft PowerPoint Present Bl a File Edit Insert Format Tools SlideShow Window Help Adobe PDF a question For help xX 61 J BZU Design S new am TY EB Slide Design File Verlic
36. INE and PRE registers 2 Configure the controller for parallel poll 3 Instruct the X Stream DSO to respond on data line 2 DIO2 with these commands CMD1 DSOListenPCTalks As defined earlier CALL IBCMD BRDO CMD1S CMDS INE 1 PRE 1 CALL IBWRT BRDO CMDS PPES Chr amp H5 GPIB Parallel Poll Enable MSA9S Chr amp H69 GPIB Secondary Address 9 CMD4 PPES MSA9S UnListen CALL IBCMD BRDO 45 Stage 2 4 Parallel poll the oscilloscope until DIO2 is set with these commands Do CALL IBRPP BRDO PPR Loop Until PPR AND amp H2 2 Stage 3 5 Disable parallel polling hex 15 and clear the parallel poll register with these commands PPUS Chr amp H15 GPIB Parallel Poll Unconfigure CALL IBCMD BRDO PPUS CALL IBCMD BRDO CMD1 As defined earlier CMD PRE 0 CALL IBWRT BRDO CMDS In the above example board level GPIB function calls are used It is assumed that the controller board and the X Stream DSO device are located at addresses 0 and 4 respectively WM RCM E Rev D ISSUED February 2005 25 PART ONE ABOUT REMOTE CONTROL The listener and talker addresses for the controller and the X Stream DSO are TALKER ADDRESS External Controller 32 ASCH lt space gt 64 ASCII 64 4 68 ASCII D LOGIC DEVICE LISTENER ADDRESS X Stream DSO 32 4 36 ASCII PERFORM AN IST POLL You can also read the state of
37. Insert Object 2 x Object type Wiew NbDocView Class Keyword Link LEAD Main Control 12 0 LeCroy ActiveDSO Control LeCroy AladdinSplash Class LeCroy DescriptorButtonCtrl Class Display as icon LeCroy EventLogView Class LeCroy Knob Class Create new Create from file Inserts a new LeCroy ActiveDSO Control object into your presentation 6 1 A 2 hog tom nct CIO 4206 2 Side 1 of 1 Default Design English U 5 aw 2 7 Right click the object and select Connection WM RCM E D ISSUED February 2005 27 5 APPENDIX I Program Examples 8 Select Network TCP IP connection WaveMaster Add Device 9 Enter the X Stream DSO s IP address and click OK Network Device x 172 28 15 79 27 6 ISSUED February 2005 WM RCM E Rev D GPIB Program Examples 10 Right click the object again and select the Refresh Image menu item A captured waveform will be displayed similar to the one shown here Microsoft PowerPoint Presentation1 loj x File Edit Insert Format Tools Slide Show Window Help Adobe PDF a question For 61 E z Aen new slide gt Slide Design File Verlical Timebase Trigger Display Cursors Measure Math Analysis Utilities Help 4297204 93235 AM 777777777 AutoShapes
38. RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties CUSTOM_OPTIONS CU_OPT Query The CU_OPT query identifies options currently enabled due to the presence of a PP100 These options can also be enabled by the normal option key mechanism If so they are reported by the OPT query instead of CU OPT The response to CU OPT consists of a series of response fields listing all the options enabled due to the presence of a PP100 CU OPT CU option 12 option gt option gt 01 02 for compatibility with older scopes CUSTOM APPLICATION MT FAIL ACTIONS MT gt MT PF COUNTERS MT SELECT TEST MT SYMBOL ISSUED February 2005 123 PART Two COMMANDS DATE DESCRIPTION COMMAND SYNTAX A COMMAND SYNTAX B QUERY SYNTAX EXAMPLE GPIB 124 DATE Command Query Sets the date and time of the real time clock in the instrument Note that you do not need to specify any parameters after the one you want to change but you MUST include all those before it DATE day month year hour minute lt second gt DATE SNTP to set the date and the time from the internet DATE The following instruction sets the date to January 1 1997 and the time to 1 21 16 CMD DATE 1 JAN 1997 13 21 16 CALL IBWRT SCOPE CMDS ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries STATUS DDR Query DESCRI
39. Recalls one of five non volatile panel setups CAL CAL DIR DIRECTORY MAIL EMAIL PNSU RCL RCPN RECALL PANEL Recalls a front panel setup from mass storage Initiates a device reset SAV SAV Stores the current state in non volatile internal memory STORE PANEL Stores the complete front panel setup on a mass storage file STATUS OBTAIN STATUS INFORMATION AND SET UP SERVICE REQUESTS ALL STATUS Reads and clears the contents of all but one of the status registers CLS Clears all the status data registers Reads and clears the contents of the CoMmand error Register CMR Reads and clears the Device Dependent error Register DDR Sets the standard Event Status Enable ESE register WM RCM E Rev D ISSUED February 2005 89 PART Two COMMANDS LONG FORM WHAT THE COMMAND OR QUERY DOES Reads and clears the Event Status Register ESR Reads and clears the EXecution error Register EXR Sets the INternal state change Enable register INE Reads and clears the INternal state change Register INR Individual STatus reads the current state of IEEE 488 Sets to true the OPC bit 0 in the Event Status Register ESR Sets the PaRallel poll Enable register PRE Sets the Service Request Enable register SRE Reads the contents of IEEE 488 WAIt to continue required by IEEE 488 gt 2 2 S 5 5 z 2 i 2 2 5 Allows acquired wavefo
40. SCOPE CMDS TDIV ISSUED February 2005 WM RCM E Rev D DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB WM RCM E Rev D Remote Control Commands Queries MESSAGE MSG Command Query The MESSAGE command displays a string of characters in the message field at the bottom of the instrument screen MeSsaGe lt string gt or MSG lt string gt lt string gt a string of up to 49 characters Longer strings will be truncated to 49 characters but the original string will be retained and returned by the MSG Query MeSsaGe MeSsaGe lt string gt The following causes the message Touch Probe 2 to Test Point 7 to appear in the message field CMD MSG Touch Probe 2 to Test Point 7 CALL IBWRT SCOPE CMDS ISSUED February 2005 16 7 PART Two COMMANDS MT_ATTENUATION MTAT ET PMT Command Query DESCRIPTION Controls cable attenuation factor for 2M TP 2M COAX 8M 34M 139M 156M MT ATTENUATION attn value COMMAND SYNTAX lt attn_value gt 0 5 to 1 QUERY SYNTAX MTAT RESPONSE FORMAT lt attn_value gt attn value 0 5 to 1 RELATED COMMANDS CUSTOM APPLICATION CUSTOM OPTIONS MT_OPC MT PF COUNTERS MT SELECT TEST MT SYMBOL 16 8 ISSUED February 2005 WM RCM E Rev D ET PMT DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Quetie
41. absence selects DELTA QUERY SYNTAX CuRsor_MeaSure RESPONSE FORMAT CuRsor_MeaSure lt mode gt EXAMPLE GPIB The following instruction switches on the vertical relative cursors 5 5 VREL CALL IBWRT SCOPE CMDS The following instruction determines which cursor is currently turned on 56 5 CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RDS PRINT RDS Example of response message CRMS OFF RELATED COMMANDS CURSOR SET PARAMETER STATISTICS PARAMETER VALUE CURSORS PARAMETER PASS FAIL ADDITIONAL INFORMATION To turn off the cursors parameter measurements or Pass Fail tests use CURSOR MEASURE OFF WM RCM E Rev D ISSUED February 2005 115 PART Two COMMANDS To turn on a cursor display use one of these five forms CURSOR_MEASURE HABS URSOR_MEASU E HREL URSO 20 EASURE VABS URSO 20 EASURE VREL 3 Ee 2 62 5 62 R R R R URSO 20 EASURE FAIL 116 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries CURSOR CURSOR_SET CRST Command Query DESCRIPTION The CURSOR_SET command allows you to position any one of the independent cursors at a given grid location When you ate setting a cursor position you must specify a trace relative to which the cursor will
42. calculate HORIZontal OFFSET DescPoint 180 Constants needed by GetDoubleFloat DMult2 1 16 DMult3 DMult2 256 Comm Order is the variable which provides information about the order of the bytes in the descriptor and in the waveform data Comm Order is the byte at position 34 in the descriptor Set ByteOrd 1 when Comm Order 0 for high byte first Set ByteOrd 1 when Comm Order 1 for low byte first Set ByteOrd7 7 Comm Order ByteOrd 1 2 Comm Order ByteOrd7 7 Comm Order DMult3 DMult2 256 FByte ByteOrd7 Sign started FDigit Desc DescPoint FByte FSign FDigit And 128 128 FSign 1 2 FSign Sign completed FExponent FDigit And 127 Exponent started FExponent 16 FExponent FByte ByteOrd7 ByteOrd FDigit Desc DescPoint FByte FExponent FExponent CDbl FDigit And 240 16 1023 Exponent completed FFraction CDbl FDigit And 15 DMult2 Fraction started ISSUED February 2005 WM RCM E Rev D Waveform Template For I 2 To FByte ByteOrd7 ByteOrd FDigit Desc DescPoint FByte FFraction FFraction CDbl FDigit DMult3 DMult3 DMult3 256 Next I Fraction completed A FVariable 2 FExponent GetDoubleFloat FVariable FSign 1 FFraction End 1 End of GetDoubleFloat 299 WM RCM E Rev D ISSUED February 2005
43. can be activated for short beeps The value ON has the same effect as BEEP unlike the behavior with earlier instruments ON and OFF are accepted only for compatibility OFF has no effect BUZZer lt state gt lt state gt BEEP ON OFF Sending the following will cause the instrument to sound two short tones CMDS BUZZ BEEP BUZZ BEEP CALL IBWRT SCOPES CMD ISSUED February 2005 9 7 PART Two COMMANDS MISCELLANEOUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 98 CAL Query The CAL query causes the oscilloscope to perform an internal self calibration and generates a response that indicates whether or not your oscilloscope completed the calibration without error This internal calibration sequence is the same as that which occurs at power up At the end of the calibration after the response has indicated how the calibration terminated the oscilloscope returns to the state it was in just prior to the calibration cycle This includes the AUTO_CALIBRATE status which is not affected by the use of CAL That is CAL may be used whether AUTO CALIBRATE has been set on or off CAL lt diagnostics gt diagnostics 0 or other 0 Calibration successful The following instruction forces a self calibration CMD CAL CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RD PRINT RDS Response message if no failure CAL 0 AUTO_CALIBRATE
44. characters read FOR J 1 TOI PRINT MIDS RD J 1 NEXT J PRINT RETURN StoreData y Store waveform data in a file RD1S SPACES 3 LINE INPUT Specify trace 1 4 1 4 TRACES LINE INPUT Enter filename FILES CMDS WFSU 0 5 0 0 5 0 CHDR SHORT CALL IBWRT SCOPE CMDS CMDS TRACES WF CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RD1 Discard first 3 chars of response CALL IBRDF SCOPE FILES IF 5 lt 0 THEN GODUB GPIBError END PRINT RETURN RecallData j Recall waveform data from file and send them to DSO LINE INPUT Specify target memory M1 M4 MEMS LINE INPUT Enter filename FILES CALL IBWRT 5 CALL IBWRTF SCOPE FILES IF 5 lt 0 THEN GOSUB GPIB Error END RETURN GPIBError PRINT GPIB ERROR IBERR IBERR IBSTA HEXS IBSTA RETURN 262 ISSUED February 2005 WM RCM E Rev D GPIB Progtam Examples NOTE It is assumed that the National Instruments GPIB driver GPIB COM is in its default state This means that the interface board can be referred to by its symbolic name GPIBO and that devices on the GPIB with addresses 1 to 16 can be called the symbolic name DEVI to DEV16 Lines 1 99 are a copy of the file DECL BAS supplied by National Instruments The first six lines are requited for the initialization of the GPIB handler DECL BAS requites access to the
45. file BIB M during the GPIB initialization BIB M is one of the files supplied by National Instruments and must exist in the ditectory currently in use The first two lines of DECL BAS each contains a string XX XXX that must be replaced by the number of bytes that determine the maximum workspace for BASICA computed by subtracting the size of BIB M from the currently available space in BASICA For example if the size of BIB M is 1200 bytes and when BASICA is loaded it reports 60200 bytes free XXXXX would be replaced by the value 59000 or less The default timeout of 10 seconds is modified to 300 ms during the execution of this program However the default value of the GPIB handler remains unchanged Whenever a remote command is entered by the user the program sends it to the instrument with the function call IBWRT Afterwards it always executes an IBRD call regardless of whether or not a response is expected If a response is received it is immediately displayed If there is no response the program waits until time out and then asks for the next command SOURCE CODE EXAMPLE GPIB 3 USE GPIB Program for IBM PC Low Level Function Calls This example has the same function as Example 2 but is written with low level function calls The program assumes that the controller board and oscilloscope device are at addresses 0 and 4 respectively and the decimal m are Listener Address Address Talker Address e
46. gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt HAMPL Histogram amplitude HIGH Histogram right bin HRMS Histogram RMS WM RCM E Rev D ISSUED February 2005 1 89 PART Two COMMANDS HTOP Histogram top lt hfractionht gt HOLDLEV Time clock to data edge lt clockslope gt lt pctabs gt lt clocklevelis gt lt clockpctlevel gt lt clockabslevel gt lt source2 gt lt dataslope gt lt pctabs gt lt data levelis gt lt datapctlevel gt lt dataabslevel gt lt clockhysteresis gt lt datahysteresis gt LOW Histogram left bin MATHCADPARA Param using Mathcad lt sourcel var gt lt source2var gt lt outputvar gt lt source1heade M tvat gt lt source2headervar gt lt outputheadervar gt lt withhea der gt lt outputenable gt lt sourcel enable gt lt source2enable gt lt newsheet gt lt advanced gt lt worksheetfilename gt pe MARITH was NBPH frequency NBPW frequency PSCRIPT lt language gt lt code gt PARAMSCRIPT lt language gt lt code gt ms PCTL lt hpctpop gt PLEV Period at level lt signaltype gt lt slope gt lt pctabs gt lt leveltype gt lt percentlev el gt lt abslevel gt lt hysteresis gt lt usebasefrequency gt lt basefr equency gt lt stadbasefrequency gt POPATX Histogram bin population lt horvalue gt lt cursorshape gt RANGE Histogram range SETUP Time data to clock edge lt clockslope gt lt pct
47. indicates the type of hardware errors affecting your instrument Individual bits in this register report specific hardware failures List them using DDR Also read this register using the DDR query The response is the binary weighted sum of the error bits Clear it with another DDR or with ALST a CLS command or with power on EXECUTION ERROR STATUS REGISTER EXR EXR contains the code of the last execution error detected by the oscilloscope List these error codes with 2 Read the register again using the query The response is the error code Clear with another EXR or with ALST a CLS command or with power on USER REQUEST STATUS REGISTER URR Finally URR contains the identification code of the last menu button pressed List these codes with URR Read URR using the same query The response is the decimal code associated with the selected menu button And clear the register with another URR or with ALST a CLS command or with power on 95 WM RCM E Rev D ISSUED February 2005 67 CHAPTER S1x Linking with Automation In this chapter discover gt What Automation is gt Howto use the VBS command 68 ISSUED February 2005 WM RCM E Rev D CHAPTER SIX Linking With Automation What is Automation OVERVIEW Automation enables you to control programs from your own applications as if you were using a keyboard and a mouse For example if you want to use Excel Mathcad MATLAB or other pro
48. it Mass storage was write protected when user attempted to create a file to delete a file or to format the device Bad mass storage detected during formatting Mass storage root directory full Cannot add directory Mass storage full when user attempted to write to it Mass storage file sequence numbers exhausted 999 reached Mass storage file not found Requested directory not found Mass storage filename not DOS compatible or illegal filename a 2 Cannot write on mass storage because filename already exists Only with memory card or removable hard disk option WM RCM E Rev D ISSUED February 2005 145 PART Two COMMANDS FUNCTION DESCRIPTION COMMAND SYNTAX AVAILABILITY EXAMPLE GPIB RELATED COMMANDS 146 FIND_CTR_RANGE FCR Command The FIND_CTR_RANGE command automatically sets the center and width of a histogram to best display the accumulated events function Find Ctr Range function TA TB TC TD F1 F2 F3 F4 Only available with an option installed that includes Histograms Assuming that Trace A has been defined as a histogram of one of the custom parametets the following example will determine the best center and width and then rescale the histogram CMDS 2 TA FCR CALL IBWRT SCOPE CMDS DEFINE PARAMETER CUSTOM ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties ACQUISITION FORCE_TRIGGER FRTR
49. of the selected custom parameters 198 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries AVAILABLE WITH SDA OPTION AVG Histogram mean HTOP Histogram top level CROSSPERCE Differential crossing HOLDLEV Clock to data edge time DCD Histogram left bin DPLI Delta period at level MAXP Histogram highest peak DTLI Delta time at levels Histogram mode EVEL 2 rA z t E td DWIDLI Delta width at level As A Histogram no of peaks EDLE Edges at level EXT Eye level ratios Histogram percentile Period at level lt Eye amplitude Eye bit error rate estim PERIODIC JITTER TBD POPATX Histogram bin population EYEWIDTH Eye width EyeQ L5 EYECRW RANGI Histogram range EYECROSSINGCALC SETUP Data to clock edge time FREQLEV Frequency at level SIGMA Histogram standard dev Histogram FWHM SKEW Time clock to clock edge Hist peak FW at level TIELEV Time interval error at level Half period Total jitter at set BER Histogram amplitude TOTP Histogram total populate Histogram base level WIDLV Width at level Histogram right bin XAPK Histogram Nth peak Histogram median ZEROLVL Eye diagram zero level Histogram rms WM RCM E Rev D ISSUED February 2005 199 PART Two ELPARAMARITH
50. one configured using the PACU command parameter See table of parameters Alternative forms of query for mask tests trace PArameter VAlue mask test lt mask gt mask test ALL ALL_OUT SOME OUT mask F1 F2 F3 FA4 F5 F6 F7 F8 TA TB TC TD TA through TD are included for backward compatibility with software designed for earlier LeCroy instruments These four mnemonics will not be returned in response to queries trace PArameter VAlue lt parameter gt value state parameter value lt state gt value A decimal numeric value state OK AV IV NP GT LT OF UF OU NOTE If parameter is not specified or is equal to ALL all standard voltage and time parameters are returned followed by their values and states trace C3 C4 only available on four channel oscilloscopes The following instruction query reads the rise time of Trace B TB CMD 2 F2 PAVA RISE CALL IBWRT SCOPE CMDS CALL IBRD SCOPES RD PRINT RD ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties Response message TB PAVA RISE 3 6E 9S 0OK RELATED COMMANDS CURSOR MEASURE CURSOR SET PARAMETER CUSTOM PARAMETER STATISTICS WM RCM E Rev D ISSUED February 2005 203 PART Two COMMANDS MISCELLANEOUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX EXAMPLE GPIB RELATED COMM
51. pairs The first parameter specifies the cursor to be modified and the second one indicates its new value Parameters can be grouped in any order and restricted trace CuRsor_SeT cursor only if the cursors visible No lt cursor gt implies ALL even though all are not visible cursor HABS VABS HDIF VREF VDIF ALL trace CuRsor_SeT lt cursor gt position cursor position lt cursor gt lt position gt If cursor is not specified ALL will be assumed If the position of a cursor cannot be determined in a particular situation its position will be indicated as UNDEF trace C3 C4 available only on four channel oscilloscopes The following instruction positions the VREF and VDIF cursors at 3 DIV and 2 DIV respectively using Trace F1 as a reference CMD F1 CRST VREF 3DIV VDIF 2DIV CALL IBWRT SCOPE CMDS CURSOR_MEASURE CURSOR VALUE PARAMETER_VALUE ISSUED February 2005 WM RCM E Rev D CURSOR DESCRIPTION QUERY SYNTAX RESPONSE FORMAT WM RCM E Rev D Remote Control Commands and Queties CURSOR_VALUE CRVA Query The CURSOR_VALUE query returns the values measured by the specified cursors for a given trace The PARAMETER VALUE query is used to obtain measured waveform parameter values There are important differences in the function of this command between X Stream instruments and earlier LeCroy instrument
52. percentlevel gt abslevel gt lt hysteresis gt EDLEV Edges at level lt slope gt lt pcectabs gt lt leveltype gt lt percentlevel gt abslevel gt lt hysteresis gt FALL Fall time 90 to 10 lt pctabs gt lt levelsare gt lt highpct gt lt highabs gt lt pctabs gt lt levelsare gt lt lowpct gt lt lowabs gt FLEV Fall at levels FRST First cursor position FREQ Frequency HOLDLEV Clock to data time lt Clockslope gt lt pctabs gt lt clocklevelis gt lt clockpctlevel gt lt clockabslevel gt lt source2 gt lt dataslope gt lt pctabs gt lt da talevelis gt lt datapctlevel gt lt dataabslevel gt lt clockhysteresi s gt lt datahysteresis gt LAST Last cursor position MAX Maximum value PER Period PHASE Phase difference POPATX Population of bin at x Nares NIS mud Foron ornas lt horvalue gt lt cursorshape gt WM RCM E Rev D ISSUED February 2005 1 85 PART Two RISE RISE28 RLEV RMS SETUP SDEV TLEV TOP WID WIDLV XMIN XAPK CUSTn lt param gt 186 COMMANDS Rise time 10 to 90 Rise 20 to 80 Rise time at levels root mean square Data edge to clock edge Standard deviation Time at level ae Width at level Pos of max data value Pos if min data value Nth highest hist peak Custom parameter lt pctabs gt lt levelsare gt lt lowpct gt lt lowabs gt lt pctabs g
53. plus 32 bit 5 See the table with the ESR command description in Part Two for the conditions corresponding to the bits set The Power ON bit appears only on the first ESR query after power on as the query clears the register You can determine this type of command error by reading the CMR with CMR It is not necessary that you read or simultaneously clear this register in order to set the CMR bit in the ESR on the next command error STANDARD EVENT STATUS ENABLE REGISTER ESE This register allows you to report one or more events in the ESR to the ESB summary bit in the STB Modify ESE with ESE and clear it with ESE 0 or with power on Read it with ESE Example Use ESE 4 to set bit 2 binary 4 of the ESE Register and to enable query errors to be reported SERVICE REQUEST ENABLE REGISTER SRE SRE specifies which Status Byte Register summary bit or bits will bring about a service request This register consists of eight bits Setting a bit allows the summary bit located at the same bit position in the SBR to generate a service request provided that the associated event becomes true Bit 6 MSS cannot be set and is always reported as zero in response to SRE Modify SRE with SRE and clear it with SRE 0 or with power on Read it using SRE PARALLEL POLL ENABLE REGISTER PRE This specifies which Status Byte Register summary bit or bits will set the ist individual local message PRE is similar to SRE but is used to
54. present Blocks and arrays that are present will be found in the same order as their descriptions below BLOCKS 36 WAVE DESCRIPTOR long length in bytes of block WAVEDESC 40 gt USER_TEXT long length in bytes of block USERTEXT 44 gt RES DESC1 long ARRAYS 48 gt TRIGTIME_ARRAY long length in bytes of TRIGTIME array 52 gt RIS_TIME_ARRAY long length in bytes of RIS_TIME array 56 gt RES_ARRAY1 long an expansion entry is reserved 60 gt WAVE ARRAY 1 long length in bytes of 1st simple data array In transmitted waveform represent the number of transmitted bytes in accordance with the NP parameter of the WFSU remote command and the used format see COMM TYPE 64 gt WAVE ARRAY 2 long length in bytes of 2nd simple data array 68 gt RES ARRAY2 long 72 gt RES ARRAY3 long 2 expansion entries are reserved A AS o The following variables identify the instrument 76 INSTRUMENT NAME string 92 INSTRUMENT NUMBER long 96 gt TRACE LABEL string identifies the waveform i125 RESERVED1 word lt 114 gt RESERVED2 word 2 expansion entries 282 ISSUED February 2005 WM RCM E Rev D The following variables describe the waveform and the time at which the waveform was generated lt 116 gt lt 120 gt lt 124 gt lt 128 gt lt 132 gt lt 136 gt lt 140 gt lt 144 gt lt 148 gt WM RCM E Rev D WAVE ARRAY COUNT long PNTS PER SCRE
55. present the time array block for RIS and sequence acquisitions only data array block auxiliary or second data array block WM RCM E Rev D ISSUED February 2005 279 APPENDIX II In the following explanation single line in the form lt byte position gt where lt byte position gt lt variable name gt lt variable type gt 280 Waveform Template every element of a block is described by a lt variable name gt lt variable type gt lt comment gt position in bytes decimal offset of the variable relative to the beginning of the block name of the variable with the format shown below string up to 16 character name terminated with a null byte byte 08 bit signed data value word 16 bit signed data value long 32 bit signed data value float 32 bit IEEE floating point value 31 23 2256240 bit position exponent fraction where s sign of the fraction exponent 8 bit exponent e fraction 23 bit fraction f and the final value is 1 s 2 e 127 1 double 64 bit IEEE floating point value with the format shown below 63 62 52 5l 24 220 bit position S exponent fraction where S sign of the fraction exponent 11 bit exponent e fraction 52 bit fraction f and the final value is 1 s 2 e 1023 1 f enum enumerated value in the range 0 to N represented as a 16 bit data value The list of values follows immediately The integer is preceded by an _ I
56. processing are done Note that when you arm the scope by sending the TRMD SINGLE command the scope will automatically perform any necessary calibrations before actually starting to acquire data These calibrations may take several seconds so if you query the status immediately after sending TRMD SINGLE you need to have the GPIB or remote timeout set to be at least 10 seconds to prevent a timeout before getting the correct results Calibrations are performed if your program changes some control settings e g volts div number of active channels etc ot if the temperature of the scope has changed significantly You can disable the calibrations by sending the AUTO CALIBRATE OFF command However the scope performance may be degraded if the temperature changes and it does not get a chance to self calibrate A calibration of the X Stream DSO can be forced by issuing a CAL command This technique allows you to control the timing of calibrations so that they will not interfere with the acquisition of important data One case when you may need to use normal or auto trigger mode is the accumulation of many acquisitions for functions such as averaging or histogramming In this case it is best to stop the acquisitions set up the scope and then set the trigger mode to NORMAL to acquire the data A possible alternative is to use sequence mode It is faster but does require that you know how many acquisitions to accumulate That number can be s
57. selects the single source trigger with Channel 1 trigger source Hold type and hold value are chosen as pulse smaller than 20 ns CMDS TRSE SNG SR C1 HT PS HV 20 NS CALL IBWRT SCOPE CMDS 246 ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties TRIG SLOPE TRSL Command Query The TRIG SLOPE command sets the trigger slope of the specified trigger source The TRIG_SLOPE query returns the trigger slope of the selected soutce lt trig_source gt TRig_SLope lt trig_slope gt lt trig_source gt C1 C2 C4 LINE EX 10 10 lt trig_slope gt POS lt trig_source gt TRig_SLope lt trig_source gt TRig SLope lt ttig_slope gt trig source C3 C4 only available on four channel oscilloscopes The following instruction sets the trigger slope of Channel 2 to negative CMD C2 TRSL NEG CALL IBWRT 5 CMDS TRIG_COUPLING TRIG_DELAY TRIG_LEVEL TRIG_MODE TRIG_SELECT TRIG_SLOPE ISSUED February 2005 24 7 PART Two COMMANDS AUTOMATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX EXAMPLES with GPIB Equivalents QUERY SYNTAX 248 VBS VBS Command Query The VBS command allows Automation commands to be sent in the contex
58. set the parallel poll ist bit rather than MSS The value of the ist may also be read without a Parallel Poll via the query IST The response indicates whether or not the ist message has been set values are 1 or 0 Modify PRE with PRE and clear it with PRE 0 or with power on Read this register with PRE Example Use PRE 5 to set the register s bits 2 and 0 decimal 4 and 1 INTERNAL STATE CHANGE STATUS REGISTER INR INR reports the completion of a number of internal operations the events tracked by this 16 bit wide register are listed with the INR description in Part Two Read the register using INR The response is the binary weighted sum of the register bits Clear the register with INR or ALST a CLS command or with power on 66 ISSUED February 2005 WM RCM E Rev D CHAPTER FIVE CHECKING WAVEFORM STATUS INTERNAL STATE CHANGE ENABLE REGISTER INE INE allows one or more events in the Internal State Change Status Register to be reported to the INB summary bit in the STB Modify INE with INE and clear it with INE 0 or after power on Read it with INE COMMAND ERROR STATUS REGISTER CMR This register contains the code of the last command error detected by the oscilloscope List these error codes using CMR Read CMR with CMR The response is the error code Clear the register with a CMR or ALST query a CLS command or with power on DEVICE DEPENDENT ERROR STATUS REGISTER DDR DDR
59. so that the controller can be interrupted when an error occurs If you connect an external monitor to the instrument s LAN port however you will be able to observe all your remote control transactions including error messages as they happen See the command in Part Two Commands Program messages ate separated by semicolons and end in a terminator command quety lt command query gt lt terminator gt The oscilloscope will not decode an incoming program message before receiving its terminator The exception is when the program message is longer than the 256 byte input buffer then the oscilloscope will start analyzing the message when the buffer is full Commands and queries are executed in the order in which they are transmitted In GPIB mode the following are valid terminators lt NL gt New Line character i e the ASCII new line character whose decimal value is 10 lt NL gt lt EOI gt New Line character with a simultaneous lt EOI gt signal lt EOI gt lt EOI gt Signal together with the last character of the program message The lt NL gt lt EOI gt terminator is always used in response messages sent by the oscilloscope to the controller NOTE The lt EOI gt signal is a dedicated GPIB interface line which can be set with a special call to the GPIB interface driver Refer to the GPIB interface manufacturer s manual and support programs COMMANDS AND QUERIES Program m
60. specifies the type of cursor or parameter measurement to be displayed and is the main command for displaying parameters and Pass Fail The modes PARAM SHOW DASH and LIST used in some earlier LeCroy instruments are not available in X Stream instruments The CURSOR_MEASURE query indicates which cursors or parameter measurements are currently displayed NOTATION custom parameters Pass Fail fail horizontal absolute cursors STAT standard time parameters ABS DELTA SLOPE horizontal relative cursors cursors and parameters off Pass Fail pass vertical absolute cursors STAT standard voltage parameters ABS DELTA vertical relative cursors COMMAND SYNTAX CuRsor MeaSure lt mode gt lt submode gt mode CUST FAIL HABS HPAR HREL OFF PASS VABS VPAR VREL lt submode gt STAT ABS DELTA SLOP 114 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties NOTE The keyword STAT is optional with modes CUST HPAR and VPAR If present STAT turns patameter statistics on Absence of STAT turns parameter statistics off The submodes ABS DELTA SLOPE are optional with mode HREL If it is present ABS chooses absolute amplitude reading of relative cursors Absence of keyword selects relative DELTA amplitude reading of relative cursors Submodes ABS and DELTA are used with VREL presence of ABS selects absolute amplitude
61. straightforward method for detecting state changes but may not be practical in certain situations especially with multiple device configurations In the following example the event new signal acquired is observed by continuously polling the INternal state change Register INR until the corresponding bit in this case bit 0 i e value 1 is non zero indicating that a new waveform has been acquired Reading INR clears this at the same time so that there is no need for an additional clearing action after a non zero value has been detected The command CHDR OFF instructs the oscilloscope to omit any command headers when responding to a query simplifying the decoding of the response The oscilloscope will then send 1 instead of INR 1 CMD CHDR OFF CALL IBWRT SCOPE CMDS MASKS 1 New Signal Bit has value 1 DO CMDS INR CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RDS NEWSIG VAL RD AND MASK LOOP UNTIL NEWSIG MASK WM RCM E Rev D ISSUED February 2005 23 PART ONE ABOUT REMOTE CONTROL TAKE A SERIAL POLL Serial polling takes place once the SRQ interrupt line has been asserted and is only advantageous when you are using several oscilloscopes at once The controller finds which oscilloscope has generated the interrupt by inspecting the SRQ bit in the STB register of each Because the service request is based on an interrupt mechanism serial polling offers a reasonable compromise in terms of servici
62. the transfer and formatting of waveforms and the use of status bytes in reporting errors WM RCM E Rev D ISSUED February 2005 CHAPTER ONE Overview In this chapter see how to gt Construct program messages gt Use commands and queries gt Include data and make data strings 4 ISSUED February 2005 WM RCM E Rev D CHAPTER ONE Overview Operate Your Instrument by Remote Control You can fully control your instrument remotely by using either the optional GPIB General Purpose Interface Bus port if available or the LAN communication port on the scope s I O panel shown below 8 The only actions for which you must use the front panel controls are to power up the scope and to set remote control addresses TIP Use the instrument s Remote Control Assistant to monitor all your remote control operations See the COMM HELP command in Part Two of this manual STANDARDS 22 2 LeCroy s remote control commands conform to the GPIB IEEE 488 2 standard This may be considered an extension of the IEEE 488 1 standard which deals mainly with electrical and mechanical issues COMPATIBILITY WITH OTHER LECROY SCOPES Throughout LeCroy s history the company has striven to maximize compatibility This policy continues to operate But the X Stream DSOs introduce a completely new philosophy in scope communication enabling the scopes to control powerful proprietary programs within the instrument and within the processing chain Y
63. the value of the numerical expression The following mnemonics recognized STRING DATA This data type enables you to transfer a long string of characters as a single parameter Simply enclose any sequence of ASCII characters between single or double quotation marks MESSAGE Connect probe to point 3 The oscilloscope displays this message in the message line at the bottom of the screen BLOCK DATA These are binary data values coded in hexadecimal ASCII four bit nibbles translated into the digits 0 through 9 A through F and transmitted as ASCII characters They are used only for the transfer of waveforms from the oscilloscope to the controller WAVEFORM and for instrument panel setups PANEL_SETUP RESPONSE MESSAGES The oscilloscope sends a response message to the controller in answer to a query The format of such messages is the same as that of program messages individual responses in the format of commands separated by semicolons and ending in terminators These messages can be sent back to the oscilloscope in the form in which they were received to be accepted as valid commands In GPIB response messages the lt NL gt lt EOI gt terminator is always used Example The controller sends the program message TIME_DIV TRIG_MODE NORM C1 COUPLING terminator not shown The oscilloscope might respond to this with TIME_DIV 50 NS C1 COUPLING D50 terminator not shown The response message refers only to
64. to get the most out of instrument actions or features NOTEs bring to your attention important information you should know Example Important Note for users of other LeCroy DSOs Existing software Although the X Stream family of instruments makes extensive use of Automation interfacing enabling many powerful means of control most of the commonly used remote control commands have been retained though in some cases there are minor changes in definitions Automation commands can be used in existing software by using the VBS command which is explained in Chapter 6 Trace labels Math traces TA TB TC and TD have been replaced by F1 F2 F3 and respectively Existing software that includes the old trace labels will work with the X Stream scopes but new software should use the new labels unless it will be used on earlier DSOs In addition to these four traces the instruments include traces math functions F5 F6 F7 and F8 All eight traces are equivalent in their ability to perform zooms or math processing Memory trace labels M1 M2 M3 and M4 are also permissible trace labels Parameter labels have also changed These are now P1 P8 but the older labels Cust1 Cust5 will still work 889 WM RCM E Rev D ISSUED February 2005 1 BLANK PAGE ISSUED February 2005 WM RCM E Rev D PART ONE ABOUT REMOTE CONTROL Part One explains how the instrument operates under remote control It covers GPIB and LAN interfaces
65. 194 ISSUED February 2005 WM RCM E Rev D CURSOR DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties PARAMETER DELETE PADL Command The PARAMETER_DELETE command deletes a parameter at a specified column from the list of parameters used in the Custom mode NOTATION Column of Custom or Pass Fail display Column of Custom or Pass Fail display Column of Custom or Pass Fail display Column of Custom or Pass Fail display Column of Custom or Pass Fail display Column of Custom or Pass Fail display Column of Custom or Pass Fail display of Custom or Pass Fail display PArameter DeLete column column 1 2 3 4 5 6 7 8 The following instruction deletes the third test condition in the list CMDS PADL 3 CALL IBWRT SCOPE CMDS PARAME ER CLR PARAME ER VALUE ISSUED February 2005 1 9 5 PART Two COMMANDS CURSOR PARAMETER STATISTICS PAST Query DESCRIPTION The PARAMETER_STATISTICS query returns the current values of statistics for the specified pulse parameter mode and specified statistic for all columns of the parameter display or all statistics for the specified parameter QUERY SYNTAX A PArameter_STatistics lt mode gt lt statistic gt lt mode gt CUST HPAR lt statistic gt AVG LOW HIGH SIGMA SWEEPS
66. 3 C2 NEG 789E 3 PAVA CUST2 returns C2 PAVA CUST2 789 NS ISSUED February 2005 WM RCM E Rev D EXAMPLE 2 Command Example Query Response Examples EXAMPLE 3 Command Example Query Response Examples EXAMPLE 4 Command Example Query Response Examples EXAMPLE 5 Parameter Math Command Example Query Response Examples RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties DDLY PACU 2 DDLY C1 C2 PACU 2 returns PACU 2 DDLY C1 C2 PAVA CUST2 returns C2 PAVA CUST2 123 NS RLEV PACU 3 RLEV C1 2PCT 67PC PACU 3 returns PACU 3 RLEV C1 2PCT 67PC PAVA CUST3 returns C1 PAVA CUST3 23 MS FLEV PACU 3 FLEV C1 345E 3 122E 3 PACU 3 returns PACU 3 FLEV C1 345E 3 122E 3 CUST3 returns 1 CUST3 23 MS CALCx PACU 5 CALC1 AMPL C3 PACU 5 returns PACU 5 CALC1 AMPL C3 PAVA CUSTS5 returns C2 PAVA 0571 4 884 0 DIV AMP DIV AMP L C2 L C2 PARAMETER DELETE PARAMETER VALUE ISSUED February 2005 193 PART Two COMMANDS EXAMPLE RESPONSE to PACU 1 where Parameter 1 is a script PACU 1 PARAMSCRIPT C1 VBSCRIPT FUNCTION UPDATED TRACELENGTH INRESULT SAMPLES INDATA INRESULT DATAARRAY YTOTAL 0 XYTOTAL 0 FORK 0 TO TRACELENGTH 1 Y INDATA K YY Y Y YTOTAL YTOTAL YY XYTOTAL XYTOTAL YY NEXT OUTRESULT VALUE XYTOTAL YTOTAL END FUNCTION
67. 46 00 08 00 01 32 77 BE BE 6A D7 F2 AO 00 56 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 53 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 17 02 07 00 00 00 00 00 01 00 00 OA 00 00 3F 00 3A 13 00 04 00 FA 00 09 00 16 08 00 1B 00 1B 00 FA 00 EC FC 00 EC 00 05 00 14 00 18 15 00 14 00 03 00 F4 00 05 FO 00 11 00 1D 00 1E 00 F9 18 00 FE 00 EE 00 07 00 19 0A 00 16 00 11 00 Termina tor Above To illustrate the contents of the logical blocks the relevant parts have been separated To make counting easier the corresponding Byte Offset numbering has been restarted each time a new block begins The ASCII translation only part of which is shown has been similarly split and highlighted showing how its parts correspond to the binary contents WM RCM E Rev D ISSUED February 2005 55 PART ONE ABOUT REMOTE CONTROL On the previous page The first 10 bytes translate into ASCII and resemble the simple beginning of a query response These are followed by the string 9000000450 the beginning of a binary block in which nine ASCII integers are used to give the length of the block 450 bytes The waveform itself starts immediately after this at Byte 21 The very first byte is at zero byte count as it is for the first byte in each block The first object is a DESCRIPTOR NAME a string of 16 characters with the value WAVEDESC Then 16 bytes after the beginning of the descriptor
68. ABLE REGISTER SRE sse 66 PARALLEL POLL ENABLE REGISTER 66 INTERNAL STATE CHANGE STATUS REGISTER INR 66 INTERNAL STATE CHANGE ENABLE REGISTER 67 COMMAND ERROR STATUS REGISTER 67 DEVICE DEPENDENT ERROR STATUS REGISTER DDR 67 EXECUTION ERROR STATUS REGISTER EXR sse 67 USER REQUEST STATUS REGISTER nennen 67 ISSUED February 2005 WM RCM E Rev D TABLE OF CONTENTS CHAPTER SIX LINKING WITH AUTOMATION eeeeeeeeeeeeeee 68 What is Automation rere certe tri tea dune Toe meter cedo erus em reo ier cauda reis 69 OVERVIEW E 69 SOME DETAILS ab a ee C Se piti oe Uc RO un ebd edet dL e qan 69 HOW TO USE THE VBS 71 HOW TO USE X STREAM 0 1 4 7 enses nins 72 pede cce EE 76 PART TWO COMMANDS erret 79 Use Commands and Queries eee 81 COMMAND NOTATION iste 2 2 tinte tint oce an nta see neca eee eae Rech ce da npe eodd at ede baia 81 Table of Commands and Queries By Short Form eene 83 Table of Commands and Queries By Subsystem
69. ALL CALL CALL 1 IBWR IBWR l SCOPE 0 disable EOI SCOPES CMDS SCOPE 1 1 EOI SCOPE FILES The M1 command ensures that the active waveform is M1 When the data file is sent to the oscilloscope it first sees the header WF the characters C1 having been skipped when reading the file and assumes the default destination 1 INSPECT FUNCTION_STATE WAVEFORM_TEXT COMM FORMAT COMM ORDER ISSUED February 2005 WAVEFORM SETUP WM RCM E Rev D WAVEFORM TRANSFER DESCRIPTION Remote Control Commands and Queries WAVEFORM SETUP WFSU Command Query The WAVEFORM SETUP command specifies the amount of data in a waveform to be transmitted to the controller The command controls the settings of the parameters listed below NOTATION first point NP number of points Sparsing SP Number of points NP First point FP WM RCM E Rev D segment number Sparsing The sparsing parameter defines the interval between data points For example SP 0 sends all data points SP 1 sends all data points SP 4 sends every 4th data point The number of points parameter indicates how many points should be transmitted For example NP 0 sends all data points NP 1 sends 1 data point NP 50 sends a maximum of 50 data points NP 1001 sends a maximum of 1001 data points The first poi
70. ANDS 204 PASS FAIL PF Command Query The PASS FAIL command sets up the pass fail system PASS FAIL lt state gt lt logic gt lt stop after gt lt state gt ON OFF lt logic gt All True 11 1 AnyTrue AnyFalse Al lQ1ToQA4OrQ5ToQ8 AnyOlToQ4AndAnyQ5ToQ8 stop after gt 1 to 1 000 000 000 sweeps PASS FAIL or PF The following instruction sets the pass fail system to all false and to stop after 20 acquisitions CMD PF ON ALLFALSE 20 CALL IBWRT SCOPE CMDS CRMS ISSUED February 2005 WM RCM E Rev D CURSOR DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE SYNTAX EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties PASS FAIL DO PFDO Command Query The PASS FAIL DO command defines the desired outcome and the actions that have to be performed after a Pass Fail test The PASS FAIL D query indicates which actions are currently selected Note that BEEP PULS SCDP and STO are provided for backward compatibility with existing software for earlier instruments NOTATION ALARM or BEEP Emit a beep PRINT or SCDP Make a hard copy PULSE or PULS Emit a pulse on the Aux out connector SAVE or STO Store in memory or media STOP Stop acquisition Pass Fail DO lt outcome gt lt act gt lt act gt lt outcome gt PASS FAIL lt act gt ALARM BEEP PRINT SCDP PULSE PULS SAVE STO STOP Pass Fail DO Pass Fail DO
71. B 7 GPIB IP 127 0 0 1 LAN COM1 1920 8 N 1 RS232 Execute ActiveDSO Excel 3 Address of Instrument GPIB 4 R5232 example COM1 19200 6 N 1 T Network example 128 23 24 21 Column A shows the number of times the command is to be executed Leaving a cell blank executes it once 7 means pause for 7 seconds after the command w means wait after the command for another click on Execute Column C shows the commands to be executed in rows 10 to 100 Use quit or two blank lines to terminate execution Column E shows the response from the DSO if there is a in the command string in column C Ctrl Commands to Instrument Count Responses from Instrument tdiv 500 9 S c2 vdiv 5DE 3 V chdr OFF grid quad grid QUAD The program fragments below are taken from the VBA code of this program Procedure to send remote control commands to an instrument to receive responses from it Private Sub CommandButton1 Click Execute button Dim o As Object Define variable o as object Equate object o with the ActiveDSO object LeCroy ActiveDSOCtrl1 Set o CreateObject LeCroy ActiveDSOCtrl 1 Strings of the form o ACBD represent methods or properties of object Ox 268 ISSUED February 2005 WM RCM E Rev D GPIB Program Examples Dim DeviceAddress As String Read the device address from cell 2D and use it to connect the PC to the DSO DeviceAddress Worksheets Sheeti Cells 2 4 Value Call o M
72. BWRT SCOPE CMDS CAL ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX AVAILABILITY EXAMPLE WM RCM E Rev D Remote Control Commands and Queties AUTO_SETUP ASET Command The AUTO_SETUP command attempts to display the input signal s by adjusting the vertical timebase and trigger parameters AUTO_SETUP operates only on the channels whose traces are currently turned on If no traces are turned on AUTO_SETUP operates on all channels If signals are detected on several channels the lowest numbered channel with a signal determines the selection of the timebase and trigger source If only one input channel is turned on the timebase will be adjusted for that channel The channel AUTO SETUP FIND command adjusts gain and offset only for the specified channel channel Auto SETup FIND channel C1 C2 C3 C4 If the FIND keyword is present gain and offset adjustments will be performed only on the specified channel If no channel prefix is added an auto setup will be performed on the channel used on the last ASET FIND remote command In the absence of the FIND keyword the normal auto setup will be performed regardless of the channel prefix channel C3 C4 only on four channel oscilloscopes The following instructs the oscilloscope to perform an auto setup CMDS ASET CALL IBWRT SCOPE CMDS ISSUED February 2005 95 PART
73. CAPTURE Changes acquisition state from stopped to single Adjusts vertical timebase and trigger parameters for signal display Selects the vertical attenuation factor of the probe Enables or disables the bandwidth limiting low pass filter Controls the channel interleaving function Selects the specified input channel s coupling mode Forces the instrument to make one acquisition Enables or disables Random Interleaved Sampling RIS Allows selection of maximum memory length Allows vertical offset adjustment of the specified input channel Toggles between internal clock and external clock Toggles between internal clock and external clock Controls the sequence mode of acquisition Immediately stops signal acquisition Modifies the timebase setting Executes an ARM command Sets the coupling mode of the specified trigger source Sets the time at which the trigger is to occur Adjusts the level of the specified trigger source Specifies Trigger mode Defines a trigger pattern Selects the condition that will trigger acquisition Sets the slope of the specified trigger source Sets the vertical sensitivity in volts div Prevents new command analysis until current acquisition completion AUTOMATION SEND AUTOMATION COMMANDS VBS VBS Send Automation commands COMMUNICATION To SET COMMUNICATION CHARACTERISTICS CFMT COMM_FORMAT CHDR COMM_HEADER CHLP COMM_HELP CHL COMM_HELP_LOG CORD COMM_ORDE
74. CMDS WFSU SP 3 FP 200 CALL IBWRT SCOPE CMDS INSPECT WAVEFORM TEMPLATE ISSUED February 2005 WM RCM E Rev D APPENDIX I Program Examples Programming Examples INTRODUCTION TO DSO SOFTWARE TOOLS Although the X Stream DSOs are unrivalled in their ability to process data internally they are sometimes required to send information to the outside world For this purpose LeCroy provides tools that facilitate remote interaction with the instruments This appendix describes two types of software The first type is provided in executable form to enable users to make a quick start with remote control This group includes examples in ActiveDSO The second type is provided in source code to provide programmers with simple examples for development Some of these use ActiveDSO as well EXECUTABLE PROGRAMS These are available on the CD ROM which is shipped with the instruments and on LeCroy s Web site at http wwwilecroy com tm library software ActiveDSO Based on Microsoft s ActiveX control technology ActiveDSO gives leverage to widely available Microsoft software tools and makes programming within the Microsoft environment easier ActiveDSO simplifies the computet s interface with the instrument and simplifies programming within Visual C Visual Basic or any other ActiveX compatible application For example Microsoft Excel can be used to control and retrieve data directly from the X Str
75. COMB lt state gt The following instruction engages channel interleaving between Channels 1 and 2 and Channels 3 and 4 CMD COMB 2 CALL IBWRT SCOPE CMD The following instruction sets Auto Combine mode CMD COMB AUTO CALL IBWRT SCOPE CMD TDIV ISSUED February 2005 WM RCM E Rev D COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queries COMM FORMAT CFMT Command Query The COMM FORMAT command selects the format the oscilloscope uses to send waveform data The available options allow the block format the data type and the encoding mode to be modified from the default settings The COMM FORMAT query returns the currently selected waveform data format Comm ForMaT block format data type encoding block format DEF 9 data type BYTE WORD encoding BIN Initial settings i e after power on are For GPIB and LAN DEF9 WORD BIN Comm ForMaT Comm ForMaT lt block_format gt lt data_type gt lt encoding gt The following instruction redefines the transmission format of waveform data The data will be transmitted as a block of definite length Data will be coded in binary and represented as 8 bit integers CMD CFMT DEF9 BYTE BIN CALL IBWRT SCOPE CMD ISSUED February 2005 1 0 7 PART Two COMMANDS ADDITIONAL INF
76. Command DESCRIPTION Causes the instrument to make one acquisition COMMAND SYNTAX FoRce TRigger EXAMPLE GPIB Either of the following pairs of instructions will force the scope to make one acquisition CMD TRMD SINGLE ARM FRTR CALL IBWRT Scope CMDS CMD TRMD STOP ARM FRTR CALL IBWRT Scope CMDS WM RCM E Rev D ISSUED February 2005 147 PART Two COMMANDS MASS STORAGE DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 148 FORMAT FLOPPY FFLP Command Query The FORMAT FLOPPY command formats a floppy disk in the Double Density or High Density format Format FLoPpy lt type gt type DD HD QUICK If no argument is supplied HD is used by default The following code will format a floppy disk CMDS FFLP DD IBWRT SCOPES CMD CMD FFLP CALL IBWRT SCOPE CMDS DIRECTORY ISSUED February 2005 WM RCM E Rev D FUNCTION DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties FUNCTION_RESET FRST Command The FUNCTION_RESET command resets a waveform processing function The number of sweeps will be reset to zero and the process restarted lt function gt Function_ReSeT function F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TD TA through TD are included for backward compatibility with software designed for earlier LeCroy instruments They are not used in r
77. D 1 M2 M3 M4 C1 C2 C3 C4 TA through TD are for compatibility with existing software with earlier instruments These four mnemonics are not returned by queries This is true for the following entries also function F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TD custom column CUST1 CUST2 CUST3 CUST4 CUST5 P1 P2 P3 P4 P5 P6 P7 P8 CUSTn are for backward compatibility and are not returned by queries Xextended source C1 C2 C3 C4 F1 F2 F3 F4 F5 F6 7 8 TA TB TC TD M1 M2 M3 M4 VALUES TO DEFINE NUMBER OF POINTS SWEEPS max points 50 to 10 000 000 max sweeps gt 1 to 1000 max sweeps 1 to 1 000 000 max sweeps 1 to 50 000 13 0 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties VALUES FOR RESCALE FUNCTION lt addend gt 0 0 to 1e15 lt multiplier gt 0 0 to 1e15 lt units gt UNCHANGED A CEL C HZ K N OHM PAL V W DB DEG PCT RAD 5 RESCALE PHYSICAL UNITS VALUE NOTATION UNCHANGED The unit remains unchanged PAL Pascal Amperes Volt Watt decibel degree Kelvin percent Newton radian second AVAILABILITY lt soutceN gt C3 C4 only on four channel oscilloscopes lt extended_source gt C3 C4 only on four channel oscilloscopes EXAMPLES GPIB The following instruction defines Trace F1 to compute the summed average of Channel 1 over 200 sweeps CMD
78. D GRID Specifies grid display in single dual or quad mode Horizontally expands the selected expansion trace Horizontally positions the intensified zone s center on the source trace INTS INTENSITY Controls the brightness of the grid on the instrument screen MSG MESSAGE Displays a string of characters on the instrument screen for a short time PERS PERSIST Enables or disables the Persistence Display mode PERSIST COLOR Controls color rendering method of persistence traces PERSIST LAST Shows the last trace drawn in a persistence data map PESA PERSIST SAT Sets the color saturation level in petsistence PERSIST SETUP sid Selects display persistence duration in Persistence mode TRA Enables or disables the display of a trace VMAG Vertically expands the specified trace VPOS Adjusts the vertical position of the specified trace ET PMT ELECTRICAL TELECOMM CUSTOM APPLICATION Toggles between Mask Tester mode and oscilloscope mode CU OPT CUSTOM OPTIONS Returns installed custom options pe iil Sets cable attenuation factor for 2M TP 2M COAX 8M 34M 139M 156M PACL PACU L E PAVA PECS MT FAIL ACTION Sets fail actions MTOF MT OFFSET Sets the offset for STM 1E STS 3E and 139M MTOP MT OPC Returns state of last operation 8 8 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries LONG FORM WHAT THE COMMAND OR QUERY DOES MT
79. D ROM are installed on the PC 2 Verify that the PC and instrument are properly connected to the Ethernet 3 Opena new blank presentation in PowerPoint Note This example assumes that PowerPoint 2002 is being used Earlier or Later versions may not behave in the same mannet 4 Select Insert then Object as shown here Microsoft PowerPoint Presentationi hep X Hoes gt oo m 4 ow CIO 4 amp Z A S HO m Side 1 of 1 Defaut Design Engish U 5 WM RCM E Rev D ISSUED February 2005 41 PART ONE ABOUT REMOTE CONTROL 5 From the pop up window select LeCroy ActiveDSO Control as shown here Microsoft PowerPoint Presentationi IGI Edt vow set Format lods Sideshow Window Hep AdaePDE Type a oueston for hei A F new side oom R tito CIO GIL AGRE 2 80m Side 1 of 1 Default Design English U S 4 42 ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Control by LAN 6 From the Edit menu select LeCroy ActiveDSO Control Object then Edit Insert Object View NbDocView Class LEAD Main Control 12 0 LeCro ol LeCroy AladdinSplash Class LeCroy DescriptorButtonCtrl Class LeCroy EventLogView Class LeCroy Knob Class 7 Right click the object and select Make Connection 8 Select Network TCP IP connection as shown here scope WaveMastet Add
80. DE query returns the current trigger mode COMMAND SYNTAX TRig_MoDe lt mode gt lt mode gt AUTO NORM SINGLE STOP NOTE In some older models sending the command TRMD SINGLE while the oscilloscope is armed forces an acquisition In current oscilloscope models this effect can be achieved by sending the command FORCE_TRIGGER QUERY SYNTAX TRig_MoDe RESPONSE FORMAT TRig_MoDe lt mode gt EXAMPLE GPIB The following instruction selects the normal mode CMD TRMD NORM CALL IBWRT SCOPE CMDS RELATED COMMANDS ARM ACQUISITION FORCE TRIGGER STOP TRIG SELECT SEQUENCE TRIG COUPLING TRIG LEVEL TRIG SLOPE WM RCM E Rev D ISSUED February 2005 241 PART Two COMMANDS ACQUISITION TRIG PATTERN TRPA Command Query DESCRIPTION The TRIG PATTERN command defines a trigger pattern The command specifies the logic level of the pattern sources Channel 1 Channel 2 Channel 3 Channel 4 External as well as the states under which a trigger can occur This command can be used even if the Pattern trigger mode has not been activated Notation L LOW H HIGH AND OR NAND NOR The TRIG PATTERN query returns the current trigger pattern COMMAND SYNTAX TRig PAttern lt source gt lt state gt lt source gt state STATE trigger condition lt source gt C1 C2 C4 EX lt state gt L H lt trigger_condition gt AND OR NAND NOR NOTE If a source state is not
81. DOES Clears all current parameters in Custom Pass Fail Controls parameters with customizable qualifiers Deletes a specified parameter in Custom Pass Fail Returns parameter statistics results Returns current parameter mask test values Sets up pass fail system Defines outcome and actions for Pass Fail Enables or disables the persistence display mode Controls color rendering method of persistence traces Positions one of the six independent cursors Shows the last trace drawn in a persistence data map Sets the color saturation level in persistence Selects display persistence duration Sets the PaRallel poll Enable register PRE Recalls one of five non volatile panel setups Recalls a front panel setup from mass storage Toggles between internal clock and external clock Initiates a device reset Stores current state in non volatile internal memory Toggles between internal clock and external clock Initiates a screen dump Controls the sequence mode of acquisition Sets the Service Request Enable register SRE Reads the contents of the IEEE 488 Immediately stops signal acquisition Stores a trace in internal memory or mass storage Stores front panel setup to mass storage Sets up waveform storage Modifies the timebase setting Produces a complete waveform template copy Enables or disables the display of a trace Transfers ASCII files to and from storage media or between scope and computer Executes a
82. E WAVEFORM QUERY Use the WAVEFORM query to transfer waveform data in block formats defined by the IEEE 488 2 standard You can then download the response back to your instrument by using the WAVEFORM command All your waveform s logical blocks can be read with the query C1 WAVEFORM Completeness as well as good use of time and space are the advantages of this approach when you have to read many waveforms with the same acquisition conditions or when you are interested only in large amounts of raw integer data Moreover you can choose any single block for reading with a query such as C1 WAVEFORM See Part Two for the various block names You can place the binary response to a query of the form C1 WAVEFORM or C1I WAVEFORM ALL in a disk file then dump it using the GPIB bus Do this with default settings to show the hexadecimal and ASCII form as on the following page NOTE A waveform query response can easily be a block containing over 16 million bytes if it is in binary format and twice as much if the HEX option is used 54 ISSUED February 2005 WM RCM E Rev D CHAPTER FOUR Understanding and Managing Waveforms BYTE OFFSET ASCII TRANSLATION NUMBER BINARY CONTENTS IN HEXADECIMAL UNINTERESTING 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 68 1 00 37 84 09 40 00 00 00 00 ao 00 00 a 00 00 00 00 00 00 00 34 00 00 00 00 00 00 00 33 00 00 00 00 00 00 00 01 00 34 83 12 6F 3A C9
83. ELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties TRANSFER FILE TRFL Command Query This command allows you to transfer files to and from storage media or between scope and computer The command format is used to transfer files from the computer to storage media The quety format is used to transfer files from storage media to computer TRanser FiLe DISK lt device gt F I LE lt filepath gt 9nnnnnnnnn data crc device FLPY HDD lt filepath gt file name or complete path to a file in another directory lt n n gt file size in bytes lt data gt size lt gt size lt data gt file data arbitrary data block lt gt reserved for future 32 bit CRC cyclic redundancy check of lt data gt 8 bytes long Note CRC checking is not performed by the scope however the 8 byte CRC trailer string is required when sending a file to the scope and supplied when receiving a file from the scope The ASCII string 1 is normally used as trailer string TRFL DISK device FILE lt filepath gt TRFL Z9nnnnnnnnn data crc The following instruction reads the file FAVORITE DSO from the floppy disk CMDS TRFL DISK FLPY FILE FAVORITE DSO CALL IBWRT SCOPE CMDS DIRECTORY ISSUED February 2005 235 PART Two COMMANDS ACQUISITION TRG Command DESCRIPTION The TRG command executes an ARM command TRG is the e
84. EN long FIRST VALID PNT long LAST VALID PNT long FIRST POINT long SPARSING FACTOR long SEGMENT INDEX long SUBARRAY COUNT long SWEEPS PER ACQ long Waveform Template number of data points in the data array If there are two data arrays FFT or Extrema this number applies to each array separately nominal number of data points on the screen count of number of points to skip before first good point FIRST VALID POINT 0 for normal waveforms index of last good data point in record before padding blanking was started LAST VALID POINT WAVE ARRAY COUNT 1 except for aborted sequence and rollmode acquisitions for input and output indicates the offset relative to the beginning of the trace buffer Value is the same as the FP parameter of the WFSU remote command for input and output indicates the sparsing into the transmitted data block Value is the same as the SP parameter of the WFSU remote command for input and output indicates the index of the transmitted segment Value is the same as the SN parameter of the WFSU remote command for Sequence acquired segment count between 0 and NOM SUBARRAY COUNT for Average or Extrema number of sweeps accumulated else 1 ISSUED February 2005 283 APPENDIX II lt 152 gt always and lt 154 gt lt 156 gt lt 160 gt lt 164 gt lt 168 gt 1725 lt 174 gt lt 176 gt lt 180 gt lt 188
85. K device lt directory gt lt directory gt A variable length string detailing the file content of the hard disk ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties DISPLAY DISPLAY DISP Command Query DESCRIPTION The DISPLAY command controls the display screen of the oscilloscope When remotely controlling the oscilloscope and if you do not need to use the display it can be useful to switch off the display via the DISPLAY OFF command This improves oscilloscope response time since the waveform graphic generation procedure is suppressed In addition when the scope is in the DISPLAY OFF mode certain LEDs and the periodic backup of the scope settings are disabled to avoid unnecessary interruptions The response to the DISPLAY query indicates the display state of the oscilloscope NOTE When you set the display to OFF the screen does not actually blank Instead the real time clock and the message field are continuously updated but waveforms and associated text are frozen COMMAND SYNTAX DISPlay lt state gt state ON OFF QUERY SYNTAX DISPlay RESPONSE FORMAT DISPlay lt state gt EXAMPLE GPIB The following instruction turns off the display CMD DISP OFF CALL IBWRT SCOPE CMDS WM RCM E Rev D ISSUED February 2005 137 PART Two COMMANDS DISPLAY DOT JOIN DTJN Command Query DESCRIPTION The DOT JOIN command controls the interpolation
86. L IBWRT SCOPE CMDS RELATED COMMANDS FIND CTR RANGE FUNCTION RESET INR PARAMETER CUSTOM PARAMETER VALUE PASS FAIL CONDITION MORE EXAMPLES OBTAINED USING F1 DEF NOTE New lines in these examples have been inserted for clarity The actual strings are continuous F1 DEF EQN CORR C1 C2 CORRLENGTH 5 DIV CORRSTART0E 3 DIV F1 DEF EQN DERI C1 VERSCALE 1E 6 V S VEROFFSET 48E 3 V SENABLEAUTOSCALE ON 132 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties F1 DEF EQN ERES C1 BITS 0 5 F1 DEF EQN EXCEL C1 C2 SSOURCE1CELL A2 SOURCE2CELL B2 OUTPUTCELL C2 SOURCE1HEADERCELL F2 SOURCE2HEADERCELL G2 OUTPUTHEADERCELL H2 WITHHEADER ON OUTPUTENABLE ON SOURCE1ENABLE ON SOURCE2ENABLE OFF NEWSHEET ON ADVANCED OFF SCALING AUTOMATIC SPREADSHEETFILENAME D TEST34 XLS F1 DEF EQN FFT C1 TYPE POWERSPECTRUM WINDOW RECTANGULAR ALGORITHM LEASTPRIME FILLTYPE TRUNCATE SUPPRESSDC ON F1 DEF EQN FILTER C1 FIRORUR FIR FILTERKIND LOWPASS FILTERTYPE BUTTERWORTH WINDOW RECTANGULAR KAISERBETA 0 GAUSSIANBT 30 PCT COSINEBETA 30 PCT TRANSITIONWIDTH 100E 3 HZ F3DBWIDTH 100E 3 HZ STOPBANDATTENUATION 40 DB PASSBANDRIPPLE 1 DB PASSBANDATTENUATION 1 DB LOWFREQSTOP 1 1E 6 HZ LOWFREQPASS 1E 6 HZ F3DBFREQ 1E 6 HZ CORNERFREQ 1E 6 HZ CENTERFREQ 1E 6 HZ HIGHFREQSTOP 10E 6 HZ HIGHFREQPASS 10E 6 HZ ROLLOFE 5 DB NUMBEROFTAPS 11 NUMBEROFSTAGESA ADVANCED OFEAUTOLENGTH OFF F1 DEF EQN FIR C1 TYPE LOWPASS WINDOW RECTANG
87. LAST PARAM NOTATION average custom parameters highest value horizontal standard parameters vertical standard parameters lowest value parameter definition for each line sigma standard deviation number of sweeps accumulated for each line vertical standard parameters NOTE In CUST mode if keyword PARAM is specified the query returns the list of the five pairs parameter name source QUERY SYNTAX B PArameter STatistics mode lt param gt lt mode gt CUST HPAR VPAR lt param gt P1 P2 P3 P4 P5 P6 P7 P8 19 6 ISSUED February 2005 WM RCM E Rev D EXAMPLE GPIB A EXAMPLE GPIB B RESPONSE FORMAT A RESPONSE FORMAT B WM RCM E Rev D Remote Control Commands and Queties The following instruction reads the average values for all the columns individually CMD PAST CUST AVG CALL IBWRT 5 5 CALL IBRD SCOPES RD The following instruction reads all the statistical values for parameter P2 CMD PAST CUST P27 CALL IBWRT SCOPE CMD CALL IBRD SCOPES RD PAST CUST AVG 144 589E 3 93 766041 V 389 25E 12 5 144 PAST CUST P1 AMPL C1 AVG 290 718 290 718 3 389 25 12 V S 9 5 2900 725 3 589E 3 V 229E 9 V Co V HIGH 297 5E 3 V LAST 294 2E 3 V LOW 278 2E 3 V SIGMA 3 047E 3 V SW ISSUED February 2005 T
88. LECROY X STREAM OSCILLOSCOPES REMOTE CONTROL MANUAL FEBRUARY 2005 LeCroy LeCroy Corporation 700 Chestnut Ridge Road Chestnut Ridge NY 10977 6499 Tel 845 578 6020 Fax 845 578 5985 Internet www lecroy com 2005 by LeCroy Corporation All rights reserved LeCroy ActiveDSO ProBus SMART Trigger JitterTrack WavePro WaveMaster WaveSurfer and Waverunner are registered trademarks of LeCroy Corporation Information in this publication supersedes all earlier versions Specifications subject to change without notice ANSI RAB OMS gt m m m c ISO 9001 2000 FM 65813 Manufactured under ISO 9000 Registered Quality Management System WM RCM E Rev D 902208 TABLE OF CONTENTS O INTRODUC TION c aa a a iaeia 1 PART ONE ABOUT REMOTE CONTROL 3 CHAPTER ONE OVERVIEW x eanaaneuunnh nti irt ki ecc ncc 4 Operate Your X Stream Scope by Remote Control nnmnnn 5 STANDARDS rtt e a Hie cda ra pt P HE aae a eed neces 5 PROGRAM MESSAGES 5 nitet atus i ete citet vt ee de e DENEN 5 COMMANDS AND QUERIES n 7 HEADERS etn eate ee ee alten ee een aga 8 HEADER PATHS bee ette etii ede 8 DATA WALTERUS 9 GHARAGTER DATA ee emet ete ese eet e ee tea idle 9 NUMERIG DATA Io eR tem ehe
89. LL IBWRT SCOPE CMDS CALL IBRD SCOPE RSPS PRINT RSP Response message C2 CRVA HABS 34 2E 6 S 244 E 3 V 120 ISSUED February 2005 WM RCM E Rev D CURSORS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties CURSORS CRS Command Query Sets the type of cursor to be used and the readout Unlike CRMS this will not change the state of parameters or pass fail CURSORS lt type gt lt readout gt lt type gt OFF HREL HABS VREL VABS lt readout gt ABS SLOPE DELTA for HREL lt readout gt ABS DELTA for VREL CURSORS or CRS The following instruction sets the cursors to horizontal relative and readout to the difference between them CMD CRS HREL DELTA CALL IBWRT SCOPE CMDS CURSOR_MEASURE ISSUED February 2005 121 PART Two COMMANDS ET PMT DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT RELATED COMMANDS 122 CUSTOM_APPLICATION CUAP Command Query The CUSTOM APPLICATION command toggles from Mask Tester mode to standard oscilloscope mode CUAP state state OFF MASK TESTER For compatibility with older scopes either argument is acceptable CUAP CUAP lt state gt CUSTOM OPTIONS MT FAIL ACTIONS MT OPC MT PF COUNTERS MT SELECT TEST MT SYMBOL ISSUED February 2005 WM RCM E Rev D ET PMT DESCRIPTION QUERY SYNTAX RESPONSE FORMAT
90. M JTA2 and GPIB are installed the response will be returned as DFP2 SDM JTA2 GPIB Response message if no options are installed OPT O 18 0 ISSUED February 2005 WM RCM E Rev D SAVE RECALL SETUP DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queries PANEL SETUP PNSU Command Query The PANEL SETUP command complements the SAV or RST commands PANEL SETUP allows you to atchive panel setups in encoded form on external storage media Only setup data read by the PNSU query can be recalled into the oscilloscope A panel setup error see table on page 145 will be generated if the setup data block contains invalid data NOTE The communication parameters those modified by commands CFMT CHDR CHLP CORD and WFSU and the enable registers associated with the status reporting system SRE PRE ESE INE are not saved by this command PaNel_SetUp lt setup gt lt setup gt A setup previously read by PNSU PaNel_SetUp PaNel_SetUp lt setup gt The following instruction saves the oscilloscope s current panel setup in the file PANEL SET FILES PANEL SET CMD PNSU CALL IBWRT SCOPE CMD CALL IBRDF SCOPE FILES Whereas the following recalls the front panel setup stored previously in the file PANEL SET into the oscilloscope
91. M RCM E Rev D CHAPTER FOUR Understanding and Managing Waveforms Transfer Waveforms at High Speed You must take several important factors into account if you wish to achieve maximum continuous data transfer rates from your instrument to the external controller The single most important of these is to limit the amount of work done in the computer This means that you should avoid writing data to disk wherever possible minimize operations such as per data point computations and reduce the number of calls to the I O system To do this you can try the following gt Reduce the number of points to be transferred and the number of data bytes per point The pulse parameter capability and the processing functions can save a great deal of computing and a lot of data transfer time if employed creatively gt Attempt to overlap waveform acquisition with waveform transfer The oscilloscope is capable of transferring an already acquired or processed waveform after a new acquisition has been started The total time that the instrument takes to acquire events will be considerably increased if it is obliged to wait for triggers live time gt Minimize the number of waveform transfers by using Sequence mode to accumulate many triggers for each transfer This is preferable to using WAVEFORM_SETUP to reduce the number of data points for transfer It also significantly reduces oscilloscope transfer overhead For example you could use ARM WAIT C1 WF wai
92. MANDS MISCELLANEOUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB 156 IDN Query The IDN query causes the instrument to identify itself The response comprises manufacturer scope model serial number and firmware revision level IDN IDN LECROY model serial number firmware level model six or seven character model identifier lt serial_number gt A nine or 10 digit decimal code firmware level two digits giving the major release level followed by a period then one digit giving the minor release level followed by a period and a single digit update level xx y z This issues an identification request to the scope CMDS IDN CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RSP PRINT RSP Response message IDN LECROY WAVEMASTER WM01000 3 3 0 ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties INE Command Query The INE command sets the INternal state change Enable register INE This command allows one or more events in the INR register to be reflected in the INB summary message bit bit 0 of the STB register For an overview of the INR defined events refer to the table on the next page The INI E query reads the contents of the INE register INE va
93. MANDS QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 222 Ot alternatively 50 100 250 500 1000 2500 5K 10K 25K 50K 100K 250K 500K 1M However values not absolutely identical to those listed immediately above will be recognized by the scope as numerical data see the table under this heading in Chapter 1 For example the scope will recognize 1 0M as 1 millisample But it will recognize 1 OMA as 1 megasample NOTE The oscilloscope will adapt the requested max size to the closest valid value SEQuence SEQuence mode segments max size mode ON OFF The following instruction sets the segment count to 43 the maximum segment size to 250 samples and turns the sequence mode on CMD SEQ ON 43 250 CALL IBWRT SCOPE CMDS TRIG MODE ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties SRE Command Query The SRE command sets the Service Request Enable register SRE This command allows you to specify which summary message bit or bits in the STB register will generate a service request Refer to the table on page 225 for an ovetview of the available summary messages A summary message bit is enabled by writing a 1 into the corresponding bit location Conversely writing a 0 into a given bit locati
94. MATHCADPARAM MATHCADPARAMARITH 200 COMMANDS AVAILABLE WITH XMAP OPTION Histogram mean ATLABPARAM ine gt Delta period at level x Delta time at level MODE Delta width at level NBPH Edges at level NBPW Parameter using Excel Param arithmetic Excel PCONST Frequency at level PSCRIPT PARAMSCRIPT Histogram FWHM Histogram FW at level PKS Half period PCTL lt Histogram amplitude Histogram base POPATX Histogram right bin Histogram median Histogram RMS x tz Histogram top H H z E Time clock to data edge Histogram left bin H Param using Mathcad Param arith Mathcad ISSUED February 2005 Parameter using MATLAB Histogram highest peak Histogram mode Narrow band phase Narrow band power Histogram no of peaks Parameter constant Param VBS Meas param Param VBS WF param Histogram peaks Histogram percentile Period at level Histogram bin population Histogram range Time data to clock edge Histogram standard dev Time clock to clock edge Time interval error Histogram total pop Width at level Histogram Nth peak WM RCM E Rev D Remote Control Commands and Queries AVAILABLE WITH XMATH OPTION Histogram mean Histogram mode Histogram FWHM Narrow band phase Histogram FW peak Narrow band power Histogram amplitude Histogram no of peaks
95. N The Operation bits and meanings are REMOTE LOCKOUT Reserved MNEMONIC PURPOSE Data block DO indicates termination with without EOT REMOTE Remote Mode LOCKOUT Local Lockout Lock out front panel Device Clear if sent with data clear occurs before data block is passed to parser SRQ Device to PC only SERIALPOLL Request a serial poll Reserved Reserved for future expansion Block terminated in EOI Logic 1 use EOI terminator Logic 0 no EOI terminator Note The following examples assume that the host PC operates from Windows 95 The connection procedure for Windows NT is similat WM RCM E Rev D ISSUED February 2005 3 5 PART ONE ABOUT REMOTE CONTROL Manual Setting of LAN Address If you do need to set an address for the instrument go into Windows and perform the usual operations for setting an address Before establishing a direct connection between the oscilloscope and the host computer the PC must first be properly configured A specific TCP IP address must be assigned known as static addressing But this means that the PC cannot be set up to obtain its IP address from a DHCP server To set the host PC s static address with Windows 95 1 Select Start Settings Control Panel 2 Double click the Network icon in the Control Panel A network dialog box similar to this one appears Network Client for Microsoft Networks 3Com Etherl
96. Name WriteString The WriteString method has the following arguments ArgumentDescription controlnameThe name of the ActiveDSO control object e textStringString Text string to send to the device EOI Boolean TRUE terminate with EOI WM RCM E Rev D ISSUED February 2005 47 PART ONE ABOUT REMOTE CONTROL Returns True on success False on failure e Remarks This method sends a string command to the instrument e If EOTis set to TRUE the device will start to interpret the command immediately This is normally the desired behavior e If EOTis set to FALSE a command may be sent in several parts with the device starting to interpret the command only when it receives the final part which should have EOI set to TRUE 48 ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Controlby LAN BLANK PAGE WM RCM E Rev D ISSUED February 2005 49 CHAPTER FOUR Understanding and Managing Waveforms In this chapter see how to gt Structure Waveforms gt Inspect waveform contents gt Transfer waveforms rapidly 5 0 ISSUED February 2005 WM RCM E Rev D CHAPTER FOUR Understanding and Managing Waveforms Know Your Waveform A waveform can be said to have two main parts One is its basic data array raw data values from the oscilloscope s ADCs Analog to Digital Converters obtained in the waveform s capture The other is the description that accompanies this raw data the vertical and horizontal scal
97. OCtrl 1 Read the device address from cell 2C and use it to connect the PC to the DSO Dim deviceAddress As String deviceAddress Worksheets Sheeti1 Cells 2 3 Value Call o MakeConnection deviceAddress Set the DSO into remote control mode Call o SetRemoteLocal 1 Define an array of the size you need for your waveform data Read the waveform data from the DSO into the array Dim waveArray waveArray o GetScaledWaveform C1 500000 0 Place the data into column I 9 column Dim i As Long For 0 To UBound waveArray Worksheets Sheet1 Cells i 3 9 Value waveArray i Next i End Sub Release the control Call o SetRemoteLocal 0 Set o Nothing End Sub WM RCM E Rev D ISSUED February 2005 267 APPENDIX I Program Examples SOURCE CODE EXAMPLE ACTIVEDSO 3 AND 4 The picture below shows the screen of programs Active DSOExcel3 which enables commands and queries to be sent to the X Stream DSO using LeCroy s ActiveDSO system The VBA source code can be seen by clicking Tools Macro Visual Basic Editor The Clear button clears all the commands and queries The Execute button sends the commands and queries in order down the page In fact this program can be used with earlier DSOs which is why the RS232 option is still available As with all ActiveDSO programs a single string is all that is needed to change from one bus to another Examples to go in cell 3D are shown here GPI
98. ORMATION Block Format DEF9 Data Type BYTE WORD Encoding BIN RELATED COMMANDS 108 Uses the IEEE 488 2 definite length arbitrary block response data format The digit 9 indicates that the byte count consists of 9 digits The data block directly follows the byte count field For example a data block consisting of three data bytes would be sent as WF DAT1 9000000003 lt DAB gt lt DAB gt lt DAB gt where lt DAB gt represents an eight bit binary data byte NL END new line with EOD signifies that block transmission has ended The same data bytes as above would be sent as WF DAT1 0 lt DAB gt lt DAB gt lt DAB gt lt NL END gt NOTE The tormat OFF does not conform to the IEEE 488 2 standard and is only provided for special applications where the absolute minimum of data transfer may be important Transmits the waveform data as 8 bit signed integers one byte Transmits the waveform data as 16 bit signed integers two bytes NOTE The data type BYTE transmits only the high order bits of the internal 16 bit representation The precision contained in the low order bits is lost Binary encoding WAVEFORM ISSUED February 2005 WM RCM E Rev D COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties COMM_HEADER CHDR Command Query
99. PF COUNTERS Returns pass fail result MT SELECT TEST Selects Electrical Telecomm testing standard MT_SYMBOL Returns 1 or 0 symbol or pos or neg Controls testing status RUN STOP PAUSE CONTINUE MT_VERTICAL_ALIGN Performs offset alignment for STM 1E STS 3E and 139M FUNCTION To PERFORM WAVEFORM MATHEMATICAL OPERATIONS CLEAR_MEMORY Clears the specified memory CLEAR_SWEEPS Restarts the cumulative processing functions Specifies math expression for function evaluation FIND_CENTER_RANGE Automatically sets the center and width of a histogram FUNCTION_RESET Resets a waveform processing function HARD COPY PRINT THE CONTENTS OF THE DISPLAY Configures the hard copy driver SCREEN_DUMP Initiates a screen dump MISCELLANEOUS Enables or disables automatic calibration BUZZ BUZZER Controls the buzzer in the instrument B z Performs a complete internal calibration COUT CAL_OUTPUT Sets the type of signal put out at the CAL connector Changes the date time of the internal real time clock DELETE_FILE Deletes a file from the currently selected directory DIRECTORY Creates or deletes directories or changes the current directory DELF EMAIL Sets up email protocol and addresses Used for identification purposes Identifies the installed oscilloscope options Performs internal self test SAVE RECALL SETUP TO PRESERVE AND RESTORE FRONT PANEL SETTINGS PANEL SETUP Complements the SAV RST commands RCL
100. PTION The DDR query reads and clears the contents of the Device Dependent or device specific error Register DDR In the case of a hardware failure the DDR register specifies the origin of the failure The following table gives details BIT VALUE DESCRIPTION Reserved 95 N Timebase hardware failure detected Trigger hardware failure detected Channel 4 hardware failure detected Channel 3 hardware failure detected Channel 2 hardware failure detected Channel 1 hardware failure detected External input overload condition detected Reserved Channel 4 overload condition detected Channel 3 overload condition detected Channel 2 overload condition detected Channel 1 overload condition detected QUERY SYNTAX DDR RESPONSE FORMAT DDR lt value gt value 0 to 65535 WM RCM E Rev D ISSUED February 2005 125 PART Two COMMANDS FUNCTION DEFINE DEF Command Query DESCRIPTION The DEFINE command specifies the mathematical expression to be evaluated by a function This command is used to control all math tools and zoom in the standard oscilloscope as well as those in the optional math software packages See the Operator s Manual for details COMMAND SYNTAX function DEFine EQN lt equation gt lt param_name gt value NOTE Function parameters are grouped in pairs The first in the pair names the variable to be modified
101. R WM RCM E Rev D Selects the format to be used for sending waveform data Controls formatting of query responses Controls operational level of the RC Assistant Returns the contents of the RC Assistant log Controls the byte order of waveform data transfers ISSUED February 2005 87 PART Two COMMANDS SHORT LONG FORM WHAT THE COMMAND OR QUERY DOES FORM CURSOR To PERFORM MEASUREMENTS Specifies the type of cursor or parameter measurement for display CRST CURSOR_SET Allows positioning of any cursor CRVA CURSOR_VALUE Returns the values measured by the specified cursors for a given trace RS OFCT Q Ei URSORS Sets the cursor type OFFSET CONSTANT Sets offset to be constant in divisions or volts Controls the parameter mode PARAMETER CLR Clears all current parameters in Custom and Pass Fail modes PARAMETER_CUSTOM Controls parameters with customizable qualifiers PARAMETER DELETE Deletes a specified parameter in Custom and Pass Fail modes PARAMETER_STATISTICS Returns parameter statistics results PARAMETER_VALUE Returns current value s of parameter s and mask tests PASS FAIL Sets up the Pass Fail system PASS FAIL DO Defines outcome and actions for the Pass Fail system PER CURSOR SET Positions one of the six independent cursors DISPLAY To DISPLAY WAVEFORMS DISP DISPLAY Controls the oscilloscope display screen DTJN DOT_JOIN Controls the interpolation lines between data points GRI
102. RESPONSE FORMAT INR lt state gt state 0 to 65535 EXAMPLE GPIB The following instruction reads the contents of the INR register CMD INR CALL IBWRT SCOPE CMDS Response message INR 1026 i e waveform processing in Function C and a screen dump have both terminated RELATED COMMANDS ALL STATUS CLS INE WM RCM E Rev D ISSUED February 2005 159 PART Two COMMANDS WAVEFORM TRANSFER DESCRIPTION QUERY SYNTAX 160 INSPECT INSP Query The INSPECT query allows you to read parts of an acquired waveform in intelligible form The command is based on the explanation of the format of a waveform given by the template use the TEMPLATE query to obtain an up to date copy Any logical block of a waveform can be inspected using this query by giving its name enclosed in quotes as the first string parameter see the template itself The special logical block named WAVEDESC can also be inspected in more detail By giving the name of a variable in the block WAVEDESC enclosed in quotes as the first string parameter it is possible to inspect only the actual value of that variable See Chapter 4 for more on INSPECT NOTATION raw data as integers truncated to 8 most significant bits normalized data gain offset applied as floating point numbers gives measured values in volts or units raw data as integers truncated to 16 most significant bits trace INSPect l
103. SCOPE S CMD CALL IBRD SCOPES RSP PRINT RSP Response message ALST F2 000000 ESR 000052 INR 000005 DDR 000000 CMR 000004 EXR 000024 URR 000000 CLS CMR DDR ESR EXR STB URR ISSUED February 2005 9 1 PART Two COMMANDS ACQUISITION DESCRIPTION COMMAND SYNTAX EXAMPLE RELATED COMMANDS 92 ARM ACQUISITION ARM Command The ACQUISITION command arms the scope and forces a single acquisition if it is already armed ARM acquisition The following instruction enables signal acquisition CMD ARM CALL IBWRT SCOPE CMDS STOP TRG TRIG MODE WAIT FRTR ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties ATTENUATION ATTN Command Query The ATTENUATION command selects the vertical attenuation factor of the probe Values up to 10000 can be specified The ATTENUATION query returns the attenuation factor of the specified channel lt channel gt ATTeNuation lt attenuation gt lt channel gt C1 C2 C3 C4 EX EX10 lt attenuation gt 1 2 5 10 20 25 50 100 200 500 1000 10000 lt channel gt ATTeNuation lt channel gt ATTeNuation lt attenuation gt lt channel gt C3 C4 available only on four channel oscilloscopes The foll
104. SSUED February 2005 WM RCM E Rev D time_stamp data text unit definition Waveform Template double precision floating point number for the number of seconds and some bytes for minutes hours days months and year double seconds 0 to 59 byte minutes 0 to 59 byte hours 0 to 23 byte days 1 to 31 byte months 3 to 12 word year 0 to 16000 word unused There are 16 bytes in a time field byte word or float depending on the read out mode reflected by the WAVEDESC variable COMM TYPE modifiable via the remote command COMM FORMAT arbitrary length text string maximum 160 a unit definition consists of a 48 character ASCII string terminated with a null byte for the unit name WAVEDESC BLOCK Explanation of the wave descriptor block WAVEDESC 0 16 gt c 32 lt 34 gt WM RCM E Rev D DESCRIPTOR_NAME TEMPLATE NAME COMM TYPE enum 0 _1 endenum byte word COMM ORDER enum 0 24 endenum HIFIRST LOFIRST string the first 8 chars are always WAVEDESC string chosen by remote command COMM FORMAT ISSUED February 2005 28 1 APPENDIX II Waveform Template lt lt lt 1 lt c The following variables of this basic wave descriptor block specify the block lengths of all blocks of which the entire waveform as it is currently being read is composed If a block length is zero this block is currently not
105. T RETURN GetData CALL IBCMD BRDO0 DSOTalk FOR J 1 TO I PRINT MIDS RD J 1 NEXT J PRINT CALL IBRD BRDO RDS RETURN StoreData RD1S SPACES 3 LINE INPUT Specify trace TA TD M1 M4 C1 C4 LINE INPUT Enter filename FILES CALL IBCMD BRDO DSOListen CMDS WFSU NP 0 SP 0 FP 0 SN 0 CHDR SHORT CALL IBWRT BRDO CMDS CMDS TRACES WF CALL IBWRT BRDO CMDS CALL IBCMD BRD0 DSOTalks CALL IBRD BRDO RD1 CALL IBRDF BRDO FILES IF 5 lt 0 THEN GOSUB GPIBError PRINT RETURN STOP RecallData 264 ISSUED February 2005 I IBCNT TRACES WM RCM E Rev D GPIB Progtam Examples LINE INPUT Specify target memory 1 4 MEMS LINE INPUT Enter filename FILES CALL IBCMD BRD0 DSOListen CMDS MEM CALL IBWRT BRDO CMDS CALL IBWRTF BRDO FILES IF 5 lt 0 THEN GOSUB GPIBError STOP PRINT RETURN GPIBError PRINT GPIB ERROR IBERR IBERR IBSTA HEXS IBSTA RETURN END NOTE The Template also describes an array named DUAL This is simply a way to allow you to use the INSPECT query to examine the two data arrays together WM RCM E Rev D ISSUED February 2005 265 APPENDIX I Program Examples SOURCE CODE EXAMPLE ACTIVEDSO 1 AND 2 The picture shows the screen of a program Active DSOExcel1 that uses Active DSO embedded in Excel ActiveDSOExcel2 is similar DSO Address GPIB 4 L
106. T Two COMMANDS STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 140 ESE Command Query The ESE command sets the Standard Event Status Enable register ESE This command allows one or more events in the ESR register to be reflected in the ESB summary message bit bit 5 of the STB register For an overview of the ESB defined events refer to the ESR table on page 142 The ESE query reads the contents of the ESE register ESE value value 0 to 255 ESE value The following instruction allows the ESB bit to be set if a user request URQ bit 6 i e decimal 64 and or a device dependent error DDE bit 3 i e decimal 8 occurs Summing these values yields the ESE register mask 64 8 72 CMDS ESE 72 CALL IBWRT SCOPES ESR ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties ESR Query The ESR query reads and clears the contents of the Event Status Register ESR The response represents the sum of the binary values of the register bits 0 to 7 The table below gives an overview of the ESR register structure ESR ESR value value 0 to 255 The following instruction reads and clears the conte
107. THREE Control by LAN Introduction gt The Ethernet connection 10Base T and 100Base T allows you to control the instrument over a network or through a direct connection between the oscilloscope and a computer The connection is made through the Ethernet port located at the rear of the oscilloscope gt This chapter introduces the basic capabilities for control of the instrument over the Ethernet interface This manual gives a complete description of the remote control commands The commands apply to control of the oscilloscope via Ethernet and GPIB Implementation Standard To the greatest extent possible these remote commands conform to the IEEE 488 2 standard which may be considered an extension of the IEEE 488 1 standard dealing mainly with electrical and mechanical issues When using LAN the strings of data that are to be sent to the instrument must be preceded by the requisite header Connections The oscilloscope can be connected to the computer via Ethernet using a TCP IP network protocol This connection can be made through a network using a hub switch etc with a straight through network cable or between the oscilloscope s Ethernet interface and a computer using a crossover network cable Connecting the Instrument to its Host This section describes connecting the instrument to the host PC or network over the standard 10Base T 100Base T Ethernet Windows NT and Windows 95 operating systems ate supported
108. Two COMMANDS ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT AVAILABILITY GPIB EXAMPLE 96 BANDWIDTH_LIMIT BWL Command Query BANDWIDTH LIMIT enables or disables the bandwidth limiting low pass filter The command is used to set the bandwidth individually for each channel The response to the BANDWIDTH LIMIT query indicates whether the bandwidth filters are on or off BandWidth Limit mode BandWidth Limit channel lt mode gt channel mode channel lt mode gt channel lt mode gt mode OFF ON 200MHZ 1GHZ 3GHZ 4GHZ Note OFF Full ON 20MHz lt channel gt C1 C2 C3 C4 BandWidth_Limit BandWidth_Limit lt mode gt If at least two channels have their bandwidth limit filters set differently from one another the response is BandWidth_Limit lt channel gt lt mode gt lt channel gt lt mode gt lt channel gt lt mode gt lt channel gt lt mode gt Available only on 5 GHz and 6 GHz instruments DDA 5005 and SDA The following instruction asserts bandwidth limit on channel 1 CMD BWL C1 ON CALL IBWRT SCOPE CMDS ISSUED February 2005 WM RCM E Rev D MISCELLANEOUS DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties BUZZER BUZZ Command The buzzer command controls the built in buzzer By means of the BEEP argument the buzzer
109. ULAR LECUTOFE 1E 6 HZ COEFFICIENTS 32 F1 DEF EQN HIST C1 VALUES 1000 BINS 100 HORSCALE 50E 3 V CENTER 2E 3 V VERSCALETYPE LINEAR AUTOFINDSCALE ON F1 DEF EQN INTG C1 MULTIPLIER 1 ADDER 0E 12 VERSCALE 5E 9 VEROFFSET 7 703E 9 F1 DEF EQN INTRP C1 INTERPOLATETYPE SINXX EXPAND 10 WM RCM E Rev D ISSUED February 2005 133 PART Two COMMANDS F1 DEF EQN MCAD C1 C2 SSOURCE1VAR S1 SOURCE2VAR S2 0OUTPUTVAR SS1 SOURCE1HEADERVAR S1HDR SOURCE2HEADERVAR S2HDR OUTPUTHEADERVAR O1HDR WITHHEADER ON OUTPUTENABLE ON SOURCE1ENABLE ON SOURCE2ENABLE OFF NEWSHEET ON ADVANCED OFESCALING AUTOMATIC WORKSHEETFILENAME C MATHCAD89 MCD F1 DEF EQN MATLAB C1 C2 MATLABCODE WFORMOUT 0 5 WFORMINI MATLABPLOT OFEMATLABZEROOFFSET 0E 9 MATLABSCALEPERDIV 50E 3 F1 DEF EQN SPARSE C1 SPARSINGFACTOR 1 SPARSINGPHASE 0 F1 DEF EQN TRACK C1 AUTOFINDSCALE ON VERSCALE 50E 3 CENTER 1 56249851E 3 F1 DEF EQN SCRIPT C1 C2 LANGUAGE VBSCRIPT CODE FUNCTION UPDATE vberlf OUTRESULT SAMPLES INRESULT SAMPLES vbcrlf STARTDATA 0 vberlf ENDDATA OUTRESULT SAMPLES vberlf REDIM NEWDATAARRAY OUTRESULT SAMPLES vbcrlf UNSCALEDDATA INRESULT DATAARRAY FALSE vbcrlf LASTPOINT ENDDATA 1 vbcrlf 0 TO LASTPOINT vberlf NEWDATAARRAY I UNSCALEDDATA D vberlf NEXT vberlf OUTRESULT DATAARRAY FALSE NEWDATAARRAY vberlf END FUNCTION vberlf SSTATUS OK TIMEO
110. UT 360 5 134 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties MISCELLANEOUS DELETE_FILE DELF Command DESCRIPTION The DELETE_FILE command deletes a file from the currently selected directory COMMAND SYNTAX DELF DISK lt medium gt FILE lt filename gt lt medium gt FLOPPY HDD EXAMPLE GPIB The following instruction deletes a front panel setup from the floppy disk CMDS DELF DISK FLOPPY FILE TESTRUN TRC CALL IBWRT SCOPE CMDS WM RCM E Rev D ISSUED February 2005 135 PART Two COMMANDS MASS STORAGE DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT 136 DIRECTORY DIR Command Query The DIRECTORY command is used to create or delete file directories on mass storage devices It also allows selection of the current working directory and listing of files in the directory The query response consists of a double quoted string containing a DOS like listing of the directory If no mass storage device is present or if it is not formatted the string will be empty DIRectory DISK device ACTION action lt directory gt DIRectory DISK device lt directory gt device FLPY HDD action CREATE DELE E SWITCH lt directory gt A legal DOS path or filename This can include the V character to define the root directory DIRectory DIS
111. W means write HorScale is equivalent to the older style command TDIV The Range Help column provides short form information about the possible values that the variable can take You can for example write app Acquisition Horizontal HorScale 0 001 to set the timebase You can also for example write HS app Acquisition Horizontal HorScale to read the timebase setting 7 4 ISSUED February 2005 WM RCM E Rev D CHAPTER SIX LINKING WITH AUTOMATION Typical variable types are as follows Single Single precision floating point number Double Double precision floating point number Integer Integer Long Long integer Enum Member of list String String In the case of enum variables you may specify the value using the actual values for example INT or for Reference source in the example already given You may also give the position in the list for the value you want to use for example 0 or 1 in the given example All lists begin with the element In the next figure we see that the variable for SampleMode is an enum type and that the scope is currently running in real time mode 39 XStream Browser Online browsing LeCroy xStreamDSO mi x Ele Edit 2 2 C LeCroy xStreamDSC Name Value Type Flags Status Range Helpstrin a E ad Acquisition RISType BetterCentered Enum Replace BetterCentered Average AuxOutpu
112. a remote X Stream 050 device using 0 0000001 E AuxOutput ExternalClockRate 1 fe undef HorOfFset 0 2 HorOffsetControl Time HorOffsetOrigin 5 c4 HorScale 0 00000005 Channels 4 72 ISSUED February 2005 WM RCM E Rev D CHAPTER SIX LINKING WITH AUTOMATION DCOM permits the distribution of different components for a single application across two or more networked computers running an application distributed across a network and remotely displaying an application The third icon refreshes the connection If you make changes to the instrument setup you must click on this icon if you want XStreamBrowser to capture the changes Ele Edit um Eg amp zaDSO B a AcdP a AcquisitionDuration 0 0000001 ExternalClockRate 1 H ExtImpedance undef Gy 2 HorOffset 0 HorOffsetControl Time HorOffsetOrigin 5 H HorScale 9 00000005 H Channels 71 4 WM RCM E Rev D ISSUED February 2005 73 PART ONE ABOUT REMOTE CONTROL Here is an example of the selection of a line to go into the clipboard 2 xStream Browser Online browsing LeCroy xStreamDSO m xi Ele Edit P a 8 LeCroy xXStreamDSO EM Acquisition ewe __ Type_ Fags fstatus_ Range Hep AcquisitionDuration 0 0000001 Double From 1 012
113. abs gt lt clocklevelis gt lt clockpctlevel gt lt clockabslevel gt lt source2 gt lt dataslope gt lt pctabs gt lt data levelis gt lt datapctlevel gt lt dataabslevel gt lt clockhysteresis gt lt datahysteresis gt SIGMA Histogram standard dev 19 0 ISSUED February 2005 WM RCM E Rev D SKEW TIELEV lt aram gt AVG FWHM FWXX HAMPL HBASE HIGH HMEDI HRMS HTOP LOW MAXP WM RCM E Rev D Remote Control Commands and Queries Time clock to clock edge lt clock1slope gt lt pctabs gt lt clock1levelis gt lt clock1pctlevel gt lt clock1abslevel gt lt source2 gt lt clock2slope gt lt pctabs gt lt clock2levelis gt lt clock2pctlevel gt lt clock2abslevel gt lt cloc khysteresis gt lt clock2hysteresis gt Time interval error lt signaltype gt lt slope gt lt pctabs gt lt leveltype gt lt percentlev el gt lt abslevel gt lt resultscaling gt lt hysteresis gt lt usebaseftre quency gt lt basfrequency gt lt stdbasefrequency gt Histogram total pop Width at level lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt Histogram Nth peak lt peaknumber gt CUSTOMIZABLE PARAMETERS WITH XMATH OPTION Definition Histogram mean Histogram FWHM lt qualifier gt list Histogram FW at level lt hfractionht gt Histogram amplitude Histogram base Histogram right bin Histogram median Histogram RMS Histogram top
114. akeConnection DeviceAddress Set the DSO into remote control mode Call o SetRemoteLocal 1 Set TimeOut to 3 seconds instead of the default which is 10 seconds Call o SetTimeOut 3 Dim ErrorFound GetOut Waiting As Boolean Dim Row Column Counter LoopTotal TCounter FCounter TestLength As Integer Dim HoldOff NewTime XTime StartRow As Single Dim ControlDatum NextData NextNextData Query Quit ReStart As String Column containg the remote control commands Column 3 StartRow 10 11 2 6 is the cell containing the row for restart after a pause It is empty when starting from top of the list of commands which is Cell StartRow Column If Worksheets Sheetl1 Cells 2 6 Value lt 1 Then Row StartRow Else Row Worksheets Sheeti Cells 2 6 Value End If Query Quit quit Set exit flag error flag and waiting flag to false Execute the command line LoopTotal times For Counter 1 To LoopTotal Continue with loop only if no error was found in the loop If ErrorFound False Then Send data to instrument If Len NextData gt 1 Then Call o WriteString NextData 1 Erase contents of cell ready for response from instrument Worksheets Sheet1 115 Row Column 2 Value If LoopTotal gt 1 Then Show progress in cell Worksheets Sheet1 Cells Row Column 1 Value Counter End If WM RCM E Rev D ISSUED February 2005 269 APPENDIX I Program Examples
115. al Timebase Trigger Display Cursors Measure Math Analysis Utilities Help LeCra 777777777 AutoShapesy a _ Slide 1 of 1 Default Design English U 5 Instrument s captured waveform imported into PowerPoint Once the ActiveDSO object has been properly set within the application a macro script can be created utilizing an object method such as WriteString to send DISP ON C1 TRA ON TRMD Then RefreshImage method can be used to update the screen WM RCM E Rev D ISSUED February 2005 45 PART ONE ABOUT REMOTE CONTROL Example VBA VBA is the programming language built in to many of the more recent Windows applications It is a subset of Visual Basic that makes using OLE Automation Servers and ActiveX Controls very simple The following VBA subroutine demonstrates how easy it is to connect to an instrument and send remote commands to it Sub LeCroyDSOTest Dim dso As Object Set dso CreateObject LeCroy ActiveDSO 1 Call dso AboutBox Present the control s About box Call dso MakeConnection IP 172 25 1 2 Connect to the unit Call dso WriteString C1 VDIV 2 1 Setup C1 for 2 Volts Div Call dso WriteString TRMD AUTO 1 Set the trigger mode to AUTO End Sub To enter the VBA editor in members of the Microsoft Office suite 1 Select Tools Macro Visual Basic Editor menu item 2 When the VBA window appears select the Insert Module menu item 3 Copy th
116. ality Solid Display AxisXRotation 45 To save a lot of typing you can write statements like Set Display WaveMaster Display as a kind of shorthand WM RCM E Rev D ISSUED February 2005 69 PART ONE ABOUT REMOTE CONTROL Display AxisYRotation 20 Display PersistenceSaturation 50 Automation remote control Display PersistenceTime Infinite commands are merely copies of Display PersistenceLastTrace False statements like these Set Acquisition WaveMaster Acquisition Acquisition Acquisition TriggerMode Stopped Automation queries are merely the same things reversed To find out the state of the Set C1 Acquisition Cl grid you can write 1 1 1 GM Display GridMode 1 True Where you have already defined Cl UseGrid YT1 GM as a string variable Cl UseDotJoin True Cl Persisted False Cl PersistenceSaturation 50 Cl PersistenceMonoChrome True The complete setup file shows that the vatiables are grouped as follows Acquisition e Cursors e Display e Measure e Memory PassFail SaveRecall e Utility The X Stream DSO differs from earlier scopes in that this same language and structure can be employed by the scope user to send commands from external computers to send commands from programs inside the instrument using ActiveDSO to write scripts and to run many other applications The setup file is a means of setting the s
117. am Nth peak Peaknumber ZEROLVL Eye diagram zero level CUSTOMIZABLE PARAMETERS WITH XMAP OPTION lt param gt qualifier list AVG DPLEV Delta period at level lt signaltype gt lt slope gt lt pctabs gt lt leveltype gt lt percentlev el gt lt abslevel gt lt hysteresis gt lt usebasefrequency gt lt basefr equency gt lt stdbasefrequency gt Delta time at level lt slopel gt lt pctabs gt lt leveltype gt lt percentlevell gt lt abslev ell gt lt source2 gt lt slope2 gt lt pctabs gt lt leveltype gt lt perce ntlevel2 gt lt abslevel2 gt lt hysteresis gt DWIDLEV Delta width at level lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt EDLEV Edges at level lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt EXCELPARAM Parameter using Excel lt sourcel var gt lt source2var gt lt outputvar gt lt source1heade tvat gt lt source2headervar gt lt outputheadervar gt lt withhea der gt lt outputenable gt lt sourcel enable gt lt source2enable gt lt newsheet gt lt advanced gt lt worksheetfilename gt EXCELPARAMAR Param arithmetic Excel ITH FLEV Frequency at level lt pctabs gt lt levelsare gt lt highpct gt lt hightabs gt lt pctabs gt lt levelsare gt lt lowpct gt lt lowabs gt FWHM Histogram FWHM FWXX Histogram FW at level lt hfractionht gt HPER Half period lt slope
118. ame dev4 lt CR gt dev4 ibwrt lt CR gt enter string tdiv CR 0100 cmpl count 5 dev4 ibrd lt CR gt enter byte count 10 lt CR gt 0100 cmpl count 10 54 44 49 56 20 35 30 45 TDIV5OE 2D 39 9 dev4 ibwrt CR enter string cl cpl lt CR gt 0100 cmpl count 7 260 ISSUED February 2005 WM RCM E Rev D GPIB Progtam Examples dev4 ibrd lt CR gt enter byte count 20 lt CR gt 2100 end cmpl count 11 43 31 3A 43 50 4C 20 44 Col CP D 35 30 0 5 0 7 dev4 q lt CR gt to quit the program SOURCE CODE EXAMPLE GPIB 2 Use the GPIB Program for IBM PC High Level Function Calls The following BASICA program allows full interactive control of the oscilloscope using an IBM PC as GPIB controller As in Example 1 it is assumed that the controller is equipped with a National Instruments GPIB interface card All commands can be used following this example simply by entering the text string of the command For example C1 VDIV 50 MV without the quotation marks The program automatically displays the information sent back by the oscilloscope in response to queries In addition a few utilities have been provided for convenience The commands ST and RC enable waveform data to be stored on or retrieved from a disk if the correct drive and file names are provided The command LC returns the oscilloscope to local mode Responses sent back by the oscilloscope are interpreted as characte
119. are identified by a unique binary code in the returned lt status gt number A 0 response indicates that no failures occurred TST TST lt status gt lt status gt 0 self test successful The following causes a self test to be performed CMDS TST CALL IBWRT DDA CMDS CALL IBRD DDA RD PRINT RDS Response message if no failure TST 9 CAL ISSUED February 2005 233 PART Two COMMANDS DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB 234 TRACE TRA Command Query The TRACE command enables or disables the display of a trace An environment error see table on page 145 is set if an attempt is made to display more than four waveforms The TRACE query indicates whether the specified trace is displayed or not lt trace gt TRAce lt mode gt trace Cl1 C2 C3 C4 F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TD TA through TD for compatibility with existing software with earlier instruments These four mnemonics are not returned by queries mode ON OFF trace TRAce trace TRAce mode trace C3 only on four channel instruments The following instruction displays Trace F1 CMDS 2 F1 TRA ON CALL IBWRT SCOPE CMD ISSUED February 2005 WM RCM E Rev D WAVEFORM STORAGE DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB R
120. at Byte 37 we find the beginning of the next string the TEMPLATE NAME with the value LECROY 2 2 Several other parameters follow The INSTRUMENT NAME LECROYLT344 76 bytes from the descriptor start Byte 97 is easily recognizable A very important byte is found at position 34 after the descriptor start This is the value COMM ORDER which gives the order of subsequent bytes in the file This byte is of enum type taking the possible values 0 for high byte first and 1 for low byte first All subsequent readings of the file must use the information given by this byte On the preceding line 36 bytes after the descriptor start Byte 57 a four byte integer gives the length of the descriptor WAVE DESCRIPTOR 00 00 01 5A hex 346 At 60 bytes from the descriptor start Byte 81 we find another four byte integer giving the length of the data array WAVE ARRAY 1 00 00 00 68 hex 104 And at 116 bytes after the descriptor Byte 137 yet another four byte integer gives the number of data points WAVE ARRAY COUNT 00 0000 34 hex 52 Now we know that the data will start at 346 bytes from the descriptor s beginning Byte 367 and that each of the 52 data points will be represented by two bytes The waveform has a total length of 346 104 which is the same as the ASCII string indicated at the beginning of the block The final 0A at Byte 471 is the NL character associated with the GPIB message terminator lt NL gt lt EOI gt Beca
121. atibility with existing software with earlier instruments These four mnemonics are not returned by queries block DESC TEXT TIME DAT1 DAT2 ALL If you do not give a parameter ALL will be assumed trace WaveForm block waveform data block TIP It may be convenient to disable the response header if the waveform is to be restored See the COMM HEADER command for further details trace C3 only available on four channel oscilloscopes The following instruction reads the block DAT1 from Memory 1 and saves it in the file 1 The path header M1 is saved together with the data FILES MEM1 DAT CMD M1 WF DAT1 CALL IBWRT SCOPE CMDS CALL IBRDF SCOPE FILES In the following example the entire contents of Channel 1 are saved in the file CHAN1 DAT The path header C1 is skipped to ensure that the data can later be recalled into the oscilloscope FILES CHANI1 DAT RDS SPACES 3 CMD CHDR SHORT C1 WF CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RDS Skip first 3 characters CALL IBRDF SCOPE FILES Save data in file CHAN1I DAT The following instruction illustrates how the waveform data saved in the preceding example can be recalled into Memory 1 FILES CHAN1 DAT CMD 1 ISSUED February 2005 25 5 PART Two COMMANDS RELATED COMMANDS 256 CALL C
122. ation compatible Client PowerPoint for example showing a captured display image See Embedded Control Example for more details e Asaninvisible object accessed via a scripting language Visual Basic for Applications for example to remotely control an instrument See Accessing from VBA for more details VBA Visual Basic for Applications is the programming language built into many of the more recent Windows applications It is a subset of Visual Basic that makes it very simple to utilize the services of OLE Automation Servers and ActiveX Controls The following VBA subroutine demonstrates how easy it is to connect to an X Stream DSO and send remote commands to it Sub LeCroyDSOTest Dim o As Object Set CreateObject LeCroy ActiveDSOCtr1l 1 Call o AboutBox Present the control s About box Call o MakeConnection IP 172 28 11 26 Connect to device LAN Call o WriteString BUZZ BEEP True Make the DSO beep End Sub 272 ISSUED February 2005 WM RCM E Rev D GPIB Progtam Examples Example Syntax Boolean controlName WriteS tring The WriteString method has the following arguments controlname The name of the ActiveDSO control object textStringString Text string to send to the device EOIBoolean TRUE terminate with EOI Returns True on success False on failure Remarks This method sends a string command to the instrument If EOI is set to TRUE the device will start to interpret the command immediately T
123. ay the waveform units of the vertical axis units of the horizontal axis uncertainty from one acquisition to the next of the horizontal offset in seconds time of the trigger duration of the acquisition in sec in multi trigger waveforms e g sequence RIS or averaging ISSUED February 2005 WM RCM E Rev D Waveform Template _0 single sweep 21 interleaved _2 histogram _3 _4 filter coefficient 25 complex _6 extrema o sequence obsolete _8 centered RIS E peak detect endenum 318 PROCESSING DONE enum E no processing fir filter _2 interpolated 3 sparsed A autoscaled 5 no result _6 rolling cumulative endenum lt 320 gt RESERVED5 word expansion entry 322 RIS SWEEPS word for RIS the number of sweeps The following variables else 1 conditions used when the WM RCM E Rev D describe the basic acquisition waveform was acquired ISSUED February 2005 285 APPENDIX II Waveform Template lt 324 gt TIMEBASE enum _0 1 ps div E 2 ps div 2 5 ps div 23 10 ps div _4 20 ps div 225 50 ps div _6 100 ps div _7 200 ps div _8 500 ps div _9 1 ns div _10 2 ns div cO 5 ns div 12 10 ns div 1 20 ns div _14 50 ns div 15 100 ns div 16 200 ns div 17 500 ns div _18 1 us div 2_us div 220 5 us div _21 10 us div 22 20 us div _ 23 50 us div _ 24 100 us div 25 200 us div 26 500 us div 227 1 ms div _ 28 2 ms div 229 5 ms div 230 10 ms div 231 20 ms div 32 50 m
124. be positioned This means that the trace must be turned on a requirement that does not apply to all earlier LeCroy instruments Also new to X Stream instruments is that PREF and PDIF are not supported because each parameter has its own independent gate NOTE To change only the trace without repositioning the cursors the CURSOR_SET command can be given with no argument for example F2 CRST The CURSOR_SET query indicates the current position of the cursor s The values returned depend on the grid type selected NOTATION HABS horizontal absolute vertical absolute HDIF horizontal difference vertical difference HREF horizontal reference vertical reference COMMAND SYNTAX trace CuRsor SeT cursor position cursor position lt cursor gt lt position gt trace F1 F2 F4 F5 F6 F7 F8 TA TB TC TD C1 C2 C3 CA M1 M2 M3 4 TA through TD are for compatibility with existing software with earlier instruments These four mnemonics are not returned by queries cursor HABS VABS HREF HDIF VREF VDIF position 0 to 10 DIV horizontal position 3 99 to 3 99 DIV vertical WM RCM E Rev D ISSUED February 2005 117 PART Two COMMANDS to those items to be changed The unit DIV is optional QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB RELATED COMMANDS 118 NOTE Parameters are grouped in
125. bruary 2005 1 6 5 PART Two ACQUISITION DESCRIPTION COMMAND SYNTAX NOTE The oscilloscope will adapt to the closest valid lt size gt or numetical lt value gt according to available channel memory QUERY SYNTAX RESPONSE FORMAT EXAMPLE RELATED COMMANDS 166 COMMANDS MEMORY_SIZE MSIZ Command Query On most models where this command quety is available MEMORY SIZE allows selection of the maximum memory length used for acquisition See the specifications in the Operators Manual TIP Reduce the number of data points for faster throughput The MEMORY SIZE query returns the current maximum memory length used to capture waveforms Memory SIZe size lt size gt 500 1 3 2 5 5e 6 le 7 for example in standard numeric format Or alternatively 500 1000 100K 250K 500K However values not absolutely identical to those listed immediately above will be recognized by the scope as numeric data see the table under this heading in Chapter 1 For example the scope will recognize 1 0M as 1 millisample But it will recognize 1 OMA as 1 megasample 2500 5000 10K 25K 50K 1 2 5 5 10 25MA Memory_SIZe Memory SIZe lt size gt The following instruction will set the oscilloscope to acquire at most 10 000 data samples per single shot or RIS acquisition CMDS 2 MSIZ 10K CALL IBWRT SCOPE CMDS ot CMD MSIZ 10e 3 CALL IBWRT
126. by this command If no filename or an empty string is supplied the oscilloscope generates a filename according to its internal rules COMMAND SYNTAX STore PaNel DISK lt device gt FILE lt gt device FLPY HDD lt filename gt A string of up to eight characters with the extension LSS EXAMPLE GPIB The following instruction saves the current oscilloscope setup to floppy disk in a file called DIODE LSS CMDS STPN DISK FLPY FILE DIODE LSS CALL IBWRT SCOPE CMDS RELATED COMMANDS PNSU SAV RECALL PANEL RCL 228 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties WAVEFORM TRANSFER STORE_SETUP STST Command Query DESCRIPTION The STORE SETUP command controls the way in which traces will be stored Any one trace or all displayed traces can be set up for storage either by auto storing or by the STORE command Using auto store two modes are available FILL which stops when the storage medium is full and WRAP which replaces the oldest trace by the latest one Wrap mode will overwrite any trace file whether or not it was made during the current session and whether ot not it records the same trace COMMAND SYNTAX STore SeTup trace dest AUTO lt mode gt FORMAT type 2 trace C1 C2 C3 CA F1 F2 F3 F4 F5 F6 F7 F8 M1 M2 M3 M4 TA TB TC TD ALL DISPLAYED TA through TD are for co
127. cope name and serial number the encoding format used for the data blocks and miscellaneous constants Sequence Acquisition Times block TRIGTIME This is needed for sequence mode acquisitions to record the exact timing information for each segment It contains the time of each trigger relative to the trigger of the first segment as well as the time of the first data point of each segment relative to its trigger Random Interleaved Sampling times block RISTIME This is required for RIS acquisitions to record the exact timing information for each segment First Data Array block SIMPLE or DATA ARRAY 1 This is the basic integer data of the waveform It can be raw or corrected ADC data or the integer result of waveform processing WM RCM E Rev D ISSUED February 2005 5 1 PART ONE ABOUT REMOTE CONTROL Second Data Array block DATA ARRAY 2 This is a second data array needed to hold the results of processing functions such as Extrema or FFT math functions EXTREMA FFT NOTE The instrument template also describes an array named DUAL DATA ARRAY 1 Roof trace Real part ee INSPECT command to examine the two data arrays together DATA ARRAY 2 Floor trace Imaginary part INSPECT WAVEFORM CONTENTS Use the INSPECT query to examine the contents of your waveform You can use it on both of the main waveform parts Its most basic form is INSPECT the template giving you the name of a descriptor it
128. cope very quickly into a given state Individual commands can be sent as required to make changes during the running of an application Because the setup files are in ASCII text format they can be edited very simply using a program such as Notepad This makes your system very much less vulnerable to changes in the scope system It also enables people to share information very easily 70 ISSUED February 2005 WM RCM E Rev D CHAPTER SIX LINKING WITH AUTOMATION HOW TO USE THE VBS COMMAND The key to using automation commands in an existing GPIB program is the VBS command This is described in detail in Part Two of this manual Please note that app refers to the instrument application program It can be defined by a statement like this Set WaveMaster CreateObject LeCroy WaveMasterApplication Here some examples of VBS with the older GPIB equivalents The command syntax is VBS lt automation command gt CMDS VBS app Acquisition C1 VerScale 0 05 CMDS C1 VDIV 50 MV Earlier equivalent CMD VBS app Horizontal HorScale 500e 9 CMD TDIV 0 5e 6 Earlier equivalent CMD VBS app Display GridMode Dual CMD GRID DUAL Earlier equivalent Note that where the command includes double quotation marks you may have to split up the string and use a code to replace the quotation marks In QuickBasic you would use Chr 34 In Visual Basic you would use Chr 34 is an example of se
129. ct the sign from this S 1 The 8 exponent bits have the following values bit 23 is worth 1 bit 24 is worth 2 bit 29 gt 64 bit 30 gt 128 so the resulting number can range from 0 to 28 1 which is 255 127 is then subtracted from this value e creating a range from 127 to 128 This is then used as an exponent to raise two to a power that is 27 to create a value E Then we have to create the multiplying number The values of the 23 bits are as follows Bit 22 is worth 0 5 21 is worth 0 25 20 is worth 0 125 19 is worth 0 0625 When all the bits are added together we obtain a positive number f that can be very close to one differing from it only by the value of the smallest bit if all the bits are ones Generally the value will be much less than one Then we add one to the result obtaining 1 f F The use of the added one extends the dynamic range of the data Another way of calculating f is to take the 23 bit number at face value and divide it by 2724 Finally we multiply together the sign the value E and the value F to create the final result Result 1 s x 2 e 127 x 1 f SxExF Example In Chapter 4 one of the examples Vertical Gain states that the floating point number 34 83 12 6F leads to the decimal value 2 44141E 07 Let s see how this is done The bytes 34 83 12 and 6F can be written in binary as follows 00110100 1000 0011 0001 0010 0110 1111 This string of bits is to be split u
130. d for earlier LeCroy instruments These four mnemonics will not be returned in response to queries factor 100E 3 to 181 trace Vert MAGnify trace Vert MAGnify lt factor gt The following instruction enlarges the vertical amplitude of Trace A by a factor of 3 45 with respect to its original amplitude CMDS TA VMAG 3 45 CALL IBWRT SCOPES CMD VERT POSITION ISSUED February 2005 24 9 PART Two COMMANDS DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE RELATED COMMANDS 250 VERT_POSITION VPOS Command Query The POSITION command adjusts the vertical position of the specified trace on the screen It does not affect the original offset value obtained at acquisition time The POSITION query returns the current vertical position of the specified trace NOTE The VPOS command and query can only be applied to math function and memory traces It does not apply to channel inputs lt trace gt Vert_POSITION lt display_offset gt trace F1 F2 F3 FA4 F5 F6 F7 F8 TA TB TC TD M1 M2 M3 M4 TA through TD are included for backward compatibility with software designed for earlier LeCroy instruments These four mnemonics will not be returned in response to queries display offset 5900 to 5900 DIV NOTE The unit DIV is optional The limits depend on the current magnification factor the number of grids on the display
131. d the VAB bit bit 2 in the STB register is set NOTE The probe attenuation factor is not taken into account in offset adjustments The unit V is optional The OFFSET query returns the DC offset value of the specified channel lt channel gt OFfSeT offset channel C1 C2 C3 C4 lt offset gt See the Operators Manual for specifications lt channel gt OF SeT Xchannel OF SeT offset channel C3 C4 only on four channel oscilloscopes The following instruction sets the offset of Channel 2 to 3 V CMD 2 C2 0FST 3V CALL IBWRT SCOPE CMDS ISSUED February 2005 1 7 7 PART Two COMMANDS CURSOR DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB 178 OFFSET CONSTANT OFCT Command Query As you change the gain this command allows you to either keep the vertical offset level indicator stationary when Div is selected or to have it move with the actual voltage level when Volts is selected The advantage of selecting Div is that the waveform will remain on the grid as you increase the gain whereas if Volts is selected the waveform could move off the grid Regardless of whether you select Volts or Div however the Offset shown in the scope s channel setup dialog always indicates volts Howevet when Div is selected for the Offset Control the offset in volts is scaled proportional to the change in gain thereby keeping the div
132. d waveforms the percent passed and the total number tested QUERY SYNTAX MTPC RESPONSE FORMAT MT PF COUNTERS PASS 266 0F286 FAIL_RATE 6 903007 RELATED COMMANDS CUSTOM APPLICATION CUSTOM OPTIONS MT FAIL ACTIONS MT OPC MT SELECT TEST MT SYMBOL 172 ISSUED February 2005 WM RCM E Rev D ET PMT DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties MT_SELECT_TEST MTST Command Query The MT SELECT TEST command selects the signal test type and performs AUTOALIGN or HORIZONTAL ALIGN actions automatically on the signal MTST lt test_name gt lt channel gt lt averaging gt test name NO TEST E1COAX E2 E3 EA STM1E DS1 DS3 STS1 STS3E lt channel gt C1 C2 C3 C4 lt averagine gt 0 to 128 lt test_name gt lt channel gt lt averaging gt CUSTOM APPLICATION CUSTOM OPTIONS MT FAIL ACTIONS MT OPC MT PF COUNTERS MT SYMBOL ISSUED February 2005 1 73 PART Two COMMANDS MT_SYMBOL MTSY ET PMT Query DESCRIPTION For STM 1E STS 3E and 139 selects the 1 or 0 symbol For DS1 053 and STS1 selects the POS or NEG pulse QUERY SYNTAX MTSY RESPONSE FORMAT MTSY bit value bit value 1 or 0 for STM 1E STS 3E and 139M POS or NEG pulse for DS1 DS3 and STS1 RELATED COMMANDS CUSTOM APPLICATION CUSTOM OPTIONS
133. ddress of the oscilloscope was set to a value other then 4 When you are sending remote commands to the DSO the IBSTA and IBERR don t necessarily indicate that the scope accepted the string but merely that the string was correctly transmitted to the DSO to interpret To ensure that commands were valid and weren t rejected by the DSO use the Remote Control Assistant 20 ISSUED February 2005 WM RCM E Rev D CHAPTER Two Control by GPIB USE ADDITIONAL DRIVER CALLS IBLOC is used to execute the IEEE 488 1 standard message Go To Local GTL i e it returns the oscilloscope to the local state The programming example above illustrates its use IBCLR executes the IEEE 488 1 standard message Selected Device Clear SDC IBRDF and IBWRTF respectively allow data to be read from GPIB to a file and written from a file to GPIB Transferring data directly to or from a storage device does not limit the size of the data block but may be slower than transferring to the computer memory IBRDI and IBWRTI allow data to be read from GPIB to an integer array and written from integer array to GPIB Since the integer array allows storage of up to 64 kilobytes in BASIC IBRDI and IBWRTI should be used for the transfer of large data blocks to the computer memoty rather than IBRD or IBWRT which are limited to 256 bytes by the BASIC string length Note that IBRDI and IBWRTI only exist for BASIC since for more modern programming languages such as C the fu
134. detect The origin of the failure can be localized with the DDR query 142 ISSUED February 2005 RCM E Rev D Remote Control Commands and Queties The QuerY Error bit QYE is set true 1 whenever a an attempt is made to read data from the Output Queue when no output is either present or pending b data in the Output Queue has been lost c both output and input buffers are full deadlock state d an attempt is made by the controller to read before having sent an lt END gt e a command is received before the response to the previous was read output buffer flushed The ReQuest Control bit is always false 0 as the oscilloscope has no GPIB controlling capability The OPeration Complete bit OPC is set true 1 whenever OPC has been received since commands and queries are strictly executed in sequential order The oscilloscope starts processing a command only when the previous command has been entirely executed WM RCM E Rev D ISSUED February 2005 143 PART Two COMMANDS STATUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 144 EXR Query The EXR query reads and clears the contents of the EXecution error Register EXR The EXR register specifies the type of the last error det EX E EX E ected during execution Refer to the table next page R value value 21 to 64 The following instruction reads the cont
135. e PERSIST SETUP query indicates the current status of the persistence PErsist SetUp lt time gt lt gt time 0 5 1 2 5 10 20 infinite mode PERTRACE ALL Note This does not support the argument Top2 of earlier instruments PErsist SetUp PErsist SetUp lt time gt lt gt The following instruction sets the variable persistence at 10 seconds on all traces CMDS PESU 20 ALL CALL IBWRT 5 CMDS PERSIST PERSIST_COLOR PERSIST_PERS PERSIST_SAT ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties PRE Command Query The PRE command sets the PaRallel poll Enable register PRE The lowest eight bits of the Parallel Poll Register PPR are composed of the STB bits PRE allows you to specify which bit s of the parallel poll register will affect the ist individual status bit The PRE query reads the contents of the PRE register The response is a decimal number that corresponds to the binary sum of the register bits PRE lt value gt value 0 to 65 535 PRE PRE value The following instruction will cause the ist status bit to become 1 as soon as the MAV bit bit 4 of STB i e decimal 16 is set and yields the PRE value 16 CMD
136. e above example into the editor window that appears To execute 4 Position the text cursor within the subroutine 5 Either select the Run Run Sub UserForm or press function key F5 Note For more information see the ActiveDSO on line Help On line Help contains VisualCt examples and explanations of ActiveDSO Methods and Properties ActiveDSO This ActiveXTM control enables LeCroy oscilloscopes to be controlled by and to exchange data with a variety of Windows applications that support the ActiveX standard MS Office programs Internet Explorer Visual Basic Visual C Visual Java and MATLAB V5 3 and later are a few of the many applications that support ActiveX controls ActiveDSO is available on CD ROM or on the internet at www lecroy com e With ActiveDSO you can develop your test program using standard GPIB commands For easy integration of your scope data with your Windows Application through GPIB or Ethernet 10Base T or 100Base T ActiveDSO helps you with the following tasks e Generate a report by importing scope data right into Excel or Word 46 ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Controlby LAN e Archive measurement results on the fly in a Microsoft Access Database e Automate tests using Visual Basic Java C Excel VBA ActiveDSO control hides the intricacies of programming and provides a simple and consistent interface to the controlling application With less than 10 lines of VBA
137. e applicable the syntax of the query is given with the format of its response For each command a short GPIB example illustrating a typical use is also provided The GPIB examples assume that the controller is equipped with a National Instruments interface board which calls to the related interface subroutines in BASIC though the principles will be similar in other languages The device name of the oscilloscope is defined as SCOPE in the examples but you can substitute any valid device name Use the two tables that precede the descriptions to quickly find a command or query The first of these lists the commands and queries in alphabetical order according to their long form The second table groups them according to the subsystem or category they belong to COMMAND NOTATION The following notation is used in the commands lt gt Angular brackets enclose words that are used as placeholders of which there are two types the header path and the data parameter of a command A colon followed by an equals sign separates a placeholder from the description of the type and range of values that can be used in a command instead of the placeholder Braces enclose a list of choices one of which must be made Square brackets enclose optional items An ellipsis indicates that the items left and right of it can be repeated any number of times WM RCM E Rev D ISSUED February 2005 81 PART Two COMMANDS Example consider the syntax nota
138. e or time of day for example necessary for a full understanding of the information contained in the waveform When these parts are transmitted together the descriptor comes first You can access this descriptive information by remote control using the INSPECT query which interprets it in an easily understood ASCII text form And you can rapidly transfer the waveform data using the WAVEFORM query You can write it back into the oscilloscope with the WAVEFORM command Your instrument contains a data structure template see Appendix that provides a detailed description of how waveform information is organized Although a sample template is provided with this manual we suggest you use the TEMPLATE query to access the instrument template in the oscilloscope itself the template may change as your oscilloscope s firmware is enhanced Using the STORE and STORE SETUP commands you can also store waveforms preformatted ASCII output for popular spreadsheet and math processing packages LOGICAL DATA BLOCKS Each of your waveforms will normally contain at least a waveform descriptor and data array block However other blocks may also be present in more complex waveforms Waveform Descriptor block WAVEDESO This includes all the information necessary to reconstitute the display of the waveform from the data including hardware settings at the time of acquisition the exact time of the event kinds of processing performed your oscillos
139. eCroy ActiveDSO Example1 Amplitude Data Parameter Values 0 000437 499 ampl AMPL 1 011 0K 0 030812522 rise RISE 200E 9 LT 0 05737504 0 080812559 0 09956257 0 121437587 0 135500088 0 144875094 0 149562597 0 2 0 15 0 1 0 05 15 0 148000106 0 141750097 0 130812585 Amplitude Data 0 115187578 0 098000072 0 076125056 0 048000034 0 018312514 0 009812506 0 036375023 0 061375041 0 089500062 0 109812573 0 123875082 0 142625093 0 147312596 0 153562605 0 147312596 0 13793759 0 127000079 0 109812573 This example shows how to create some simple applications and can be a basis for further explorations in ActiveDSO This example is included in the ActiveDSO system that can be downloaded from LeCroy s web site at http www lecroy com tm library software 266 ISSUED February 2005 WM RCM E Rev D GPIB Program Examples The fragment below is the subroutine that reads waveform data from the DSO and places the values in column I 9 column of the spreadsheet Private Sub GetScaledWaveformButton Click Dim o As Object Define variable o as an object Equate object o with the ActiveDSO object LeCroy ActiveDSOCtrl1 Set o CreateObject LeCroy ActiveDS
140. eam DSO This tool therefore becomes part of the target application and provides seamless access to the full power of the instrument Other Software For users of LabVIEW VI s available for most LeCroy DSOs Executable programs can be found on LeCroy s Web site at http www lecroy com tm library software WM RCM E Rev D ISSUED February 2005 259 APPENDIX I Program Examples SOURCE CODE PROGRAMS These programs can be divided into two types those using National Instruments GPIB software and hardware and those using ActiveDSO which for GPIB also connects to National Instruments software and hardware A great benefit of ActiveDSO is that the code written by the user is completely independent of the hardware connection The selection of GPIB LAN or RS232 for earlier DSOs is made by a single command near the start of a program Programming examples be found on LeCroy s Web site at http wwwlecroy com tm library software SOURCE CODE EXAMPLE GPIB 1 Use the Interactive GPIB Program IBIC This example assumes the use of an IBM PC or compatible computer equipped with a National Instruments GPIB interface card The GPIB driver is left in default state so that the device name dev4 corresponds to the GPIB address 4 the oscilloscope address All text is entered by the user Bold type represents prompts from the program IBIC cr program announces itself ibfind lt CR gt enter board device n
141. eived the timebase would be set to 2 ms div along with the VAB bit The Master Summary Status bit MSS indicates a request for service from the oscilloscope You can only set the MSS bit if you have enabled one or more of the other STB bits with the Service Request Enable Register SRE All Enable registers SRE ESE and INE are used to generate a bit wise AND with their associated status registers The logical OR of this operation is reported to the STB register At power on all Enable registers are zero inhibiting any reporting to the STB The ESR primarily summarizes errors whereas the INR reports internal changes to the instrument Additional details of errors reported by ESR can be obtained with the queries CMR DDR EXR and URR The register structure contains one additional register not shown on the next page Fig 1 This is the Parallel Poll Enable Register PRE which behaves exactly like the SRE but sets the ist bit used in the Parallel Poll Read the ist bit with the IST query Example If you were to send the erroneous command TRIG MAKE SINGLE to your instrument the oscilloscope would reject it and set the Command Error Register CMR to the value 1 unrecognized command query header The non zero value of CMR would be reported to Bit 5 of the Standard Event Status Register ESR which is then set Nothing further would occur unless the corresponding Bit 5 of the Standard Event Status Enable Register ESE
142. em or data block You may use single quotation marks or double ones in the command or none at all but the reply will always use double quotes The answer is returned as a single string but may cover many lines Some typical dialogue follows Question 1 VERTICAL OFFSET Response VERTICAL OFFSET 4 0000e 002 Question C1 INSPECT TRIGGER TIME Response TRIGGER TIME Date APR 8 2004 Time 10 29 0 311462573 You can also use INSPECT to provide a readable translation of the full waveform descriptor block using INSPECT WAVEDESC Again the template will give you the details for interpretation of each of the parameters Also use INSPECT SIMPLE to examine the measured data values of a waveform For example for an acquisition with 52 points INSPECT SIMPLE 1 0005225 0 0006475 0 00029 0 000915 2 25001E 05 0 000835 0001475 0 0013525 0 00204 4E 05 0011475 0 0011475 000915 0 00179 0 0002275 0 0011475 001085 0 00079 00179 0 0002275 0 00071 0 00096 0003525 0 00104 0002725 0 0007725 0 00071 0 0003525 00129 0002275 0005225 0 00046 0 00104 0 00154 0005225 0012725 001335 0 0009775 0 001915 0 000165 0012725 00096 000665 0 001665 0 0001025 0 0010225 00096 0003525 000915 8 50001E 05 0 000835 0 0005225 0 0 0 0 0 0 0 0 0 The numbers in the table above are the fully converted measurements in volts When the data block contains thousands of items the strin
143. ent CONTROL INSTANTIATION This ActiveX component can be instantiated more than once by using the Visual Basic function CreateObject Once the object is created invoking the connection method will initialize it Active DSO enables control of the instrument from a variety of PC desktop applications The complexities of programming with Ethernet are fully encapsulated in this control For example with less than 10 lines of VBA code in an Excel macro the spreadsheet can recover pre scaled waveform data from the X Stream DSO see the on line Excel example in ActiveDSO ActiveDSO control can be used in two fundamental ways 1 Asa visible object embedded in an OLE automation compatible client PowerPoint for example showing a captured instrument display image See the Embedded Control example below for more details 2 As an invisible object accessed through a scripting language VBA for example to remotely control the instrument See VBA example below for more details The ActiveDSO control may be embedded in any ActiveX containment capable client and may be used manually without need of any programming or scripting Example PowerPointThis example shows the control being embedded in a Microsoft PowerPoint slide The waveform captured by the instrument can be easily imported into PowerPoint with just a few mouse clicks 40 ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Control by LAN 1 Ensure that the ActiveDSO files from the C
144. ents These four mnemonics are not returned by queties dest M1 M2 M3 M4 FILE TIP If you send the STORE command without an argument all traces currently enabled in the Store Setup will be stored Modify this setup using STORE SETUP lt trace gt C3 only available on four channel AVAILABILITY oscilloscopes EXAMPLE GPIB The following instruction stores the contents of Trace into Memory 1 M1 5 5 F1 M1 CALL IBWRT SCOPE CMDS The following instruction stores all currently displayed waveforms nto the memory card 5 5 ALL DISPLAYED FILE CALL IBWRT SCOPE CMDS The following instruction executes the storage operation currently defined in the Storage Setup see command STORE_SETUP 5 5 CALL IBWRT SCOPE CMDS RELATED COMMANDS STORE_SETUP WM RCM E Rev D ISSUED February 2005 227 PART Two COMMANDS SAVE RECALL SETUP STORE PANEL STPN Command DESCRIPTION The STORE PANEL command stores the complete front panel setup of your oscilloscope at the time the command is issued in a file in the current directory in mass storage NOTE The communication conditions those modified by commands COMM FORMAT COMM HEADER COMM HELP COMM ORDER and WAVEFORM SETUP and the enable registers associated with the status reporting system commands SRE PRE ESE INE are not saved
145. ents of the EXR register CM CA D EXR CALL IBWRT SCOPE CMDS LL IBRD SCOPES RSP PRINT RSP Response message if no fault EX E AL R 0 L STATUS CLS ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries ADDITIONAL INFORMATION EXECUTION ERROR STATUS REGISTER STRUCTURE EXR Description Permission error The command cannot be executed in local mode Environment error The oscilloscope is not configured to correctly process a command For instance the oscilloscope cannot be set to RIS at a slow timebase Option error The command applies to an option which has not been installed Unresolved parsing error Parameter error Too many parameters specified Non implemented command Parameter missing A parameter was expected by the command Hex data error A non hexadecimal character has been detected in a hex data block Waveform error The amount of data received does not correspond to descriptor indicators Waveform descriptor error An invalid waveform descriptor has been detected Waveform text error A corrupted waveform user text has been detected Waveform time error Invalid RIS or TRIG time data has been detected Waveform data error Invalid waveform data have been detected Panel setup error An invalid panel setup data block has been detected No mass storage present when user attempted to access it Mass storage not formatted when user attempted to access
146. eresis gt lt datahysteresis gt ms Period at level lt signaltype gt lt slope gt lt pctabs gt lt leveltype gt lt percentlev el gt lt abslevel gt lt hysteresis gt lt usebasefrequency gt lt basefr equency gt lt stadbasefrequency gt lt horvalue gt lt cursorshape gt Data to clock edge time lt Clockslope gt lt pctabs gt lt clocklevelis gt lt clockpctlevel gt lt clockabslevel gt lt source2 gt lt dataslope gt lt pctabs gt lt data levelis gt lt datapctlevel gt lt dataabslevel gt lt clockhysteresis gt lt datahysteresis gt Histogram standard dev Time clock to clock edge lt clock1slope gt lt pctabs gt lt clock1levelis gt lt clock1pctlevel gt lt clock1abslevel gt lt source2 gt lt clock2slope gt lt pctabs gt lt clock2levelis gt lt clock2pctlevel gt lt clock2abslevel gt lt cloc k1hysteresis gt lt clock2hysteresis gt TIELEV Time interval error at level lt signaltype gt lt slope gt lt pctabs gt lt leveltype gt lt percentlev el gt lt abslevel gt lt resultscaling gt lt hysteresis gt lt usebasefre quency gt lt basfrequency gt lt stdbasefrequency gt Total jitter at set BER Histogram total populate 18 8 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries WIDLV Width at level lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt Histogr
147. esponses to queries Assuming that Trace F1 has been defined as the summed average of Channel 1 the following will restart the averaging process CMDS F1 FRST CALL IBWRT SCOPE CMDS INR ISSUED February 2005 1 4 9 PART Two COMMANDS DISPLAY GRID Command Query DESCRIPTION The GRID command defines the style of the grid used in the display The GRID query returns the grid style currently in use COMMAND SYNTAX GRID lt grid gt grid SINGLE DUAL QUAD OCTAL AUTO XY XYSINGLE XYDUAL QUERY SYNTAX GRID RESPONSE FORMAT GRID lt grid gt EXAMPLE GPIB The following instruction sets the screen display to dual grid mode CMD GRID DUAL CALL IBWRT SCOPE CMD 15 0 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties HARD COPY HARDCOPY SETUP HCSU Command Query DESCRIPTION The HARDCOPY SETUP command configures the instrument s hard copy driver It enables you to specify the device type and transmission mode of the hard copy unit connected to the instrument This can be clipboard or disk drive as well as a printer One or more individual settings can be changed by specifying the appropriate keywords together with the new values As with all multiple entry commands you can send any combination or permutation of keywords If you send contradictory values within a command the result is governed by the last one sent See the following pages for command notation No
148. essages are made up of one or more commands or queries While the command directs the oscilloscope to change its state for example its timebase or vertical sensitivity the query asks the oscilloscope about that state Very often you will use the same characters for a command and a quety the query being identified by a after the last character For example to change the timebase to 2 ms div send this command to the oscilloscope TIME DIV2M Or to ask the oscilloscope about its timebase send this query TIME DIV 6 ISSUED February 2005 WM RCM E Rev D CHAPTER ONE Overview TIP The response to a query can be a useful way of generating a command that is known to be correct and the response can be copied straight into your program A query causes the oscilloscope to send a response message The control program should read this message with a read instruction to the GPIB or LAN interface of the controller The response message to the above query might be TIME_DIV 10 NS The portion of the query preceding the question mark is repeated as part of the response message If desired this text can be suppressed with the command COMM_HEADER Depending on the state of the oscilloscope and the computation to be done several seconds may pass before a response is received Command interpretation does not have priority over other oscilloscope activities The general form of a command or a query consists of a command header
149. et ByteOrd3 3 Comm Order ByteOrd 1 2 Comm Order ByteOrd3 3 Comm Order FByte ByteOrd3 Sign started FDigit Desc DescPoint FByte FSign FDigit And 128 128 FSign 1 2 FSign Sign completed FExponent FDigit And 127 Exponent started FExponent 2 FExponent FByte ByteOrd3 ByteOrd FDigit Desc DescPoint FByte FExpBit FDigit And 128 If FExpBit 128 Then FExpBit 1 FExponent FExponent FExpBit 127 Exponent completed 296 ISSUED February 2005 WM RCM E Rev D Waveform Template FFraction FFraction CDbl FDigit And 127 Fraction started FFraction Mult2 FByte ByteOrd3 4 2 ByteOrd FDigit Desc DescPoint FByte FFraction FFraction CDbl FDigit Mult3 FByte ByteOrd3 3 ByteOrd FDigit Desc DescPoint FByte FFraction FFraction CDbl FDigit Mult4 Fraction completed FVariable 2 FExponent GetFloat FVariable FSign 1 FFraction Conversion completed End End of GetFloat WM RCM E Rev D ISSUED February 2005 297 APPENDIX II Waveform Template HOW TO CONSTRUCT A FLOATING POINT NUMBER FROM FOUR BYTES Routine to construct a double precision floating point number from eight bytes Function GetDoubleFloat DescPoint as Integer 298 DescPoint is the address of the byte in the waveform descriptor where the data begin The data are assumed to be in an array called Desc 0 to 350 For example to
150. eturned to the free memory pool CLear Memory lt memory gt lt memory gt M1 M2 M3 M4 The following instruction clears the memory M2 CMDS CLM M2 CALL IBWRT SCOPE CMDS STORE ISSUED February 2005 1 0 1 PART Two COMMANDS FUNCTION CLEAR SWEEPS CLSW Command DESCRIPTION The CLEAR_SWEEPS command restarts the cumulative processing functions summed or continuous average extrema FFT power average histogram pulse parameter statistics Pass Fail counters and persistence COMMAND SYNTAX CLear SWeeps EXAMPLE GPIB The following example will restart the cumulative processing CMD CLSW CALL IBWRT SCOPE CMD RELATED COMMANDS INR 102 ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties CLS Command The CLS command clears all status data registers CLS The following instruction causes all the status data registers to be cleared CMD 2 CLS CALL IBWRT ALL STATUS CMR DDR ESR EXR STB URR ISSUED February 2005 1 03 PART Two COMMANDS STATUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 104 Th CMR Query e CMR query reads and clears the contents of the CoMmand error Register see table next page which specifies the last syntax error type detected by your o
151. f a backplane bus the GPIB interconnects independent devices oscilloscopes and computers for example by means of a cable bus GPIB also carries both program and interface messages Program messages often called device dependent messages contain programming instructions measurement results oscilloscope status and waveform data Interface messages manage the bus itself They perform functions such as initialization addressing and unaddressing of devices and the setting of remote and local modes On the one hand devices connected by GPIB to your X Stream DSO can be listeners talkers or controllers A talker sends program messages to one or more listeners while a controller manages the flow of information on the bus by sending interface messages to the devices The host computer must be able to play all three roles For details of how the controller configures the GPIB for specific functions refer to the GPIB interface manufacturet s manual On the other hand the X Stream DSO can be a talker or listener but NOT a controller Much of the material in this chapter is general to all GPIB systems but where detailed instructions and program fragments are provided in this manual they are based on National Instruments hardware and software and on some form of BASIC language Where INCLUDES are mentioned this points to the need to couple the programming language to the GPIB by including some drivers The National Instruments manuals ex
152. for sending waveform data Controls formatting of query responses Controls operational level of the RC Assistant Returns the contents of the RC Assistant log Clears the specified memory Clears all status data registers Restarts the cumulative processing functions Reads and clears the CoMmand error Register CMR Controls the channel interleaving function Controls the byte order of waveform data transfers Sets signal type put out at the CAL connector Selects the specified input channel s coupling mode Specifies the type of cursor parameter measurement Allows positioning of any cursor Returns trace values measured by specified cursors Sets the cursor type Toggles between Mask Tester mode and oscilloscope mode Returns installed custom options Changes the date time of the internal real time clock Reads clears the Device Dependent Register DDR Specifies math expression for function evaluation Deletes a file from the currently selected directory Creates or deletes directories or changes current one Controls the display screen 83 PART Two COMMANDS SHORT LONG FORM FORM SUBSYSTEM CATEGORY Dron SOIN DISPLAY MISCELLANEOUS ESR STATUS O FRIR FORCE TRIGGER ACQUISITION FRST FUNCTION RESET FUNCTION car E SPAY 2 mac HOR macnrry DISPLAY meos HOR POSITION DISPLAY eron MISCELLANEOUS me ine Gm
153. g on the instrument screen Selects max memory length Sets cable attenuation factor for 2M TP 2M COAX 8M 34M 139M 156M Sets fail actions Sets the offset for STM 1E STS 3E and 139M Returns state of last operation Returns pass fail result Selects Electrical Telecomm testing standard Returns 1 or 0 symbol or pos or neg Performs offset alignment for STM 1E STS 3E and 139M Allows output channel vertical offset adjustment Sets offset to be fixed in either divisions or volts Sets the OPC bit in the Event Status Register ESR Identifies oscilloscope options Complements the SAV RST commands Controls the parameter mode WM RCM E Rev D SHORT FORM PAST PARAMETER STATISTICS CURSOR Pr PASS FAIL CURSOR PFDO PASS rars po PERS Persis PECL PERSIST COLOR DISPLAY Peur PERSIST_LAST DIPLAY Pesa PERSIST_SAT 5 Pesu PERSIST_SETUP piseray CCO CONE sAVE RECALL SEQUENCE AQUSIHON sm sra srwus sr AcQUiHHON umm TRANSFER SHEN STORE PANEL 5 mmm _ TRANSFER mex TEMPLATE ____ mA os WAVEFORM TRG TRG ACQUISITION TRIG COUPLING ACQUISITION ACQUISITION WM RCM E Rev D LONG FORM Remote Control Commands and Queries SUBSYSTEM CATEGORY ISSUED February 2005 WHAT THE COMMAND OR QUERY
154. g will be cleared after Comm HeLP 1 the transmission Otherwise it will be kept Log CLR Comm Help Log lt string containing the logged text gt The following instruction reads the remote control log and prints it CMD CHL CALL IBWRT SCOPE CMD PRINT COMM_HELP ISSUED February 2005 1 1 1 PART Two COMMANDS COMMUNICATION COMM_ORDER CORD Command Query DESCRIPTION The COMM ORDER command controls the byte order of waveform data transfers Waveform data can be sent with the most significant byte MSB or the least significant byte LSB in the first position The default mode is to send the MSB first COMM ORDER applies equally to the waveform s desctiptor and time blocks In the descriptor some values are 16 bits long word 32 bits long long ot float or 64 bits long double In the time block all values are floating values i e 32 bits long When COMM ORDER is specified the MSB is sent first when COMM ORDER LO is specified the LSB is sent first The COMM ORDER query returns the byte transmission order in cutrent use COMMAND SYNTAX Comm ORDer mode mode HI LO QUERY SYNTAX Comm ORDer RESPONSE FORMAT Comm ORDer mode EXAMPLE The order of transmission of waveform data depends on the data type The following table illustrates the different possibilities CORD HI CORD LO Word lt MSB gt lt LSB gt lt LSB gt lt MSB gt Lo
155. g will contain a great many lines Depending on the application you may prefer the data in its raw form with either a BYTE 8 bits or a WORD 16 bits for each data value In that case use the relations INSPECT SIMPLE BYTE with 52 ISSUED February 2005 WM RCM E Rev D CHAPTER FOUR Understanding and Managing Waveforms WAVEFORM The examination of data values for waveforms with two data arrays can be performed as follows INSPECT DUAL to get pairs of data values on a single line INSPECT DATA ARRAY 1 to get the values of the first data array INSPECT DATA ARRAY 2 to get the values of the second data array INSPECT has its limitations it is useful but also wordy INSPECT cannot be used to send a waveform back to the oscilloscope If you want to do this or you want the information quickly you should instead use WAVEFORM With WAVEFORM_SETUP it is possible to examine just a part of the waveform or a sparsed form of it See the following pages If you re a BASIC user you might also find it convenient to use INSPECT and WAVEFORM together to construct files containing a version of the waveform descriptor that both you and BASIC can read Using a stored waveform this can be done in a format suitable for retransfer to the instrument with MC INSPECT WAVEDESC WAVEFORM P and then placing the response directly into a disk file WM RCM E Rev D ISSUED February 2005 53 PART ONE ABOUT REMOTE CONTROL USE TH
156. ge of a persistence map Waveform derived from the st dev of a persistence map Change the phase of a set of complex data Shift a waveform in time Rescale waveform as Out A Wave In B Highest Y value at each X in a set of waveforms Select one segment from a sequence Ten times interpolation using sin x x Slices waveform 2 to make many waveforms using wf 1 129 PART Two COMMANDS SPACK lt source gt Magnitude of complex result SPARSE lt source gt lt sparsingfactor gt lt sparsingphase gt Produces as waveform with fewer points than the input SQR lt source gt Square of a waveform SQRT lt soutce gt Square root of waveform values TRACK lt source gt lt autofindscale gt lt verscale gt lt center Track of the values of a parameter gt TREND lt source gt lt verscale gt lt center gt lt autofindscale Trend of the values of a parameter gt WAVESCRIPT lt sourcel gt lt source2 lt language gt lt cod Visual Basic script producing a waveform e gt lt status gt lt timeout gt ZOOMONLY lt source gt Zoom of waveform NOTE The numbers CUST1 through CUSTS refer to the column numbers of the selected custom parameters TA TB TC and TD are included for compatibility with existing scopes such as WavePro scopes and Waverunner scopes These four mnemonics not returned in responses to queties SOURCE VALUES lt soutceN gt F1 F2 F4 F5 F6 F7 F8 TA TB TC T
157. gt lt 196 gt lt 244 gt lt 292 gt lt 296 gt lt 312 gt lt 316 gt 284 POINTS PER PAIR word PAIR OFFSET word VERTICAL GAIN float VERTICAL OFFSET float MAX VALUE float MIN VALUE float NOMINAL BITS word NOM SUBARRAY COUNT word HORIZ INTERVAL float HORIZ OFFSET double PIXEL OFFSET double VERTUNIT unit definition HORUNIT unit definition HORIZ UNCERTAINTY float TRIGGER TIME time stamp ACQ DURATION float RECORD TYPE enum Waveform Template 1 for Peak Detect waveforms which include data points DATA ARRAY 1 min max pairs in DATA ARRAY 2 Value is the number of data points for each min max pair for Peak Detect waveforms only Value is the number of data points by which the first min max pair in DATA ARRAY 2 is offset relative to the first data value in DATA ARRAY 1 to get floating values from raw data VERTICAL GAIN data VERTICAL OFFSET maximum allowed value It corresponds to the upper edge of the grid minimum allowed value It corresponds to the lower edge of the grid a measure of the intrinsic precision of the observation ADC data is 8 bit averaged data is 10 12 bit etc for Sequence nominal segment count else 1 sampling interval for time domain waveforms trigger offset for the first sweep of the trigger seconds between the trigger and the first data point needed to know how to displ
158. he IEEE 488 2 standatd has no effect on the oscilloscope as the instrument only starts processing a command when the previous command has been entirely executed COMMAND SYNTAX WAI RELATED COMMANDS OPC 252 ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties WAIT Command The WAIT command prevents your instrument from analyzing new commands until the current acquisition has been completed The optional argument specifies the timeout in seconds after which the scope will stop waiting for new acquisitions If lt t gt is not given or if lt t gt 0 0 the scope will wait indefinitely WAIT lt t gt lt t gt timeout in seconds default is indefinite send TRMD SINGLE loop send ARM WAIT C1 PAVA MAX read response process response This example finds the maximum amplitudes of several signals acquired one after another ARM starts a new data acquisition The WAIT command ensures that the maximum is evaluated for the newly acquired waveform C1 PAVA MAX instructs the oscilloscope to evaluate the maximum data value in the Channel 1 waveform TRG TRIG_MODE ARM ISSUED February 2005 253 PART Two COMMANDS WAVEFORM TRANSFER DESCRIPTION COMMAND SYNTAX 254 WAVEFORM WF Command Query A WAVEFORM command transfers a waveform from the controller to t
159. he following characters are used in GPIB to control talking and listening ASCII 63 2 General Unlisten ASCII 95 General Untalk ASCII 32 Space Base Listen Address ASCII 64 Base Talk Address 14 ISSUED February 2005 WM RCM E Rev D CHAPTER TWO Control GPIB To make an actual talk address and listen address we have to add the GPIB address to the ASCII values of the base characters to give the ASCII value of the new character So a string of these commands looks like random set of characters Using named variables makes programs easier to understand For example if we have a DSO at GPIB address 4 and a PC at address 4 we construct the command strings as follows for use later in the program UnListens Chr 63 UnTalk Chrs 95 BaseListen 32 BaseTalk 64 DSOAddress 4 DSOListens Chr BaseListen DSOAddress DSOTalks Chr BaseTalk DSOAddress If the PC is at address 0 we can also write PCTalk Chr BaseTalk PCListens Chr BaseListen Finally DSOListenPCTalk UnListen UnTalk PCTalk DSOListens DSOTalkPCListen UnListen UnTalk PCListen DSOTalk These last two strings once defined can be used in programs for sending to the DSO GPIB SIGNALS The GPIB system consists of 16 signal lines and eight ground or shield lines The signal lines are divided into three groups Data Lines These eight lines usually called DIO1 through DIOS carry both
160. he oscilloscope whereas a WAVEFORM query transfers a waveform from the oscilloscope to the controller WAVEFORM stores an external waveform back into the oscilloscope s internal memory A waveform consists of several distinct entities 1 the descriptor DESC the user text TEXT 2 3 the time TIME descriptor 4 the data DAT1 block and optionally 5 asecond block of data DAT2 See Chapter 4 for further information on waveform structure NOTE You can restore to the oscilloscope only complete waveforms quetied with WAVEFORM ALL The WAVEFORM query instructs the oscilloscope to transmit a waveform to the controller The entities can be queried independently If the ALL parameter is specified all four or five entities are transmitted in one block in the order enumerated above NOTE The format of the waveform data depends on the current settings specified by the last WAVEFORM_SETUP COMM ORDER and COMM FORMAT commands memory WaveForm ALL waveform data block memory 1 M2 4 lt waveform_data_block gt Arbitrary data block see Chapter 5 ISSUED February 2005 WM RCM E Rev D QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLES GPIB WM RCM E Rev D Remote Control Commands and Queties trace WaveForm lt block gt trace F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TD M1 M2 M3 M4 C1 C2 C3 C4 TA through TD are for comp
161. her than the default PC2A Later boards from National Instruments and boards from other vendors will require their own software though NI has achieved good compatibility with its earlier systems and older software will often work with newer boards 18 ISSUED February 2005 WM RCM E Rev D CHAPTER Two Control by GPIB MAKE SIMPLE TRANSFERS For a large number of remote control operations it is sufficient to use just three different subroutines IBFIND IBRD and IBWRT provided by National Instruments The following complete program reads the timebase setting of the X Stream DSO and displays it on the terminal GPIB This line holds the INCLUDE for the GPIB routines Find DEVS DEVA4 Because the DSO has been set at address 4 CALL IBFIND DEVS SCOPE X Find the DSO label it SCOPE Send CMD TDIV Make a query string about the time base speed CALL IBWRT SCOPE CMDS Send the string to the DSO Read CALL IBRD SCOPE RDS Read the response from the DSO PRINT RDS Print the response string END Explanation GPIB This line or lines must hold the link between the programming language and the National Instruments GPIB functions and drivers Find Open the device DEV4 and associate with it the descriptor SCOPE All I O calls after that will refer to SCOPE The default configuration of the GPIB handler recognizes DEV4 and associates with it a device with the GPIB address 4 Send Prepare the command s
162. hey are enabled by the corresponding bit of the ESE register gt Bit 6 is either the MSS or RQS bit You can read the STB using the STB query It reads and clears the STB in which case Bit 6 is the MSS bit and it indicates whether the oscilloscope has any reason to request service The response to the query represents the binary weighted sum of the register bits The register is cleared by STB ALST CLS or when power is applied to the instrument Another way to read the STB is using the serial poll see Chapter 2 In this case Bit 6 is the ROS bit indicating that the instrument has activated the SRQ line on the GPIB The serial poll clears only the RQS bit And the STB s MSS bit and any other bits which caused MSS to be set will remain set after the poll These bits must be reset STANDARD EVENT STATUS REGISTER ESR ESR is a 16 bit register reflecting the occurrence of events ESR bit assignments have been standardized by IEEE 488 2 Only the lower eight bits are currently in use Read ESR using ESR The response is the binary weighted sum of the register bits The register is cleared with ESR or ALST with CLS or when power is applied to the scope WM RCM E Rev D ISSUED February 2005 65 PART ONE ABOUT REMOTE CONTROL Example The response message ESR 160 tells you that a command error occurred and that the ESR is being read for the first time after power on The value 160 can be broken down into 128 Bit 7
163. his is normally the desired behavior If EOT is set to FALSE a command may be sent in several parts with the device starting to interpret the command only when it receives the final part which should have EOI set TRUE USING ACTIVEDSO ActiveDSO is highly suitable for fast program development in the Microsoft environment This program is a control of ActiveX the software technology developed by Microsoft as a subset of its COM model ActiveDSO facilitates programming with the X Stream DSO by providing a ready interface between the instrument and the host computer Programs such as Visual C Visual Basic or Visual Basic for Applications VBA can be used under remote control without concern for interfacing complications ActiveDSO acts as the key design structure allowing effective integration of software from the different manufacturers supporting ActiveX containment INSTANTIATION This ActiveX component can be instantiated more than once by using the Visual Basic function CreateObject Once the object is created invoking the connection method will initialize it ActiveDSO enables control of the X Stream DSO from a variety of PC desktop applications The complexities of programming with Ethernet are fully encaspulated within this control For example with fewer than ten lines of VBA code in an Excel Macro the spreadsheet can recover pre scaled waveform data from the X Stream DSO An example is provided in this appendix ActiveDSO contr
164. ic programs quickly and easily These tools are based on ActiveDSO The files for all the software described here are to be found the CD ROM and LeCroy s Web site at http www lecroy com tm library software ActiveDSO Based on Microsoft s ActiveX control technology ActiveDSO gives leverage to widely available Microsoft software tools and makes programming within the Microsoft environment easier ActiveDSO simplifies the computer s interface with the instrument and simplifies programming within Visual C Visual Basic or any other ActiveX compatible applications For example Microsoft Excel can even be used to control and retrieve data directly from the instrument This tool becomes part of the target application and provides seamless access to the full power of the instrument Using ActiveDSO ActiveDSO is highly suitable for fast program development in the Microsoft environment This program is a control of ActiveX the software technology developed by Microsoft as a subset of its COM model ActiveDSO facilitates programming with the instrument by providing a ready interface between the instrument and the host computer Programs such as Visual C Visual Basic or Visual Basic for Applications VBA can be used under remote control without concern for interfacing complications ActiveDSO acts as the key design structure allowing effective integration of software from the different manufacturers supporting ActiveX containm
165. in DATA ARRAY 1 Peak Detect min max pairs data values in DATA ARRAY 1 In the first 2 cases there is exactly one data item in DATA ARRAY 2 for each data item in DATA ARRAY 1 In Peak Detect waveforms there may be fewer data values in DATA ARRAY 2 as described by the variable POINTS PER PAIR 454 54 4 9 lt 4 89 9 9 0 gt MEASUREMENT data the actual format of a data is given the WAVEDESC descriptor by the COMM TYPE variable 00 ENDARRAY SIMPLE ARRAY Explanation of the data array SIMPLE This data array is identical to DATA ARRAY 1 SIMPLE is an accepted alias name for DATA ARRAY 1 0 gt MEASUREMENT data the actual format of a data is given in the WAVEDESC descriptor by the COMM TYPE variable 00 ENDARRAY WM RCM E Rev D ISSUED February 2005 289 APPENDIX II Waveform Template DUAL ARRAY Explanation of the DUAL array This data array is identical to DATA ARRAY 1 followed by DATA ARRAY 2 DUAL is an accepted alias name for the combined arrays DATA ARRAY 1 and DATA ARRAY 2 e g real and imaginary parts of an FFT UNS SUNL NE 0 MEASUREMENT 1 data data in DATA ARRAY 1 lt 0 gt MEASUREMENT_2 data data in DATA ARRAY 2 00 ENDARRAY 00 ENDTEMPLATE 290 ISSUED February 2005 WM RCM E Rev D Waveform Template DECODING FLOATING POINT NUMBERS Single precision values are held in four bytes If these are arranged in decreas
166. ing order of value we get the following bits bit 31 bit 30 bit 29 bit 28 bit 3 bit 2 bit 1 bit 0 We must remember that if the byte order command CORD has been set for low byte first the bytes as received in a waveform descriptor will be received in the reverse order But within a byte the bits keep their otder highest at the left as expected From these bits we are to construct three numbers that are to be multiplied together S x E x F These in turn are constructed as follows Seq E 261 F 1 f and it is s e and f that are calculated directly from the 32 bits The diagram below illustrates the calculation of the vertical gain example of Chapter 4 00110100 10000011 00010010 01101111 75543210 76543210 75543210 755432180 o0717107100100000711000710010011011171 31 30 29 28 27 26 25 24 23 22 21 20 19 18 17 16 15 14 131211103 8 7 6543210 0 01101001 0000011000100 102001102 1111 31 302928 27 26 25 24 235 22 21 201918 17 16 15 14 131211109 8 7 6 5 4 32 1 0 0 105 127 2 40000486373901E 02 1 0 1 2 1 02400004863739 2 44140636596057E 07 Final decoded result WM RCM E Rev D ISSUED February 2005 291 APPENDIX II Waveform Template In a way that does not follow the byte boundaries the bits are to be segregated as follows 31 30 29 24 23 22 215 52 1 0 sign exponent bits fractional bits bit 0 5 0 25 0 125 The sign bit s is 1 for a negative number and 0 for a positive number so it is easy to constru
167. ink Ill PCMCIA 3 583 3 589 Dial Up Adapter NetBEUI gt 3Com Etherlink Ill PCMCIA 30589 3C583B NetBEUI gt Dial Up Adapter Y TCP IP gt 3Com Etherlink Ill PCMCIA 3C 3 6 ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Control by LAN 3 If the TCP IP protocol is not listed you will have to add it Follow your operating system user guide to add the TCP IP protocol and bind it to the Ethernet adapter 4 Double click the line A dialog box similar to the one below appears Select TCP IP Properties 172025 152 5 Tf this has already been selected the computer s static address is set and nothing more needs to be done Cancel out of the TCP IP and network dialog boxes and close the control panel 6 If the address has not already been selected fill in the IP address and subnet mask as shown above The subnet mask for 172 25 x x is 255 255 0 0 If the computer will not be plugged into a network the above WM RCM E Rev D ISSUED February 2005 3 7 PART ONE ABOUT REMOTE CONTROL address or almost any address within the chosen subnet will suffice The only address that will not work is the same one as that of the oscilloscope to be controlled 7 Now click in the TCP IP Properties dialog box Depending on the operating system and version you may need to reboot the computer If so a dialog box should alert you to this Making PhysicalConnection To make the physical connection between the oscill
168. ional Instruments interface the installation procedure will e the GPIB handler GPIB COM into the boot directory e Modify the DOS system configuration file CONFIG SYS to declare the presence of the GPIB handler e Create a sub directory called GPIB PC and install GPIB PC a number of files and programs useful for testing and reconfiguring the system and for writing user programs The following files in the sub directory GPIB PC are particularly useful IBIC EXE allows interactive control of the GPIB by means of functions entered at the keyboard Use of this program is highly recommended to anyone unfamiliar with GPIB programming or with the X Stream DSO s remote commands is an interactive program that allows inspection or modification of the current settings of the GPIB handler run or a later program version refer to the National Instruments manual NOTE In the program examples in this section it is assumed that the National Instruments INI GPIB driver GPIB COM is its default state 1 that you have not modified it with IBCONE EXE This means that the interface board can be referred to by the symbolic name GPIB0 and that devices the GPIB bus with addresses between 1 and 16 be called by the symbolic names DEVI to 16 If you have a National Instruments PC2 interface card rather than PC2A you must run IBCONF to declare the presence of this card rat
169. ision on the grid constant OFFset ConstanT lt constant gt constant VOLTS DIV OFCT OFCT VOLTS CMD OFCT VOLTS CALL IBWRT SCOPE CMDS ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties OPC Command Query The OPC OPeration Complete command sets to true the OPC bit bit 0 in the standard Event Status Register ESR The OPC quety always responds with the ASCII character 1 because the oscilloscope only responds to the query when the previous command has been entirely executed NORG ORC WAI ISSUED February 2005 1 7 9 PART Two COMMANDS MISCELLANEOUS OPT Query DESCRIPTION The OPT query identifies oscilloscope options installed software or hardware that is additional to the standard instrument configuration The response consists of a series of response fields listing all the installed options QUERY SYNTAX OPT RESPONSE FORMAT option 1 gt lt 22 lt option gt option n A three or four character ASCII string NOTE If no option is present the character 0 will be returned EXAMPLE GPIB The following instruction queries the installed options CMD 2 OPT CALL IBWRT SCOPE CMDS CALL IBRD SCOPES RSP PRINT RSP If for example the waveform processing options DFP2 SD
170. it 2 in the STB register see table on page 225 is set if a value outside the legal range is specified The POSITION query returns the position of the geometric center of the intensified zone on the source trace NOTE Segment number 0 has the special meaning Show All Segments Unexpanded lt exp_trace gt Hor POSition lt hor_position gt lt segment gt Xexp trace F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC T D M1 M2 M3 M4 TA through TD are included for backward compatibility with software designed for earlier LeCroy instruments These four mnemonics will not be returned in response to queries Xhor position 0 to 10 DIV lt segment gt 0 to max segments ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries NOTE The segment number is only relevant for wavetorms acquired in sequence mode it is ignored in single waveform acquisitions When the segment number is set to 0 all segments will be shown The unit DIV is optional QUERY SYNTAX lt exp_trace gt Hor POSition RESPONSE FORMAT Xexp trace Hor POSition lt hor_position gt lt segment gt NOTE The segment number is only given for sequence waveforms EXAMPLE GPIB The following instruction positions the center of the intensified zone on the trace currently viewed by Trace A TA at division 3 CMDS F1 HPOS 3 CALL IBWRT SCOPE CMDS WM RCM E Rev D ISSUED February 2005 155 PART Two COM
171. it is set true 1 whenever a data byte resides in the Output queue The Value Adapted Bit VAB is set true 1 whenever a data value in a command has been adapted to the nearest legal value For instance the VAB bit would be set if the timebase is redefined as 2 5 us div since the adapted value is 2 us div INternal state Bit INB is set true 1 whenever certain enabled internal states are entered For further information refer to the INR query WM RCM E Rev D ISSUED February 2005 225 PART Two COMMANDS ACQUISITION STOP Command DESCRIPTION The STOP command immediately stops the acquisition of a signal If the trigger mode is AUTO or NORM STOP will place the oscilloscope in STOPPED trigger mode to prevent further acquisition COMMAND SYNTAX STOP EXAMPLE The following instruction stops the acquisition process CMD STOP CALL IBWRT SCOPE CMDS RELATED COMMANDS ARM ACQUISITION TRIG MODE WAIT FORCE TRIGGER 226 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties WAVEFORM TRANSFER STORE STO Command DESCRIPTION The STORE command stores the contents of the specified trace in one of the internal memories M1 to M4 or in the current directory in mass storage COMMAND SYNTAX 5 lt trace gt lt dest gt trace F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TD C1 C2 C3 C4 ALL_DISPLAYED TA through TD are for compatibility with existing software with earlier instrum
172. its are as follows 51 gt 0 5 50 gt 0 25 49 gt 0 125 48 gt 0 0625 When all the bits are added together we obtain a positive number f that can be very close to one differing from it only by the value of the smallest bit if all the bits are ones Generally the value will be much less than one Then we add one to the result obtaining 1 f F The use of the added one extends the dynamic range of the data Alternatively we can take the 52 bit number at face value and divide it by 255 Finally we multiply together the sign the value E and the value F to create the final result Result S x E x F WM RCM E Rev D ISSUED February 2005 295 APPENDIX II Waveform Template HOW TO CONSTRUCT A FLOATING POINT NUMBER FROM FOUR BYTES Routine to construct a floating point number from four bytes Function GetFloat DescPoint as Integer DescPoint is the address of the byte in the waveform descriptor where the data begin The data are assumed to be in an array called Desc 0 to 350 For example to calculate VERTICAL GAIN DescPoint 156 Constants needed by GetFloat Mult2 1 128 Mult3 Mult2 256 Mult4 Mult3 256 Comm_Order is the variable which provides information about the order of the bytes in the descriptor and in the waveform data Comm_Order is the byte at position 34 in the descriptor Set ByteOrd 1 when Comm_Order 0 for high byte first Set ByteOrd 1 when Comm Order 1 for low byte first S
173. k and an external sample clock COMMAND SYNTAX Sample ClocK state lt state gt INTERNAL EXTERNAL QUERY SYNTAX Sample ClocK RESPONSE FORMAT Sample ClocK lt state gt EXAMPLE GPIB The following instruction sets the instrument to use an external sample clock CMD SCLK EXTERNAL CALL IBWRT SCOPE CMD 218 ISSUED February 2005 WM RCM E Rev D SAVE RECALL SETUP DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties SAV Command The SAV command stores the current state of your instrument in non volatile internal memory The SAV command stores the complete front panel setup of the oscilloscope at the time the command is issued NOTE Neither communication parameters those modified by the commands COMM_FORMAT COMM_HEADER COMM_HELP COMM_ORDER and WAVEFORM_SETUP nor enable registers of the status reporting system SRE PRE ESE INE are saved when SAV is used SAV lt panel_setup gt lt panel_setup gt 1 to 6 The following instruction saves the current instrument setup in panel setup 3 CMD 2 SAV 3 CALL IBWRT SCOPE CMDS PANEL SETUP RCL ISSUED February 2005 21 9 PART Two COMMANDS HARD COPY SCREEN DUMP SCDP Command DESCRIPTION The SCREEN DUMP command causes the instrument to send the screen contents to the current hardcopy device The time and date stamp corre
174. l is completed the RQS bit in the STB status register is cleared Note that the other STB register bits remain set until they are cleared by means of a CLS command or the oscilloscope is reset If these bits are not cleared they cannot generate another interrupt DO A PARALLEL POLL Like serial polling this is only useful when several oscilloscopes are connected The controller simultaneously reads the Individual STatus bit IST of all oscilloscopes to determine which one needs service This method allows up to eight different oscilloscopes to be polled at the same time When a parallel poll is initiated each oscilloscope returns a status bit over one of the DIO data lines Devices may respond either individually using a separate DIO line or collectively on a single data line Data line assignments are made by the controller using a Parallel Poll Configure PPC sequence 24 ISSUED February 2005 WM RCM E Rev D CHAPTER TWO Control by GPIB In the following example the command INE 1 enables the event new signal acquired in the INR to be reported to the INB bit of the status byte STB The PaRallel poll Enable register PRE determines which events will be summarized in the IST status bit The command PRE 1 enables the INB bit to set the IST bit whenever it is itself set Once parallel polling has been established the parallel poll status is examined until a change on data bus line DIO2 takes place Stage 1 1 Enable the
175. lines between data points Setting DOT JOIN ON selects Points in the Display dialog OFF selects Line COMMAND SYNTAX DoT JoiN lt state gt state ON OFF QUERY SYNTAX JoiN RESPONSE FORMAT DoT JoiN state EXAMPLE GPIB The following instruction turns off the interpolation lines CMDS DTJN OFF CALL IBWRT SCOPE CMDS 13 8 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties DISPLAY EMAIL MAIL Command Query DESCRIPTION The EMAIL command sets up the e mail configuration in the Preferences dialog COMMAND SYNTAX EMAIL MODE lt 5 MAPI gt TO lt to address gt FROM from address gt SERVER lt SMTP Server gt SMTP or MAPI gt SMTP to address gt valid recipient address e g myName a myProvider com from address gt valid originator address e g myXStreamDSO LeCroy com lt 5 Server gt valid SMTP server address e g domino lecroy com QUERY SYNTAX MAIL RESPONSE FORMAT MAIL MODE SMTP TO MYNAME MYPROVIDER COM FROM MY XSTREAMDSO LECROY COM SERVER DOMINO LECROY COM EXAMPLE GPIB CMD MAIL MODE SMTP TO MYNAME MYPROVIDER COM FROM MY XSTREAMDSOQLECROY COM SERVER DOMINO LECROY COM CALL IBWRT SCOPES CMD WM RCM E Rev D ISSUED February 2005 139 PAR
176. lt pass_fail gt lt act gt lt act gt 1 lt pass_fail gt PASS FAIL lt act gt ALARM PRINT PULSE SAVE STOP The following instruction forces the instrument to stop acquiring when the test passes CMD PFDO PASS STOP CALL IBWRT SCOPE CMDS ISSUED February 2005 20 5 PART Two COMMANDS RELATED COMMANDS BUZZER CURSOR_MEASURE CURSOR_SET INR PARAMETER VALUE PASS FAIL MASK 206 ISSUED February 2005 WM RCM E Rev D DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties PERSIST PERS Command Query The PERSIST command enables or disables the persistence display mode PERSist mode mode ON OFF PERSist PERSist mode The following instruction turns the persistence display ON CMDS PERS ON CALL IBWRT SCOPES CMD PERSIST COLOR PERSIST LAST PERSIST SAT PERSIST SETUP ISSUED February 2005 20 7 PART Two COMMANDS DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 208 PERSIST COLOR PECL Command Query The PERSIST COLOR command controls the color rendering method of persistence traces The response to the 5 5 COLOR query indicates the color rendering method Analog Persistence or Color Graded Persistence See the Operator s Manual PErsist CoLor lt state g
177. lue value 0 to 65535 INE value The following instruction allows the INB bit to be set whenever a screen dump has finished bit 1 i e decimal 2 or a waveform has been acquired bit 0 i e decimal 1 or both of these Summing these two values yields the INE mask 2 1 3 CMDS INE 3 CALL IBWRT SCOPE CMDS INR ISSUED February 2005 15 7 PART Two STATUS DESCRIPTION 158 Bit Value N 1 COMMANDS INR Query The INR query reads and clears the contents of the INternal state change Register INR The INR register table below records the completion of various internal operations and state transitions INTERNAL STATE REGISTER STRUCTURE INR Description Reserved for future use Probe was changed Trigger is ready Pass Fail test detected desired outcome Reserved Reserved Reserved Reserved A floppy or hard disk exchange has been detected Floppy or hard disk has become full in AutoStore Fill mode Reserved for LeCroy use A segment of a sequence waveform has been acquired in acquisition memory but not yet read out into the main memory A time out has occurred in a data block transfer A return to the local state is detected A screen dump has terminated A new signal has been acquired in acquisition memory and read out into the main memory ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties QUERY SYNTAX INR
178. med that the controller is IBM PC compatible and that it is equipped with a National Instruments GPIB interface card Nevertheless GPIB programming with other languages such as C or Pascal is quite similar If you re using another type of computer or GPIB interface refer to the interface manual for installation procedures and subroutine calls This procedure refers to the installation and configuration of a GPIB card under the DOS operating system More recent operating systems Windows 95 98 ME NT 2000 XP etc generally use Plug n Play GPIB drivers which are configured using an icon in the control panel CONFIGURE THE GPIB DRIVER SOFTWARE Verify that the GPIB interface is properly installed in the computer If it is not follow the interface manufacturer s installation instructions In the case of the National Instruments interface it is possible to modify the base I O address of the board the DMA channel number and the interrupt line setting using switches and jumpers In the program examples below default positions are assumed Connect the X Stream DSO to the computer with a GPIB interface cable Set the GPIB address to the required value The program examples assume a setting of 4 WM RCM E Rev D ISSUED February 2005 17 PART ONE ABOUT REMOTE CONTROL The host computer requires an interface driver that handles the transactions between the operator s programs and the interface board In the case of the Nat
179. mpatibility with existing software with earlier instruments These four mnemonics are not returned by queries lt dest gt M1 M2 M3 M4 HDD lt mode gt OFF FILL WRAP lt type gt ASCII BINARY EXCEL MATHCAD MATLAB QUERY SYNTAX STore_SeTup RESPONSE FORMAT STore SeTup lt trace gt lt dest gt AUTO lt mode gt EXAMPLE GPIB The following instruction enables autostore for channel 1 to be performed until insufficient space remains for another file CMDS STST C1 HDD AUTO FILL CALL IBWRT SCOPE CMDS WM RCM E Rev D ISSUED February 2005 229 PART Two COMMANDS RELATED COMMANDS STORE INR 230 ISSUED February 2005 WM RCM E Rev D WAVEFORM TRANSFER DESCRIPTION QUERY SYNTAX RESPONSE FORMAT RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties TEMPLATE TMPL Query The TEMPLATE query produces a copy of the template that describes the various logical entities making up a complete waveform In particular the template describes in full detail the variables contained in the descriptor part of a waveform See Chapter 4 for more on the waveform template and Appendix IT for a copy of the template itself TeMPLate TeMPLate lt template gt template A variable length string detailing the structure of a waveform INSPECT ISSUED February 2005 231 PART Two COMMANDS ACQUISITION DESCRIPTION
180. n ARM command Sets the coupling mode of the specified trigger source Sets the time at which the trigger is to occur 85 PART Two COMMANDS SHORT LONG FORM SUBSYSTEM WHAT THE COMMAND OR QUERY FORM CATEGORY DOES TRLV ACQUISITION eic the trigger level of the specified trigger TRMD TRIG MODE Specifies the trigger mode TRPA Defines a trigger pattern TRSE Selects the condition that will trigger acquisition Sets the trigger slope of the specified trigger source TST CTST Performs internal self test ves vss Sends an automation command IUE Vertically expands the specified trace Adjusts the vertical position of the specified trace WAIT WAIEt to continue required by the IEEE 488 WAIT WAIT Prevents new analysis until current is completed WAVEFORM we WAVEFORM TRANSFER Transfers a waveform from controller to scope WAVEFORM Specifies amount of waveform data to go to 86 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries Table of Commands and Queries By Subsystem LONG FORM ARM ACQUISITION BANDWIDTH_LIMIT OMBINE CHANNELS COUPLING FORCE TRIGGER INTERLEAVED MEMORY SIZE 8 5 5 2 REFERENCE_CLOCK SAMPLE CLOCK SEQUENCE TIME DIV TRIG COUPLING TRIG DELAY TRIG LEVEL H H TRIG PATTERN TRIG SELECT TRIG SLOPE VOLT DIV WHAT THE COMMAND OR QUERY DOES ACQUISITION To CONTROL WAVEFORM
181. nctions called IBRD and IBWRT are far less limited in data block size IBTMO can be used to change the timeout value during program execution The default value of the GPIB driver is 10 seconds for example if the oscilloscope does not respond to an IBRD call IBRD will return with an error after the specified time IBTRG executes the IEEE 488 1 standard message Group Execute Trigger GET which causes the X Stream DSO to arm the trigger system National Instruments supplies a number of additional function calls In particular it is possible to use the so called board level calls which allow a very detailed control of the GPIB NOTE The SRQ bit is latched until the controller reads the STatus Byte Register STB The action of reading the STB with the command STB clears the register contents except the MAV bit bit 4 until a new event occurs Service requesting can be disabled by clearing the SRE register with the SRE 0 command WM RCM E Rev D ISSUED February 2005 21 PART ONE ABOUT REMOTE CONTROL MAKE SERVICE REQUESTS When X Stream DSO is used in a remote application events often occur asynchronously i e at times that are unpredictable for the host computer The most common example of this is a trigger wait after the oscilloscope is armed the controller must wait until the acquisition is finished before it can read the acquired waveform The simplest way of checking if a certain event has occurred is by either c
182. ndowstop gt HIST lt source gt lt values gt lt bins gt lt horscale gt lt center gt lt verscaletype gt lt autofindscale gt HISTD lt source gt lt verscaletype gt HSUM lt source gt lt verscaletype gt 128 ISSUED February 2005 Smoothing function defined by 0 5 1 0 1 5 2 0 2 5 or 3 0 extra bits of resolution Perform math in Excel lt scaling gt AUTOMATIC MANUAL FROMSHEET Exponential power of Exponential power of 10 Extrema Roof and Floor of waveform Fast Fourier transform of waveform Available values are as follows lt type gt REAL IMAGINARY MAGNITUDE PHASE POWERSPECTRUM POWERDENSITY lt window gt BLACKMANHARRIS FLATTOP HAMMING RECTANGULAR VONHANN lt algorithm gt LEASTPRIME POWER2 lt filltype gt TRUNCATE ZEROFILL Digital filter Finite impulse response filter Lowest vertical value at each X value in N sweeps Histogram of parameter values VERSCALETYPE can be LINEAR or LINCONSTMAX Histogram of data Sum of a sequence of histograms WM RCM E Rev D IFFT lt source gt INTG lt source gt lt multiplier gt lt adder gt lt verscale gt lt ve roffset gt INTRP lt source gt lt interpolatetype gt lt expand gt lt source gt INVERT JITTERSIM LN Ksource gt LOG10 lt source gt LPFIR MCAD lt soutce1 gt lt source2 gt lt sourcel vat gt lt source2 vat gt lt outputvar gt lt sourcelheadervar gt lt s
183. ng or Float lt MSB gt lt byte2 gt lt byte3 gt lt LSB gt lt LSB gt lt byte3 gt lt byte2 gt lt MSB gt Double lt MSB gt lt byte2 gt lt byte7 gt lt LSB gt lt LSB gt lt byte7 gt lt byte2 gt lt MSB gt RELATED COMMANDS WAVEFORM 112 ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB WM RCM E Rev D Remote Control Commands and Queties COUPLING CPL Command Query The COUPLING command selects the coupling mode of the specified input channel The COUPLING query returns the coupling mode of the specified channel lt channel gt CouPLing lt coupling gt lt channel gt C1 C2 C3 C4 EX EX10 ETM10 coupling A1M D1M D50 GND lt channel gt CouPLing channel CouPLing lt coupling gt coupling A1M D1M D50 GND OVL coupling OVL is returned in the event of signal overload while in DC 50 coupling In this condition the oscilloscope will disconnect the input lt channel gt C3 C4 only on four channel instruments attenuation pertains only to instruments with a probe connected The following instruction sets the coupling of Channel 2 to 50 DC CMD C2 CPL D50 CALL IBWRT SCOPE CMDS ISSUED February 2005 113 PART Two COMMANDS CURSOR CURSOR_MEASURE CRMS Command Query DESCRIPTION The CURSOR_MEASURE command
184. ng speed in multiple device configurations In the following example the command INE 1 enables the event new signal acquired to be reported in the INR to the INB bit of the status byte STB The command SRE 1 enables the INB of the status byte to generate an SRQ whenever it is set The function call IBWAIT instructs the computer to wait until one of three conditions occurs amp H8000 in the mask MASK corresponds to a GPIB error amp H4000 to a timeout error and amp H0800 to the detection of RQS ReQuest for Service generated by the SRQ bit Whenever IBWAIT detects RQS it automatically performs a serial poll to find out which oscilloscope generated the interrupt It will only exit if there was a timeout or if the oscilloscope 5 generated SRQ The additional function call IBRSP fetches the value of the status byte which may be further interpreted For this to work properly the value of Disable Auto Serial Polling must be set to off in the GPIB handler use IBCONF EXE to check CMDS CLS INE 1 SRE 1 CALL IBWRT SCOPE CMDS MASK amp HC800 CALL IBWAIT SCOPE MASKS IF 5 AND amp 000 lt gt 0 THEN PRINT GPIB or Timeout Error STOP CALL IBRSP SCOPE SPR PRINT Status Byte SPR Board level function calls can deal simultaneously with several oscilloscopes attached to the same interface boatd Refer to the National Instruments manual NOTE After the serial pol
185. nly Byte Swapping The COMM ORDER command allows you to swap two bytes of data presented in 16 bit word format in the descriptor or in the data time arrays when sending the data via GPIB or LAN ports Depending on the computer system used this will allow easier data interpretation For Intel based computers you should send the data with the LSB first the command should be CORD LO For Motorola based computers send the data with the MSB first CORD the default at power up NOTE Data written to the instrument s hard disk or floppy will always remain in the format LSB first the default DOS format Thus you cannot use the CORD command in these cases as it is only for data sent via the GPIB and LAN ports Data Length Block Format and Encoding COMM_FORMAT gives you control over these parameters If you do not need the extra precision of the lower order byte of the standard data value the BYTE option will enable you to save by a factor of two the amount of data transferred or stored If the computer you are using cannot read binary data the HEX option allows a response form in which the value of each byte is given by a pair of hexadecimal digits Data Only Transfers COMM_HEADER OFF enables a response to WF DAT1 with data only the C1 WF DAT1 will disappear If you have also specified COMM FORMAT OFEBYTE BIN the response will be data bytes only the 90000nnnnn will disappear see page 55 60 ISSUED February 2005 W
186. nt are given in their normal order and the segments are read out one after the other The important descriptor parameters are the WAVE ARRAY COUNT and the SUBARRAY COUNT giving the total number of points and the number of segments For waveforms such as the extrema and the complex FFT there will be two arrays one after the other for the two of the result WM RCM E Rev D ISSUED February 2005 57 PART ONE ABOUT REMOTE CONTROL CALCULATE A DATA POINT S HORIZONTAL POSITION Each vertical data value has a corresponding horizontal position usually measured in time or frequency units The calculation of this position depends on the type of waveform Each data value has a position i in the original waveform with i 0 corresponding to the first data point acquired The descriptor parameter HORUNIT gives a string with the name of the horizontal unit Single Sweep waveforms HORIZ INTERVAL x i HORIZ OFFSET For acquisition waveforms this time is from the trigger to the data point in question It will be different from acquisition to acquisition since the HORIZ_OFFSET is measured for each trigger In the case of the data shown above this means HORIZ_INTERVAL 1 08 from the floating point number 322b 77 at Byte 194 HORIZ_OFFSET 5 149e 08 from the double precision floating point number be6b a4bb 51a0 69bb at Byte 198 HORUNIT S seconds from the string 5300 at Byte 262 This gives 0 5 149
187. nt parameter specifies the address of the first data point to be sent For waveforms acquired in sequence mode this refers to the relative address in the given segment For example FP 0 corresponds to the first data point FP 1 corresponds to the second data point FP 5000 corresponds to data point 5001 ISSUED February 2005 25 7 PART Two COMMANDS Segment number SN COMMAND SYNTAX The segment number parameter indicates which segment should be sent if the waveform was acquired in sequence mode This parameter is ignored for non segmented waveforms For example SN 0 all segments SN 1 first segment SN 23 segment 23 The WAVEFORM SETUP query returns the transfer parameters currently in use WaveForm SetUp SP lt sparsing gt NP number FP lt point gt SN lt segment gt NOTE After power on all values are set to 0 i e entire waveforms will be transmitted without sparsing Parameters are grouped in pairs The first of the pair names the variable to be modified while the second gives the new value to be assigned Pairs can be given in any order and restricted to those variables to be changed QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 258 WaveForm SetUp WaveForm SetUp SP lt sparsing gt NP lt number gt FP lt point gt SN segment The following instructs every 3rd data point SP 3 starting at address 200 to be transferred
188. nts of the ESR register CMDS ESR CALL IBWRT SCOPES CMD CALL IBRD SCOPE RSP PRINT RSPS Response message ESR 0 ALL STATUS CLS ESE ISSUED February 2005 1 4 1 PART Two COMMANDS ADDITIONAL INFORMATION STANDARD EVENT STATUS REGISTER ESR See Note fo J reserved by EE a882 0000000 8 1 Device Dependent specific Error occurred os qve 1 Query Error occurred _______ ce puesta teen 0 OPeration Complete bit not used NOTES refer to table above 1 The Power PON bit is always turned on 1 when the unit is powered up 2 On older LeCroy scopes this bit reports softkey inputs It does not apply to X Stream scopes 3 The CoMmand parser Error bit CME is set true 1 whenever a command syntax error is detected The CME bit has an associated CoMmand parser Register CMR which specifies the error code Refer to the query CMR for further details The EXecution Error bit EXE is set true 1 when a command cannot be executed due to some device condition e g oscilloscope in local state or a semantic error The EXE bit has an associated Execution Error Register EXR that specifies the error code Refer to query EXR for further details 5 The Device specific Error DDE is set true 1 whenever a hardware failure has occurred at power up at execution time such as a channel overload condition or a trigger or timebase citcuit
189. o be performed by the oscilloscope Most command and query headers have a long form which allows them to be read more easily by people and a short form for better transfer and decoding speed The two are fully equivalent and you can use them interchangeably For example TRIG_MODE AUTO and TRMD AUTO are two separate but equivalent commands for switching to the automatic trigger mode Some command or query mnemonics are imposed by the IEEE 488 2 standard They are standardized so that different oscilloscopes will present the same programming interface for similar functions All these mnemonics begin with an asterisk For example the command RST is the IEEE 488 2 imposed mnemonic for resetting the oscilloscope whereas TST instructs the oscilloscope to perform an internal self test and report the outcome HEADER PATHS Certain commands or queries apply to a subsection of the oscilloscope for example a single input channel or a trace on the display In such cases you must prefix the header by a path name that indicates the channel or trace to which the command applies The header path normally consists of a two letter path name followed by a colon immediately preceding the command header One of the waveform traces can usually be specified in the header path Header Path Name Waveform Trace C1 C2 Channels 1 and 2 C3 C4 Channels 3 and 4 on four channel models M1 M2 M3 M4 Memories 1 2 and 3 and 4 Traces 1 through F8 F1
190. ols can be used in two fundamental ways e As a visible object embedded in an OLE automation compatible client PowerPoint for example showing a captured X Stream DSO display image See the Embedded Control example below for more details WM RCM E Rev D ISSUED February 2005 273 APPENDIX I Program Examples e Asan invisible object accessed through a scripting language VBA for example to remotely control the X Stream DSO See the VBA example below for more details The ActiveDSO control may be embedded in any ActiveX containment capable client and may be used manually without need of any programming or scripting EXAMPLE USING POWERPOINT 97 This example shows the control being embedded in a Microsoft PowerPoint slide The waveform captured by the X Stream DSO can be easily imported into PowerPoint with just a few mouse clicks 1 Ensure that the ActiveDSO files are installed on the PC 2 Verify that the PC and X Stream DSO are properly connected to the Ethernet 3 Opena new blank presentation in PowerPoint 4 Select Insert then Object Microsoft PowerPoint Presentation Tools SideShow Window Help AdobePOF Type aquestonforhelp X A add subtitle Dew R ators CIO BI EL M EU amp Z A HOm Sidetof1 Default Design Engish U S 27 4 ISSUED February 2005 WM RCM E Rev D GPIB Program Examples 5 From the pop up window select LeCroy ActiveDSO Control object
191. on in query mode to determine whether it is available in your oscilloscope and to determine the current form of the command in your model The response to any query can be copied straight into a program and used as a command Functions can also be defined using the VBS command see Chapter 6 Underlined names in the left column of this table represent Boolean expressions which take the values ON and OFF lt sourcel gt lt source2 gt DIFFERENCE Difference of two waveforms lt source gt INVERSION Inversion negation of waveform lt sourcel gt lt source2 gt PRODUCT Product of two waveforms lt sourcel gt lt source2 gt RATIO Ratio of two waveforms 1 lt source gt RECIPROCAL Reciprocal of a waveform lt source1 gt lt source2 gt SUM Sum of two waveforms ABS lt source gt Absolute Value AVG lt source gt lt averagetype gt lt sweeps gt lt sumhelptex AVERAGETYPE is SUMMED or CONTINUOUS t gt lt continuoushelptext gt BOXCAR lt source gt lt length gt Boxcar average with specified filter length CORR Ksource1 gt lt source2 gt lt corrlength gt lt corrstart Correlation of two waveforms with specified correlation gt length and start point DERI lt source gt lt verscale gt lt veroftset gt lt enableautosc Derivative of waveform using subtraction of adjacent ale gt samples lt soutcel gt lt source2 gt DIFFERENCE Difference between two waveforms DESKEW lt source gt lt wavedeskew gt
192. on prevents the associated event from generating a service request SRQ Clearing the SRE register disables SRQ interrupts The SRE query returns a value that when converted to a binary number represents the bit settings of the SRE register Note that bit 6 MSS cannot be set and its returned value is always zero SRE lt value gt value 0 to 255 SRE SRE lt value gt The following instruction allows an SRQ to be generated as soon as the MAV summary bit bit 4 i e decimal 16 or the INB summary bit bit 0 i e decimal 1 in the STB register or both are set Summing these two values yields the SRE mask 16 1 17 CMDS SRE 17 CALL IBWRT SCOPE CMDS ISSUED February 2005 223 PART Two COMMANDS STATUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 224 STB Query The STB query reads the contents of the 488 1 defined STatus Byte register STB and the Master Summary Status MSS The response represents the values of bits 0 to 5 and 7 of the STB register and the MSS summary message The response to a STB query is identical to the response of a serial poll except that the MSS summary message appears in bit 6 in place of the RQS message Refer to the table on page 225 for further details of the status register structure STB STB value value 0 to 255 The following instruction reads the status byte register CMDS STB
193. ontinuously or periodically reading the status bit associated with it until the required transition is detected Continuous status bit polling is described in more detail below For a complete explanation of status bits refer to Chapter 5 Perhaps a efficient way of detecting events occurring in the oscilloscope is the use of the Service ReQuest SRQ This GPIB interrupt line can be used to interrupt program execution in the controller The controller can then execute other programs while waiting for the oscilloscope Unfortunately not all interface manufacturers support the programming of interrupt service routines In particular National Instruments supports only the SRQ bit within the ISTA status word This requires you to continuously or periodically check this word either explicitly or with the function call IBWAIT In the absence of real interrupt service routines the use of SRQ may not be very advantageous In the default state after power on the Service ReQuest is disabled You enable SRQ by setting the Service Request Enable register with the command SRE and by specifying which event should generate SRQ The X Stream DSO will interrupt the controller as soon as the selected event s occur by asserting the SRQ interface line If several devices are connected to the GPIB you may be required to identify which oscilloscope caused the interrupt by serial polling the various devices Example To assert SRQ in response
194. optional time array is only present with SEQNCE waveforms The following data block is repeated for each segment which makes up the acquired sequence record Nome 454545 0 gt TRIGGER TIME double for sequence acquisitions time in seconds from first trigger to this one c 8 gt TRIGGER_OFFSET double the trigger offset is in seconds from trigger to zeroth data point 00 ENDARRAY ISTIME ARRAY Explanation of the random interleaved sampling RIS time array RISTIME This optional time array is only present with RIS waveforms This data block is repeated for each sweep which makes up the RIS record 288 ISSUED February 2005 WM RCM E Rev D Waveform Template lt 0 gt RIS OFFSET double Seconds from trigger to zeroth point of segment 00 ENDARRAY DATA ARRAY 1 ARRAY Explanation of the data array DATA ARRAY 1 This main data array is always present It is the only data array for most waveforms The data item is repeated for each acquired or computed data point of the first data array of any waveform AS 9 o9 o9 0 MEASUREMENT data the actual format of a data is given in the WAVEDESC descriptor by the COMM TYPE variable 00 ENDARRAY DATA ARRAY 2 ARRAY Explanation of the data array DATA ARRAY 2 This is an optional secondary data array for special types of waveforms Complex FFT imaginary part real part in DATA ARRAY 1 Extrema floor trace roof trace
195. oscope and the host computer 1 Connect the oscilloscope to the PC using a crossover cable for direct connection 2 Power the oscilloscope unit on Note Jf your PC does not have TCIP IB see your computer s User s Manual for installation instructions Note Jf you are making connection using the VCIP protocol use this syntax VICP scope s IP address gt For example VICP 172 28 15 16 Verifying Connection The physical connection and the PC s TCP IP configuration can be verified using the ping command available on both Windows 95 and Windows NT with TCP IP network protocol installed In order to check the network connection between the PC and the oscilloscope 1 Start MS DOS Prompt 2 ping ip address where ip address is the static address assigned to the oscilloscope The Command Prompt window on the next page illustrates the result of a successful ping with the Ethernet connection shown established The ping command has sent a message to the instrument and waited for a response If a timeout occurs the IP address used for the destination the oscilloscope is incorrect ot not within the subnet mask of the PC s IP 38 ISSUED February 2005 WM RCM E Rev D CHAPTER THREE Controlby LAN C gt ping 172 28 15 75 Pinging 172 28 15 75 with 32 bytes of data Reply from 172 28 15 75 bytes 32 time 16ms TTL 128 Reply from 172 28 15 75 bytes 32 time lt i ms TTL 128 Reply from 172 28 15 75 bytes
196. ote Control Assistant can log all message transactions occurring between the external controller and the oscilloscope full dialog or errors only You can view the log at any time on screen and can choose from three levels OFF Don t assist at all EO Log detected Errors Only default after power on Log the Full Dialog between the controller and the oscilloscope Comm HeLP lt level gt lt reset at power on level OFF EO FD reset at power on NO YES The default level is EO If reset at power on gt is set to YES default at power on the logging level is set to EO and the log is cleared If set to NO the uset set logging level is preserved and the log is not cleared Note Setting CHLP EO NO is useful in logging command sequences that include rebooting the oscilloscope Comm HeLP Comm HeLP lt level gt lt reset at power on After sending this command all the following commands and responses will be logged CMDS CHLP FD CALL IBWRT SCOPES CMD COMM HELP LOG ISSUED February 2005 WM RCM E Rev D COMMUNICATION DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties COMM_HELP_LOG CHL Query The COMM HELP LOG quety returns the current contents of the log generated by the Remote Control Assistant see CHLP desctiption If the optional parameter CLR is specified the lo
197. ou may find that a few GPIB commands used for the earlier scopes do not work on X Stream scopes The solution is to use the new Automation commands which are described in Chapter 6 It is easy to integrate these commands into a GPIB program using the command VBS But you should find that for the most frequently used commands and queties existing scopes and X Stream scopes are compatible apart from a few details ANSI IEEE Std 488 2 1987 IEEE Standard Codes Formats Protocols and Common Commands The Institute of Electrical and Electronics Engineers Inc 345 East 47th Street New York NY 10017 USA WM RCM E Rev D ISSUED February 2005 5 PART ONE ABOUT REMOTE CONTROL PROGRAM MESSAGES You control the oscilloscope remotely using program messages that consist of one or more commands or queries The program messages you send from the external controller to the X Stream oscilloscope must conform to precise format structures The oscilloscope will execute all program messages sent in the correct form but will ignore those with errors You can use uppercase or lowercase characters or both in program messages the scope does not distinguish between them But the MESSAGE command can faithfully transmit strings containing both lowercase and uppercase letters Warning or error messages are normally not reported unless the controller explicitly examines the relevant status register or if the status enable registers have been set
198. ource2headervar gt lt outputheadervar gt lt withheader gt MATLAB lt soutce1 gt lt source2 gt lt matlabcode gt lt matl abplot gt lt matlabzerooffset gt lt matlabscaleperdiv gt PERHIST lt source gt lt vercutcenter gt lt vercutwidth gt lt h orcutcenter gt lt horcutwidth gt lt cutdirection gt lt cuttype gt lt cutwidth gt PMEAN lt soutce gt PRANGE lt source gt lt pctpopulation gt PSIGMA lt source gt lt sigma gt PHSHIFT lt source gt lt phase gt DESKEW lt source gt lt wavedeskew gt RESAMPLE RESC lt source gt lt multiplier gt lt adder gt lt customunit gt lt unit gt ROOF lt soutce gt lt sweeps gt SEG lt source gt lt selectedsegment gt SINX lt source gt SLICE lt source1 gt lt source2 gt lt frequency gt lt priorperio ds gt lt postperiods gt lt parameter gt WM RCM E Rev D ISSUED February 2005 Remote Control Commands and Queries Inverse FFT real output from complex input lt gt INVERT Inversion negation of waveform Interpolate extra points in waveform INTERPOLATETYPE IS LINEAR QUADRATIC OR SINXX Inversion negation of waveform Natural logarithm of waveform values Base 10 logarithm of waveform values Produces a waveform using Mathcad Produces a waveform using MATLAB Histogram of a slice through a persistence map Waveform derived from the mean of a persistence map Waveform derived from the ran
199. owing instruction sets to 100 the attenuation factor of Channel 1 CMD C1 ATTN 100 CALL IBWRT SCOPE CMDS ISSUED February 2005 93 PART Two COMMANDS MISCELLANEOUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 94 AUTO_CALIBRATE ACAL Command Query The AUTO_CALIBRATE command is used to enable or disable the automatic calibration of your X Stream oscilloscope At power up auto calibration is turned ON i e all input channels are periodically calibrated for the current input amplifier and timebase settings whether the instrument has been adjusted or not Whenever you adjust a gain or offset however the instrument will perform a calibration This action occurs whatever the current state of ACAL and it does not change the state of ACAL Automatic calibration can be disabled by means of the command ACAL OFE But whenever convenient you can issue a CAL query to fully calibrate the oscilloscope When the oscilloscope is returned to local control periodic calibrations are resumed if the last ACAL value was ON That is the command CAL has no effect on the ACAL status The response to the AUTO_CALIBRATE query indicates whether auto calibration is enabled or disabled Auto_CALibrate lt state gt state OFF Auto_CALibrate Auto_CALibrate lt state gt The following instruction disables auto calibration CMDS ACAL OFF CALL I
200. p as follows 292 ISSUED February 2005 WM RCM E Rev D Waveform Template 0 01101001 00000110001001001101111 The first bit 0 makes the sign of the number S using the formula S 1 1 The next eight bits make the exponent e as follows 0 128 1 64 1 32 0 16 1 8 0 4 0 2 1 1 105 from which we subtract 127 giving 22 So the factor is 2 127 2 22 which is 2 3842E 7 Finally we need to make the multiplier F The remaining bits are given the values 0 5 0 25 0 125 0 0625 0 03125 etc The first bits that are not zero are the 6th and 7th bits whose values are 0 015625 and 0 078125 respectively To get a rough value we will take just these two bits since the next three are zero giving 0 0234375 We have to add 1 to this giving 1 023 as a rough value for F The final result is therefore S x E x F 1 X 2 3842E 7 X 1 023 2 439 which is a little smaller than the correct value because we did not use all the bits to calculate the value of F Double precision values are held in eight bytes If these are arranged in decreasing order of value we get the following bits 63 62 61 62 3 2 1 0 We must remember that if the byte order command CORD has been set for low byte first the bytes as received in a waveform desctiptor will be received in the reverse order But within a byte the bits keep their otder highest at the left as expected From these bits we are to construct three numbers that a
201. param name while the second one gives the new value to be assigned Pairs can be given in any order and restricted to the variables to be changed Space blank characters ins de equations are optional QUERY SYNTAX function DEFine RESPONSE FORMAT function DEFine EQN lt equation gt MAXPTS max points SWEEPS max sweeps WEIGHT lt weight gt BITS bits P FUNCTION PARAMETERS lt param_name gt lt value gt Description BITS lt bits gt Number of ERES bits CENTER lt center gt Horizontal center position for histogram display lt equation gt Function equation as defined below LENGTH lt length gt Number of points to use from first waveform MAX_EVENTS lt max_values gt Maximum number of values in histogram MAXBINS lt bins gt Number of bins in histogram START lt start gt Starting point in second waveform 126 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties SWEEPS lt max_sweeps gt Maximum number of sweeps UNITS lt units gt Physical units VERT lt vert_scale gt Vertical scaling type WEIGHT lt weight gt Continuous Average weight WIDTH lt width gt Width of histogram display WINDOW lt window_type gt FFT window function FUNCTION EQUATIONS AND NAMES NOTES These functions are available according to the options installed in your X Stream oscilloscope It can be very useful to run a functi
202. pecified and captured in sequence mode WM RCM E Rev D ISSUED February 2005 27 PART ONE ABOUT REMOTE CONTROL STATUS REGISTERS Status registers store a record of events and conditions that occur inside the DSO Some of the events recorded are New data has been acquired Processing has completed Hardcopy has completed An error has occurred etc The programmer can use the registers to sense the condition of the instrument by polling them until the desired status bit has been set A status register can be polled by querying its associated remote command e g STB INR ESR etc Alternatively with GPIB the scope can request service from the controller by using the mask registers to select the events of interest The following diagram Figure 1 shows the steps necessary to acquire data using the status registers for synchronization Stop the acquisition STOP Setup the scope Clear the status registers and setup masks if needed Start the acquisition ARM or TRMD SINGLE Poll the status registers or wait for Service Request Read data cursors and parameter measurements Figure 1 28 ISSUED February 2005 WM RCM E Rev D CHAPTER TWO Control by GPIB If the data have already been acquired and you want to do further analysis math parameters cursors on it you can proceed as shown in Figure 2 Clear the status registers and setup masks if needed change the analysis setup Poll the statu
203. pectrum being spread across the entire depth of the persistence data map At lower values the spectrum will saturate brightest value at the specified percentage value The unit PCT is optional The response to the SAT query indicates the saturation level of the persistence data maps PErsist SAt trace value ttace lt value gt trace C1 C2 C3 C4 F1 F2 F3 F4 F5 F6 F7 F8 TA TB TC TDJ T through TD are for compatibility with existing software with earlier instruments These four mnemonics are not returned by queties value 0 to 100 PCT Note The unit PCT is optional PErsist_SAt PErsist SAt trace value The following instruction sets the saturation level of the persistence data map for channel 3 to be 60 that is 60 of the data points will be displayed with the color spectrum with the remaining 40 saturated in the brightest color CMDS PESA C3 60 CALL IBWRT SCOPE CMDS PERSIST PERSIST COLOR PERSIST PERS PERSIST SETUP ISSUED February 2005 21 1 PART Two COMMANDS DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 212 PERSIST SETUP PESU Command Query The PERSIST SETUP command selects the persistence duration of the display in seconds in persistence mode In addition the persistence can be set either to all traces or only the top two on the screen Th
204. pet ec nei ttl deed teet 9 STRINGDATA coetu e Pete e i e tse e P Pers Ud 10 BEOGK DATA eet ete e vec tede 10 RESPONSE MESSAGES arinrin E neam ette 10 CHAPTER TWO CONTROL BY GPIB seen eene nennen 12 Talk Listen OF Control uie 13 INTERFACE 2 53 tede eec ett esee o tetti ee etu 14 ADDRESS etatis See buses coe Lu t Le 14 GPBIB SIGNAES tefte 15 O BUFEBERS acutae de da sham Me asin ak 16 USE IEEE 488 1 STANDARD 16 DEVICE CLEAR 17 GROUP EXECUTE 0400000000081 17 REMOTE ENABLE 5 45 eet or 17 INTERFACE GLEA 2 0 ettet lae etae Iva ens Tate 17 CONFIGURE THE GPIB DRIVER 2 nrnn nnne nnnas 17 MAKE SIMPLE TRANSFERS 19 USE ADDITIONAL DRIVER 21 MAKE SERVICE REQUESTS 0 2024000 0010000000 1 22 Take Instrument Polls rer
205. plain this Variables ending with are integers and variables ending with are strings in accordance with the practice in some BASIC languages The entire system is of course compatible with any hardware and software based on IEEE 488 2 and any programming language can be used if it can be linked to GPIB WM RCM E Rev D ISSUED February 2005 13 PART ONE ABOUT REMOTE CONTROL INTERFACE X Stream DSO interface capabilities include the following IEEE 488 1 definitions Complete Acceptor Handshake Complete Device Clear Function Complete Source Handshake Complete Device Trigger Partial Listener Function Parallel Polling remote configurable Complete Talker Function No Controller Functions Complete Service Request Function Tri state Drivers Complete Remote Local Function ADDRESS Every device on the GPIB has an address To address the X Stream DSO set the remote control port to GPIB by means of the scope s front panel UTILITIES button and on screen menus If you address the X Stream DSO to talk it will remain in that state until it receives a universal untalk command UNT its own listen address MLA or another oscilloscope s talk address If you address the X Stream DSO to listen it will remain configured to listen until a universal unlisten command UNL or its own talker address MTA is received To avoid conflicts use the general Unlisten and Untalk commands before setting up the talker and listener states T
206. prietary programs you can do so within the chain of operations of the oscilloscope without having to go outside the X Stream software to instantiate the proprietary software Here we offer a simple introduction SOME DETAILS Here is the start of a typical instrument setup file You don t necessarily have to know about this to use the instrument but any setup file is a convenient source of examples to illustrate the workings of Automation in the instrument WaveMaster ConfigurationVBScript On Error Resume Next set WaveMaster CreateObject LeCroy WaveMasterApplication AladdinPersona WaveMaster HideClock False WaveMaster TouchScreenEnable True Set Display WaveMaster Display Display GridIntensity 70 Display GridOnTop False Display AxisLabels False Display NumSegmentsDisplayed 1 Display StartSegment 1 Acquisition Horizontal and Trigger Display Display GridMode Dual The scope variables are Display TraceStyle Line in groups such as Display The dot notation is well known in object oriented Display SegmentMode Adjacent programming It makes Display ScreenSaveEnable True hierarchies easy to create Display ScreenSaveTimeout 60 Properties can be handed down Display LockPersistence AllLocked through a hierarchy Display PersistenceStyle ColorGraded Display Persisted False Display PersistenceMonoChrome True Display Persistence3d False Display Persist3DQu
207. program and interface messages Most of the messages use the 7 bit ASCII code in which case DIOS is unused Handshake Lines These three lines control the transfer of message bytes between devices The process is called a three wire interlocked handshake and it guarantees that the message bytes on the data lines are sent and received without transmission error Interface Management Lines These five lines manage the flow of information across the interface ATteNtion The controller drives the line true when it uses the data lines to send interface messages such as talk and listen addresses or a device clear DCL message When ATN is false the bus is in data mode for the transfer of program messages from talkers to listeners InterFace Clear The controller sets the IFC line true to initialize the bus e REN Remote ENable The controller uses this line to place devices in remote or local program mode SRQ Service ReQuest Any device can drive the SRQ line true to asynchronously request service from the controller This is the equivalent of a single interrupt line on a computer bus WM RCM E Rev D ISSUED February 2005 15 PART ONE ABOUT REMOTE CONTROL e EOI End Or Identify This line has two purposes The talker uses it to mark the end of a message string The controller uses it to tell devices to identify their response in a parallel poll discussed later in this section BUFFERS The o
208. quivalent of the 488 1 GET Group Execute Trigger message COMMAND SYNTAX TRG EXAMPLE GPIB The following instruction enables signal acquisition CMD TRG CALL IBWRT SCOPE CMDS RELATED COMMANDS ARM ACQUISITION STOP WAIT FORCE TRIGGER 236 ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT AVAILABILITY EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties TRIG COUPLING Command Query The TRIG_COUPLING command sets the coupling mode of the specified trigger source The TRIG_COUPLING query returns the trigger coupling of the selected source trig source TRig_CouPling lt trig_coupling gt trig source C1 C2 C3 C4 EX10 ETM10 trig coupling DC for channel source DC50 GND DC1M for external source trig source TRig_CouPling trig source TRig_CouPling trig coupling trig source C3 C4 only on four channel instruments The following instruction sets the coupling mode of the trigger soutce Channel 2 to AC CMDS C2 TRCP AC CALL IBWRT SCOPE CMD TRIG COUPLING TRIG DELAY TRIG LEVEL TRIG MODE TRIG SELECT TRIG SLOPE ISSUED February 2005 237 PART Two COMMANDS ACQUISITION TRIG DELAY TRDL Command Query DESCRIPTION The TRIG_DELAY command sets the time a
209. r strings and are thus limited to a maximum of 255 characters INCLUDE This line is symbolic of the National Instruments routines which allow your language to communicate with GPIB Please see your NI manual for information CLS PRINT Control of the 9300 via GPIB and IBM PC PRINT PRINT Options EX to exit LC local mode PRINT ST store data RC recall data PRINT LINE INPUT GPIB address of oscilloscope 1 16 ADDR DEVS DEV ADDRS Construct DSO address CALL IBFIND DEVS SCOPE IF SCOPE lt 0 THEN PRINT IBFIND ERROR END Cannot find DSO 10 Timeout 300 msec rather than default 10 sec CALL 5 LOOP 1 WHILE LOOP LINE INPUT Enter command EX gt Exit CMD Select Case CMDS Case ex LOOP 0 GOSUB LocalMode END Case st ST GOSUB StoreData GOTO LoopEnd Case rc RC GOSUB RecallData GOTO LoopEnd Case 1 LC GOSUB LocalMode GOTO LoopEnd Case GOTO LoopEnd End Select WM RCM E Rev D ISSUED February 2005 261 APPENDIX I Program Examples CALL IBWRT SCOPE CMDS IF 5 lt 0 THEN GOSUB GPIBError END GOSUB GetData LoopEnd WEND LocalMode Y Put DSO into Local Mode CALL IBLOC SCOPE PRINT RETURN GetData Get data from DSO If there are no data to read simply wait until timeout occurs CALL IBRD SCOPE RDS is the number of
210. r mnemonics will not be returned in response to queries factor 1 to 20000 lt source Hor MAGnify Xexp source Hor MAGnify factor The following instruction horizontally magnifies Trace A TA by a factor of 5 CMDS F1 HMAG 5 CALL IBWRT SCOPE CMD ISSUED February 2005 153 PART Two COMMANDS DISPLAY DESCRIPTION COMMAND SYNTAX 154 HOR_POSITION HPOS Command Query The POSITION command horizontally positions the geometric center of the intensified zone on the source trace Allowed positions range from division 0 through 10 If the source trace was acquired in sequence mode horizontal shifting will only apply to a single segment at a time If the multiple zoom is enabled the difference between the specified and the current horizontal position of the specified trace is applied to all expanded traces If this would cause the horizontal position of any expanded trace to go outside the left or right screen boundaries the difference of positions is adapted and then applied to the traces If the sources of expanded traces are sequence waveforms and the multiple zoom is enabled the difference between the specified and the current segment of the specified trace is applied to all expanded traces If this would cause the segment of any expanded trace to go outside the range of the number of source segments the difference is adapted and then applied to the traces The VAB bit b
211. re to be multiplied together S x E x F These in turn are constructed as follows S 1 E 26 1023 F 1 f and it is s e and f that are calculated directly from the 32 bits The following diagram illustrates the calculation of an example WM RCM E Rev D ISSUED February 2005 293 APPENDIX II Waveform Template 11111110 11011100 10111010 10011000 01110110 01010100 00110010 00010000 76543210 76543210 76543210 76543210 76543210 76543210 76543210 76543210 111111101101110010111010100110000111011001010100001100100001 0000 1 11111101101 1100101110101001100001110110010101000011001000010000 1 2029 1023 0 795555555555556 1 0 ape 1 79555555555556 1 23133006877369E 303 Final decoded result In a way that does not follow the byte boundaries the bits are to be segregated as follows 63 62 61 53 52 51 50 2 1 0 sign 11 exponent bits 52 fractional bits bit 0 5 0 25 0 125 The sign bit is 1 for a negative number and 0 for a positive number so it is easy to construct the sign from this S 1 s The 11 exponent bits have the following values 52 gt 1 53 gt 2 61 gt 512 62 gt 1024 so the resulting number can range from 0 to 2 12 1 which is 2047 1023 is then subtracted from this value creating a range from 1023 to 1024 This is then used as a power of two to create a value E 294 ISSUED February 2005 WM RCM E Rev D Waveform Template Then we have to create the multiplying number The values of the 52 b
212. rent trigger condition Dropout Edge Glitch Hold value Second hold value Interval larger than TRIGGER NOTATION No hold off on wait Greater Than y E 5 Pulse larger than m Pulse smaller than Pulse width Out Of Range OL SNG 10 State Qualified Source ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries INTV Interval Interval smaller than Interval width Out Of Range Edge Qualified a Time greater than Time within TRig_SElect lt trig_type gt SR lt source gt OL lt source gt HT lt hold_type gt HV lt hold_value gt HV2 lt hold value gt Is COMMAND SYNTAX lt trig_type gt DROP EDGE GLIT INTV STD SNG SQ TEQ lt source gt 1 C2 C3 C4 LINE EX EX10 PA ETM10 lt hold_type gt TI TL EV PS PL IS IL P2 I2 OFF hold value See specifications in the Operators Manual for valid values NOTE The unit S seconds is optional QUERY SYNTAX TRig SElect TRig SElect trig type SR lt source gt HT hold type HV RESPONSE FORMAT hold salue held value gt HV2only returned if hold type is P2 or I2 WM RCM E Rev D ISSUED February 2005 245 PART Two COMMANDS AVAILABILITY lt source gt C3 C4 only available on four channel instruments EXAMPLE GPIB The following instruction
213. rm parts to be read Stores a trace in one of the internal memories M1 4 or mass storage Sets up waveform storage FORM ESR INE INR ist SRE _ STB WAI INSP STO _STsT LTMPL Produces a copy of the template describing a complete waveform TRANSFER_FILE Transfers ASCII files to and from storage media or between scope and computer Transfers a waveform from the controller to the oscilloscope WAVEFORM_SETUP Specifies amount of waveform data for transmission to controller 90 ISSUED February 2005 WM RCM E Rev D STATUS DESCRIPTION QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties ALL_STATUS ALST Query The ALL_STATUS query reads and clears the contents of all status registers STB ESR INR DDR CMR EXR and URR except for the MAV bit bit 6 of the STB register For an interpretation of the contents of each register refer to the appropriate status register The query is useful to obtain a complete overview of the state of yout oscilloscope 11 STatus ALl STatus STB value ESR lt value gt INR value DDR lt value gt CMR value EXR value value value 0 to 65535 The following instruction reads the contents of all the status registers CMDS ALST CALL IBWRT
214. s The keyword ALL should NOT be used neither should multiple keywords If they are used the word UNDEF will be returned For the CRVA query to work the specified trace MUST be visible and the current cursor mode must be the same as in the query If it is not the same UNDEF will be returned NOTATION HABS horizontal absolute HREL horizontal relative trace CuRsor_VAlue mode trace F1 F2 F4 F5 F6 F7 F8 TA TB TC TD C1 C2 C3 C4 TA through TD are for compatibility with existing software with earlier instruments These four mnemonics are not returned by queries mode HABS HREL VABS VREL trace CuRsor VAlue HABS abs hoti abs vett trace CuRsor VAlue HREL delta horti delta vert abs vert_tef gt abs vert_dif gt lt slope gt The dV dt value slope is displayed in the appropriate trace label box trace CuRsor VAlue VABS abs vert trace CuRsor VAlue VREL delta vert For horizontal cursors both horizontal as well as vertical values are given For vertical cursors only vertical values are given ISSUED February 2005 1 19 PART Two COMMANDS AVAILABILITY trace C3 C4 available only on four channel oscilloscopes EXAMPLE GPIB The following query reads the measured absolute horizontal value of the cross hair cursor HABS on Channel 2 CMD C2 CRVA HABS CA
215. s MT_FAIL ACTION MTFA Command Query This command sets the actions that will occur whenever a waveform does not meet the pass criteria The query form of this command returns the current actions lt action gt lt action gt action STOP STORE DUMP BEEP PULSE MTFA lt action gt CUSTOM APPLICATION CUSTOM OPTIONS MT OPC MT PF COUNTERS MT SELECT TEST MT SYMBOL ISSUED February 2005 1 6 9 PART Two COMMANDS MT_OFFSET MTOF Command Query DESCRIPTION Returns the offset value for STM 1E STS 3E and 139M COMMAND SYNTAX MTOF offset value offset value 50 mV to 50 mV QUERY SYNTAX MTOF RESPONSE FORMAT MTOF offset value mV RELATED COMMANDS CUSTOM APPLICATION CUSTOM OPTIONS OPC MT PF COUNTERS MI SELECT TEST MT SYMBOL 17 0 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties MT_OPC MTOP ET PMT Query DESCRIPTION This query returns the state of the last operation Its functionality is similar to OPC operation complete QUERY SYNTAX MTOP RESPONSE FORMAT MTOP lt state gt lt state gt 0 1 where 1 complete RELATED COMMANDS CUSTOM APPLICATION CUSTOM OPTIONS MT FAIL ACTIONS MT COUNTERS MT SELECT TEST MT SYMBOL WM RCM E Rev D ISSUED February 2005 171 PART Two COMMANDS 5 MTPC Query DESCRIPTION This query returns the number of passe
216. s registers or wait for Service Request Read data cursors Of parameter measurements Figure 2 For more details on Status registers see Chapter 5 SYNCHRONZING WITH OPC AND WAIT The OPC query returns a 1 when the previous commands have finished Therefore you can use this query with the WAIT command to synchronize the scope with your controller using the steps shown in Figure 3 below The WAIT command waits for the acquisition to complete but it does not wait for the processing The WAIT command allows you to specify an optional timeout so that if the scope does not trigger your program will not hang However if you use the timeout it is strongly advised to subsequently check the status registers to ensure that the scope actually triggered and that any processing has completed WM RCM E Rev D ISSUED February 2005 29 PART ONE 30 ABOUT REMOTE CONTROL Stop the acquisition STOP Setup the scope Wait for the setup to complete Start the acquisition ARM or TRMD SINGLE WAIT for the trigger Read data cursors and parameter measurements Figure 3 89 ISSUED February 2005 WM RCM E Rev D CHAPTER TWO Control GPIB BLANK PAGE WM RCM E Rev D ISSUED February 2005 31 CHAPTER THREE Control by LAN In this chapter see how to gt Control 5 by LAN gt Simulate GPIB messages using LAN 32 ISSUED February 2005 WM RCM E Rev D CHAPTER
217. s can use the data because they do not have to find and remove the headers But C1 PAVA ALL will return a string like this AMPL 292 3E 3 OK DLY 2 333E 6 OK FALL 95 121E 9 OK MEAN 66E 6 OK PER 332 8E 9 OK PKPK 308E 3 OK RISE 92 346E 9 OK RMS 106 1E 3 OK SDEV 106 1E 3 O0K WID 166 3E 9 OK even with CHDR OFF because only the header is removed All other alphabetic information is always transmitted If you were to set the trigger slope of Channel 1 to negative the query C1 TRSL might yield the following responses C1 TRIG_SLOPE header format long C1 TRSL header format short NEG headet format off TIP Waveforms you obtain from the oscilloscope using the query WAVEFORM are a special kind of response message Control their exact format by using the COMM FORMAT and COMM ORDER commands 889 WM RCM E Rev D ISSUED February 2005 11 CHAPTER Two Control by GPIB In this chapter see how to gt Address your X Stream scope for GPIB Configure GPIB software Enable remote and local control Make transfers of data Make service requests Poll your X Stream scope NNN Set timing and synchronization 12 ISSUED February 2005 WM RCM E Rev D CHAPTER Two Control by GPIB Talk Listen or Control You can control your X Stream DSO remotely using the General Purpose Interface Bus GPIB GPIB is similar to a standard computer bus But while the computer interconnects circuit cards by means o
218. s div _33 100 ms div _34 200 ms div 235 500 ms div 236 1 s div 737 2 s div 238 5 s div 739 10 s div 740 20 s div 741 50 s div 42 100 s div 200 s div 44 500 s div 745 1 ks div 746 2 ks div 747 5 ks div 100 EXTERNAL endenum 326 VERT COUPLING enum _0 DC 50 Ohms E ground 2 DC 1MOhm 286 ISSUED February 2005 WM RCM E Rev D lt 328 gt 282 WM RCM E Rev D _3 ground 4 AC 1MOhm endenum PROBE ATT float FIXED VERT GAIN enum _0 1 uV div 2 uV div E 5 uV div 55 10 uV div _4 20 uV div 5 50 uV div _6 100 uV div 27 200 uV div 28 500 uV div 29 1 mV div 710 2 mV div 711 5 mV div 712 10 mV div 713 20 mV div 714 50 mV div 715 100 mV div 716 200 mV div 717 500 mV div 718 1 V div 719 2 V div 720 5 V div 21 10 V div 722 20 V div 723 50 V div 724 100 V div 725 200 V div 726 500_V div 727 1 kV div endenum ISSUED February 2005 Waveform Template 287 APPENDIX II Waveform Template lt 334 gt BANDWIDTH LIMIT enum _0 off endenum lt 336 gt VERTICAL VERNIER float lt 340 gt VERT OFFSET float lt 344 gt WAVE SOURCE enum _0 CHANNEL 1 zI CHANNEL 2 72 CHANNEL 3 73 CHANNEL 4 29 UNKNOWN endenum 00 ENDBLOCK USERTEXT BLOCK Explanation of the descriptor block USERTEXT at most 160 bytes long 0 gt TEXT text a list of ASCII characters 00 ENDBLOCK TRIGTIME ARRAY Explanation of the trigger time array TRIGTIME This
219. scilloscope CM CM R R lt value gt value 0 to 13 The following instruction reads the contents of the CMR register CM CA AL D CMR CALL IBWRT SCOPE CMDS LL 5 5 5 PRINT RSP L STATUS CLS ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries ADDITIONAL INFORMATION COMMAND ERROR STATUS REGISTER STRUCTURE CMR Description Unrecognized command query header Illegal header path Illegal number Illegal number suffix Unrecognized keyword String error GET embedded in another message Arbitrary data block expected Non digit character in byte count field of arbitrary data block EOI detected during definite length data block transfer Extra bytes detected during definite length data block transfer WM RCM E Rev D ISSUED February 2005 105 PART Two COMMANDS ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS 106 COMBINE_CHANNELS COMB Command Query The COMBINE CHANNELS command controls the channel interleaving function of the acquisition system The COMBINE CHANNELS query returns the channel interleaving function s current status COMBine channels lt state gt state 1 2 AUTO Selecting 1 means no combining of channels will take place i e in the Timebase Horizontal dialog 4 channels will be shown as the selection COMBine channels
220. scilloscope has 256 byte input and output buffers An incoming program message is not decoded before a message terminator has been received However if the input buffer becomes full because the program message is longer than the buffer the oscilloscope starts analyzing the message In this case data transmission is temporarily halted and the controller may generate a timeout if the limit was set too low USE IEEE 488 1 STANDARD MESSAGES The IEEE 488 1 standard specifies not only the mechanical and electrical aspects of the GPIB but also the low level transfer protocol For instance it defines how a controller addresses devices turns them into talkers ot listeners resets them or puts them in the remote state Such interface messages are executed with the interface management lines of the GPIB usually with true All these messages except GET are executed immediately upon receipt The command list in Part Two of this manual does not contain a command for clearing the input or output buffers or for setting the oscilloscope to the remote state NOTE In addition to the IEEE 488 1 interface message standards the IEEE 488 2 standard specifies certain standardized program messages i e command headers They are identified with a leading asterisk and are listed in the System Commands section This is because such commands are already specified as IEEE 488 1 standard messages Refer to the GPIB interface manual of
221. smMUs WAVEFORM mmmuwavm e SE Nts INTENSITY ism RN MENORY_STZB ACQUISITION MT_ATTENUATION ET PMT MT_FAIL ACTION ET MT PMT MTOP MT_PF_COUNTERS MTst MT_SYMBOL ama MT_VERTICAL_ALIGN ET PMT orrset ACQUISITION opr ropra MISCELLANEOUS Parm PARAMETER cursor 84 ISSUED February 2005 WHAT THE COMMAND OR QUERY DOES Controls the interpolation lines between data points Sets up email protocol and addresses Sets the Standard Event Status Enable register ESE Reads clears the Event Status Register ESR Reads clears the EXecution error Register EXR Automatically sets the center and width of a histogram Forces the instrument to make one acquisition Resets a waveform processing function Specifies single dual or quad mode grid display Configures the hard copy driver Horizontally expands the selected expansion trace Horizontally positions intensified zone s center For identification purposes Sets the INternal state change Enable register INE Reads clears INternal state change Register INR Allows acquired waveform parts to be read Enables disables Random Interleaved Sampling RIS Controls the brightness of the grid Reads the current state of the IEEE 488 Displays a character strin
222. specified in the command the source will be set to the X don t care state The response sends back only the source states that are either H high or L low ignoring the X states QUERY SYNTAX TRig_PAttern lt source gt lt state gt lt source gt lt state gt STATE lt trigger_condition gt RESPONSE FORMAT TRig_PAttern lt source gt lt state gt lt source gt lt state gt STATE lt trigger_condition gt 242 ISSUED February 2005 WM RCM E Rev D EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties The following instruction configures the logic state of the pattern as HLXH CH 1 CH 2 L CH 3 X CH 4 H and defines the state as NOR CMDS TRPA C1 H C2 L C4 H STATE NOR CALL IBWRT SCOPE CMDS TRIG_COUPLING TRIG DELAY TRIG LEVEL TRIG MODE TRIG SELECT TRIG SLOPE ISSUED February 2005 243 PART Two COMMANDS ACQUISITION DESCRIPTION TRIG SELECT TRSE Command Query The TRIG SELECT command selects the condition that will trigger the acquisition of waveforms Depending on the trigger type additional parameters may need to be specified These additional parameters are grouped in pairs The first in the pair names the variable to be modified while the second gives the new value to be assigned Pairs may be given in any order and restricted to only those variables to be changed The TRIG SELECT query returns the cur
223. sponds to the time of the command COMMAND SYNTAX SCreen DumP QUERY SYNTAX SCreen DumP RESPONSE FORMAT SCreen DumP lt status gt lt status gt OFF EXAMPLE GPIB The following instruction initiates a screen dump CMD SCDP CALL IBWRT SCOPE CMD RELATED COMMANDS INR HARDCOPY_SETUP 220 ISSUED February 2005 WM RCM E Rev D ACQUISITION DESCRIPTION COMMAND SYNTAX WM RCM E Rev D Remote Control Commands and Queties SEQUENCE SEQ Command Query The SEQUENCE command sets the conditions for the sequence mode acquisition The response to the SEQUENCE query gives the conditions for the sequence mode acquisition The argument lt max_size gt can be expressed either as numeric fixed point exponential or using standard suffixes When Sequence mode is turned on by means of this command SMART memory is automatically enabled and the memory length is set to the user supplied lt max_size gt value Sequence mode cannot be used at the same time as random interleaved sampling RIS If RIS is on SEQ ON will turn RIS off SEQuence lt mode gt lt segments gt lt max_size gt lt mode gt OFF ON lt segments gt the right hand column in the table below Max memory length per Max number of segments channel gm o lt max_size gt 10e 3 10 0e 3 11e 3 for example in standard numeric format ISSUED February 2005 221 PART Two COM
224. t state ANALOG COLOR GRADED 3D PErsist CoLor PErsist CoLor lt state gt The following instruction sets the persistence trace color to an intensity graded range of the selected trace color CMDS PECL ANALOG CALL IBWRT SCOPE CMDS PERSIST PERSIST LAST PERSIST SAT PERSIST SETUP ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties CURSOR PER CURSOR SET PECS Command Query DESCRIPTION The CURSOR command allows you to position one more of the six independent cursors at a given grid location Cursors must be turned on for the PECS query to work NOTATION HABS Horizontal absolute VABS Vertical absolute HDIF Horizontal difference VDIF Vertical difference HREF Horizontal reference VREF Vertical reference COMMAND SYNTAX QUERY SYNTAX EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D trace PEr Cursor Set lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt lt position gt lt trace gt C1 C2 C3 F1 through F8 M1 M2 M3 TA TB TC TD TA through TD are included for compatibility with existing software for earlier instruments These four mnemonics will not be used in responses to queries lt trace gt PEr_Cursor_Set The following instruction positions the HREF and HDIF cursors at 2 6 DIV and 7 4 DIV respectively using Channel 2 as a reference 5 2 5 HREF
225. t lt evelsare gt lt highpct gt lt highabs gt lt cyclic gt lt Clockslope gt lt pctabs gt lt clocklevelis gt lt clockpctlevel gt lt clockabslevel gt lt source2 gt lt dataslope gt lt pctabs gt lt da talevelis gt lt datapctlevel gt lt dataabslevel gt lt clockhysteresi s gt lt datahysteresis gt lt cyclic gt lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt absleve 1 gt lt hysteresis gt lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt absleve 1 gt lt hysteresis gt lt peaknumber gt CUSTOMIZABLE PARAMETERS WITH EXTENDED MATH OPTION Delta time at level fall at level Time at level lt qualifier gt list lt source1 gt lt slopel gt lt levell gt lt source2 gt lt slope2 gt lt lev el2 gt lt hysteresis gt lt source gt lt high gt lt low gt lt source gt lt low gt lt high gt lt soutce gt lt slope gt lt level gt lt hysteresis gt ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries CUSTOMIZABLE PARAMETERS WITH SDA amp SDM OPTION lt param gt Definition lt qualifier gt list AVG Histogram mean CROSSPERCENT Differential crossing DCD DPLEV Delta period at level lt signaltype gt lt slope gt lt pctabs gt lt leveltype gt lt percentlev el gt lt abslevel gt lt hysteresis gt lt usebasefrequency gt lt basefr equency gt lt stdbasefrequency gt DTLEV Delta
226. t SampleClock Internal Enum H Internal External Egg SampleMode RealTime Enum RealTime RIS c2 SampleRate 1000000000 DoubleLockstep H From 500 to 2 009 step 1 007 SamplingRate 2000000000 Double R From 1 to 2e 009 step 2 digits SamplingRateDown Action T am SamplingRateUp Action Channels SequenceTimeout 0 01 Double 4 From 0 to 5 step 0 01 E Horizontal SequenceTimeou true Bool g 0 1 or false true b 4 app Acquisition Horizontal SampleMode 7 The following inputs are allowed Real Time Mode app Acquisition Horizontal SampleMode 0 Real Time Mode Acquisition Horizontal SampleMode RealTime Sequence Mode app Acquisition Horizontal SampleMode 1 Sequence Mode app Acquisition Horizontal SampleMode Sequence Were you to select Edit Copy at this point the line app Acquisition Horizontal SampleMode would be copied into the clipboard for use in your own application program WM RCM E Rev D ISSUED February 2005 7 5 PART ONE ABOUT REMOTE CONTROL You will see that some lines in XStreamBrowser classified as Action rather than as a variable type These actions ate performed simply by sending the Action name with no argument for example app InternalCollection Display ClearSweeps This would clear all the data from a persistence trace for example You can often reduce the amount of typing by the following kind of statements Set
227. t for the event transfer the data and then start a new acquisition You could also loop this line in the program as soon as it has finished reading the waveform 85 WM RCM E Rev D ISSUED February 2005 61 CHAPTER FIVE Checking Waveform Status In this chapter see how to gt Use status registers 62 ISSUED February 2005 WM RCM E Rev D CHAPTER FIVE Checking Waveform Status Use Status Registers wide range of status registers allows you to quickly determine the instrument s internal processing status at any time These registers and the oscilloscope s status reporting system which group related functions together are designed to comply with IEEE 488 2 recommendations Some such as the Status Byte Register STB or the Standard Event Status Register ESR are required by the IEEE 488 2 Standard Others are device specific including the Command Error Register CMR and Execution Error Register EXR Those commands associated with IEEE 488 2 mandatory status registers are preceded by an asterisk OVERVIEW The Standard Event Status Bit ESB and the Internal Status Change Bit INB in the STB are summary bits of the ESR and the Internal State Change Register INR The Message Available Bit MAV is set whenever there are data bytes in the output queue The Value Adapted Bit VAB indicates that a parameter value was adapted during a previous command interpretation For example if the command TDIV 2 5 US was rec
228. t of an existing program The Automation command must be placed within single quotation marks The sign may be flanked by optional spaces for clarity VBS automation command VBS lt Return automation command The following instruction sets Channel 1 vertical scale to 50 mV Div the time per division to 500 ns and the grid mode to Dual MDS VBS app Acquisition Cl VerScale 0 05 MDS C1 VDIV 50 GPIB equivalent MDS VBS app Horizontal HorScale 500e 9 MDS TDIV 0 5 6 GPIB equivalent MDS VBS app Display GridMode Dual C Qi v MDS GRID DUAL GPIB equivalent CMDS VBS Return app Acquisition Cl VerScale ISSUED February 2005 WM RCM E Rev D DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX RESPONSE FORMAT EXAMPLE RELATED COMMANDS WM RCM E Rev D Remote Control Commands and Queties VERT_MAGNIFY VMAG Command Query The VERT_MAGNIFY command vertically expands the specified trace The command is executed even if the trace is not displayed The maximum magnification allowed depends on the number of significant bits associated with the data of the trace The VERT_MAGNIFY query returns the magnification factor of the specified trace trace Vert MAGnify lt factor gt trace F1 F2 F3 FA4 F5 F6 F7 F8 TA TB TC TD TA through TD are included for backward compatibility with software designe
229. t string gt lt data_type gt lt trace gt 1 2 4 5 6 7 8 TD 1 2 3 4 1 2 3 4 Note that TA through TD are included for compatibility with software designed for earlier LeCroy instruments These four labels will not be returned in responses to queties data type BYTE WORD FLOAT TA through TD are for backward compatibility and are not returned by queries NOTE The optional parameter data type applies only to inspection of data arrays It selects the representation of the data The default data type is FLOAT ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queties NOTE Blok WAVEDESC contains several variables related to scaling of data values Values of these variables depend on the current setting of the command COMM_FORMAT CFMT The following example shows how these values change when you modify the setting from BYTE default to WORD CFMT DEF9 BYTE BIN C1 INSP WAVEDESC C1 INSP COMM_TYPE byte VERTICAL GAIN 3 1250e 003 VERTICAL OFFSET 2 0600e 001 MAX VALUE 1 2700e 002 MIN VALUE 1 2800 002 DEF9 WORD DEF9 WORD BIN C1 INSP WAVEDESC C1 INSP COMM_TYPE word VERTICAL GAIN 1 2207e 005 VERTICAL OFFSET 2 0600 001 MAX VALUE 3 2512e 004 MIN VALUE 3 2768e 004 WM RCM E Rev D ISSUED February 2005 161 PART Two
230. t which the trigger is to occur with respect to the first acquired data point displayed at the left hand edge of the screen Positive trigger delays are to be expressed as a percentage of the full grid This mode is called pre trigger acquisition because data are acquired before the trigger occurs Negative trigger delays must be given in seconds This mode is called post trigger acquisition because the data are acquired after the trigger has occurred If a value outside the range 10 000 div x time div and 100 is specified the trigger time will be set to the nearest limit and the VAB bit bit 2 will be set in the STB register The response to the TRIG_DELAY query indicates the trigger time with respect to the first acquired data point Setting a trigger delay value of zero in X Stream scopes places the trigger indicator at the center of the grid unlike non X Stream scopes which place it at the left edge of the grid COMMAND SYNTAX TRig_DeLay lt value gt value 0 00 PCT to 100 00 PCT pretrigger 20 PS to 10 MAS post trigger NOTE The unit is optional For positive numbers the unit PCT is assumed For negative numbers the unit S is assumed MAS is the unit for Ms megaseconds useful only for extremely large delays at very slow timebases QUERY SYNTAX TRig DeLay RESPONSE FORMAT TRig DeLay lt value gt 238 ISSUED February 2005 WM RCM E Rev D EXAMPLE GPIB RELATED COMMANDS WM RCM E Rev D
231. tage offset selected after conversion for the data representation being used The template tells us that the vertical gain and offset can be found at Bytes 156 and 160 and that they are stored as floating point numbers in the IEEE 32 bit format An ASCII string giving the vertical unit is to be found in VERTUNIT Byte 196 The vertical value is given by the relationship value VERTICAL_GAIN x data VERTICAL_OFFSET where VERTICAL_GAIN 2 44141e 07 from the floating point number 3483 126f at Byte 156 VERTICAL OFFSET 0 00054 from the floating point number 3A0D 8EC at Byte 160 VERTICAL_UNIT V volts from the string 5600 at Byte 196 Therefore since data 4 00 64000 from the hexadecimal word 00 at byte 373 Overflows the maximum 16 bit value of 32767 so must be a negative value Using the two s complement conversion 64000 216 1536 value 4 0 000915 V as stated in the inspect command If the computer or the software available is not able to understand the IEEE floating point values use the description in the template The data values in a waveform may not all correspond to measured points FIRST_VALID_PNT and LAST_VALID_PNT give the necessary information The descriptor also records the SPARSING_FACTOR the FIRST POINT and the SEGMENT INDEX to aid interpretation if the options of the WAVEFORM SETUP command have been used For sequence acquisitions the data values for each segme
232. te that some values are in quotation marks because they are to be the names of directories files or printers which may contain spaces and other non alphanumetic characters The other values must be chosen from the lists provided below COMMAND SYNTAX HardCopy SetUp DEV device FORMAT format BCKG lt bckg gt DEST destination DIR Xdirectory2 FILE lt filename gt AREA lt hardcopyarea gt PRINTER printe gt lt gt PSD BMPCOMP JPEG PNG TIFF lt format gt PORTRAIT LANDSCAPE lt gt BLACK WHITE 21 lt destination gt PRINTER CLIPBOARD EMAIL FILE REMOTE lt directory gt valid destination directory name for FILE mode only filename valid destination filename auto incremented for FILE mode only lt area gt GRIDAREAONLY DSOWINDOW FULLSCREEN lt portname gt GPIB RS232 NET only accepted with a command for backward compatibility and sets DEST REMOTE lt printername gt valid printer name for PRINTER mode only WM RCM E Rev D ISSUED February 2005 151 PART Two COMMANDS QUERY SYNTAX RESPONSE FORMAT EXAMPLE GPIB RELATED COMMANDS ADDITIONAL INFORMATION 152 HCSU If preceded for example by hcsu dest file with CHDR OFF DEV PNG FORMAT PORTRAIT BCKG BLACK DEST REMOT DIR C LECROY XSTREAM HARDCOPY
233. th the command SRE 32 The generation of a non zero value of CMR would ripple through to MSS generating a Service Request SRQ You can read the value of CMR and simultaneously reset to zero at any time with the command CMR The occurrence of a command error can also be detected by analyzing the response to ESR However if you must survey several types of potential errors it is usually far more efficient to enable propagation of the errors of interest into the STB with the enable registers ESE and INE To summarize a command error CMR sets Bit 5 of ESR if a Bit 5 of ESE is set ESB of STB is also set or b Bit5 of SRE is set MSS RQS Request for Service of STB is also set and a Service Request is generated STATUS BYTE REGISTER STB STB is the instrument s central reporting structure It is made up of eight single bit summary messages three of which are unused that reflect the current status of the oscilloscope s associated data structures gt Bit 0 is the INB summary bit of the Internal State Change Register It is set if any INR bits are set provided they are enabled by the corresponding bit of the INE register gt Bit 2 is the bit indicating that a parameter value was adapted during a previous command interpretation gt Bit 4 is the bit indicating that the interface output queue is not empty gt Bit5is the summary bit ESB of the ESR It is set if any of the bits of the ESR are set provided t
234. the Individual STatus bit IST returned in parallel polling by sending the IST query To enable this poll mode you must initialize the X Stream DSO as for parallel polling by writing into the PRE register Since IST emulates parallel polling apply this method wherever parallel polling is not supported by the controller In the following example the command INE 1 enables the event new signal acquired in the INR to be reported to the INB bit of the status byte STB The command PRE 1 enables the INB bit to set the IST bit whenever it is set The command CHDR OFF suppresses the command header in the oscilloscope s response simplifying the interpretation The status of the IST bit is then continuously monitored until set by the oscilloscope CMD CHDR OFF INE 1 PRE 1 CALL IBWRT SCOPE CMDS DO CMD IST CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RD LOOP UNTIL VAL RD 1 26 ISSUED February 2005 WM RCM E Rev D CHAPTER TWO Control by GPIB Timing and Synchronization Depending on how your remote program is written it may be affected by timing changes between different DSO series even between Waverunner DSOs and WavePro DSOs In X Stream DSOs these effects may be even more pronounced than in previous scopes for several reasons Firstly X Stream DSOs are faster than our eatlier scopes Secondly X Stream DSOs suppott faster interfaces That is the standard network interface 1s 100Base T instead of 10Base T Secondl
235. the host controller as well as to its support programs which should contain special calls for the execution of these messages The following description covers those IEEE 488 1 standard messages that go beyond reconfiguration of the bus and that have an effect on X Stream DSO operation 16 ISSUED February 2005 WM RCM E Rev D CHAPTER TWO Control by GPIB DEVICE CLEAR In response to a universal Device CLear DCL or a Selected Device Clear message SDC the X Stream DSO clears the input ot output buffers cancels the interpretation of the current command if any and clears pending commands However status registers and status enable registers are not cleared Although DCL will have an immediate effect it can take several seconds to execute if the oscilloscope is busy GROUP EXECUTE TRIGGER The Group Execute Trigger message GET causes the X Stream DSO to arm the trigger system and is functionally identical to the TRG command REMOTE ENABLE X Stream DSOs do not lock out any local controls when placed in the remote state or in RWLS It always accepts remote as well as local control inputs unless you turn off remote control capability in Utilities Remote INTERFACE CLEAR The InterFace Clear message IFC initializes the GPIB but has no effect on the operation of the X Stream DSO NOTE To illustrate the GPIB programming concepts a number of examples are included here written in a similar way to BASIC It is assu
236. the manual you will find the commands and queries to run the instrument remotely 80 ISSUED February 2005 WM RCM E Rev D R T T wo M D S Use Commands and Queries This part of the manual describes the remote control commands and queries recognized by the instrument All of them can be executed in either local or remote state The commands and queries are listed in alphabetical order according to the long form of their name For example the description of ATTENUATION whose short form is ATTN is listed before that of AUTO SETUP whose short form is ASET Each command or query description starts on a new page The name header is given in both long and short form at the top of the first page of each description Queries perform actions such as obtaining information They are recognized by following their headers Many commands can be used as queries simply by adding the question mark In order to find out the correct form of a command it is very useful to set up the scope manually to the exact condition that you require and then to send a query which corresponds to the required command The reply from the scope can be copied into your program as a command A brief explanation of the operation performed by the command or query is followed by the formal syntax with the full name header given in lowercase characters and the short form derived from it in uppercase characters e g DoT_JoiN gives DTJN Wher
237. the queries TRIG_MODE is left out If this response is sent back to the oscilloscope it is a valid program message for setting its timebase to 50 ns div and the input coupling of Channel 1 to 50 10 ISSUED February 2005 WM RCM E Rev D CHAPTER ONE Overview Whenever you expect a response from the oscilloscope you must have the control program instruct the GPIB ot LAN interface to read from the oscilloscope If the controller sends another program message without reading the response to the previous one the response message in the output buffer of the oscilloscope will be discarded The oscilloscope keeps to stricter rules for response messages than for acceptance of program messages While you can send program messages from the controller in uppercase or lowercase characters response messages always returned in uppercase Program messages may contain extraneous spaces or tabs white space but response messages will not And while program messages may contain a mixture of short and long command or query headers response messages always use short headers by default However you can use the command COMM_HEADER to force the oscilloscope to use long headers or none at all If the response header is omitted the response transfer time will be minimized But the response will not be able to be sent back to the oscilloscope Suffix units are also suppressed in the response An advantage of headerless operation is the ease with which program
238. time at levels lt slopel gt lt pctabs gt lt leveltype gt lt percentlevell gt lt abslev ell gt lt source2 gt lt slope2 gt lt pctabs gt lt leveltype gt lt perce ntlevel2 gt lt abslevel2 gt lt hysteresis gt DWIDLEV Delta width at level lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt EDLEV Edges at level lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt EXTRATIO Eye level ratios EYEAMPL Eye amplitude ERR EYEHEIGHT TBD EYEWIDTH Eye width EYECROSSINGC ALC FREQLEV Frequency at level lt signaltype gt lt slope gt lt pctabs gt lt leveltype gt lt percentlev el gt lt abslevel gt lt hysteresis gt lt usebasefrequency gt lt basefr equency gt lt stdbasefrequency gt FWHM Histogram FWHM FWXX Hist peak FW at level lt hfractionht gt HPER Half period lt slope gt lt pctabs gt lt leveltype gt lt percentlevel gt lt abslevel gt lt hysteresis gt HAMPL Histogram amplitude HBASE Histogram base level HIGH Histogram right bin WM RCM E Rev D ISSUED February 2005 1 87 PART Two COMMANDS ms HTOP Histogram top level HOLDLEV Clock to data edge time lt clockslope gt lt pctabs gt lt clocklevelis gt lt clockpctlevel gt lt clockabslevel gt lt source2 gt lt dataslope gt lt pctabs gt lt data levelis gt lt datapctlevel gt lt dataabslevel gt lt clockhyst
239. tion for the command to set the vertical input sensitivity 1 channel VOLT_DIV lt v_gain gt 2 channel C1 C2 3 v gain 5 0 mV to 2 5 V The first line shows the formal appearance of the command channel denotes the placeholder for the header path v gain is the placeholder for the vertical gain value The second line indicates that either C1 or C2 must be chosen for the header path The third line means that the actual vertical gain can be set to any value from 5 mV to 2 5 V 82 ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries Table of Commands and Queries By Short Form SHORT FORM sr ALL STATUS STATUS am ARM ACQUISITION ACQUISITION AUTO sump ACQUSIHON arm ATTENUATION ACQUISITION CUSTOM_APPLICATION ET PMT CU_OPT CUSTOM_OPTIONS ET PMT Der DEFINE FUNTON MISCELLANEOUS pisenay DISPLAY WM RCM E Rev D LoNG FORM SUBSYSTEM CATEGORY ISSUED February 2005 WHAT THE COMMAND OR QUERY DOES Reads and clears the contents of all status registers Changes acquisition state from stopped to single Adjusts vertical timebase and trigger parameters Selects the vertical attenuation factor of the probe Enables and disables automatic calibration Controls the buzzer in the instrument Enables disables bandwidth limiting low pass filter Performs a complete internal calibration of the DSO Selects the format
240. to new signal acquired This event is tracked by the INR register which is reflected in the SRE register as the INB summary bit in position 0 Since bit position 0 has the value 1 the command SRE 1 enables the generation of SRQ whenever the INB summary bit is set In addition the events of the INR register that may be summarized in the INB bit must be specified The event new signal acquired corresponds to INE bit 0 value 1 while the event return to local is assigned to INE bit 2 value 4 The total sum is 1 4 5 Thus the command INE 5 is needed CMD INE 5 SRE 1 CALL IBWRT SCOPE CMDS 22 ISSUED February 2005 WM RCM E Rev D CHAPTER TWO Control by GPIB Take Instrument Polls You can regulatly monitor state transitions within the oscilloscope by polling selected internal status registers There are four basic polling methods you can use to detect the occurrence of a given event continuous serial parallel and IST By far the simplest of these is continuous polling The others are appropriate only when interrupt service routines servicing the SRQ line are supported or multiple devices on GPIB require constant monitoring To emphasize the differences between the methods described below the same example determining whether a new acquisition has taken place is used in each case DO CONTINUOUS POLLING A status register is continuously monitored until a transition is observed This is the most
241. tring TDIV and transfer it to the oscilloscope The command instructs the oscilloscope to respond with the current setting of the timebase Read Read the response of the oscilloscope and place it into the character string RD WM RCM E Rev D ISSUED February 2005 19 PART ONE ABOUT REMOTE CONTROL When running this sample program the X Stream DSO will automatically be set to the remote state when IBWRT is executed and will remain in that state Here is a slightly modified version of the sample program that checks if any error occurred during GPIB operation GPIB This line should hold the INCLUDE for the GPIB routines Address DEVS DEV4 Find CALL IBFIND DEVS SCOPES Find the DSO Send CMDS TDIV Time base query CALL IBWRT SCOPE CMDS Send the string to the DSO Errors IF 5 lt 0 THEN PRINT WRITE ERROR IBERR END Read CALL IBRD SCOPE RD Try to read a string from the DSO ErrorR IF 5 lt 0 THEN PRINT READ ERROR IBERR END PRINT RD 190 END The GPIB status word IBSTA the GPIB error variable and the count variable are defined by the GPIB handler and are updated with every GPIB function call IBSTA is negative if there is an error while IBERR shows what type of error has occurred IBCNT is the number of bytes transferred Refer to the National Instruments manual for details The sample program above would report an error if the GPIB a
242. tting up the Amplitude parameter VBS app Measure P1 View True VBS app Measure Pl ParamEngine AMPL VBS app Measure P1l Sourcel 1 VBS app Measure P1l GateStart 1 667 VBS app Measure P1 GateStop 3 333 WM RCM E Rev D ISSUED February 2005 71 PART ONE ABOUT REMOTE CONTROL HOW TO USE X STREAM BROWSER The number of different variables and methods in a complete setup is obviously large To facilitate the job of creating control statements LeCroy has produced the program XStreamBrowser Using this program you can quickly find the information that corresponds to any part of the instrument On opening XStreamBrowser you will see three icons at the top left of the screen The first one makes the connection between XstreamBrowser and the instrument 2 xStream Browser Online browsing LeCroy xStreamDSO xj Fie Edit Help Connect to a local X Stream DSO device HH Acquisition AcquisitionDuration 0 0000001 E AuxOutput ExternalClockRate 1 88 ci ExtImpedance undef HorOffset 0 C2 c3 HorOffsetControl Time HorOffsetOrigin 5 C4 HorScale 1 0Q 00000005 8 Channels xja The second icon makes the connection by means of Microsoft s distributed component object model DCOM lol x 2 XStream Browser Online browsing LeCroy xStreamDsu Ele Edit Help paces eamNSO Connect to
243. turned for consistency However the source for the measurement is the one configured using the PACU command TIP Use PAVA to read the measured value of a parameter that was set up with PACU To determine the correct form of a PACU command in your scope model it is useful to set up the scope manually to the configuration that you want and then send a PACU query The response from the scope can be copied straight into your program for use as a quety COMMAND SYNTAX Parameter Custom lt param gt AMPL AREA BASE CYCL DLY DDLY 184 lt column gt lt parameter gt lt qualifier gt lt qualifier gt column 1 to 8 parameter a parameter from the table below or any parameter listed in the PAVA command qualifier Measurement qualifier s specific to each lt param gt See below CUSTOMIZABLE PARAMETERS ON ALL MODELS qualifier list Amplitude Area lt source gt Base Cycles on screen Delay Delta delay lt source2 gt ISSUED February 2005 WM RCM E Rev D Remote Control Commands and Queries DTLEV Delta time at level lt slopel gt lt pctabs gt lt leveltype gt lt percentlevell gt lt absle vell gt lt source2 gt lt slope2 gt lt pctabs gt lt leveltype gt lt per centlevel2 gt lt abslevel2 gt lt hysteresis gt DUR duration of acquisition DUTY duty cycle DULEV Duty cycle at level lt slope gt lt pcectabs gt lt leveltype gt lt
244. u seen toca ch av deca ee teed eave cde oe 23 DO CONTINUOUS POLLING 23 TAKE A SERIAL IPOLL 24 2 ettet A AS 24 PERFORM ANS ten ee teet teet A e re a tnde 26 WM RCM E Rev D ISSUED February 2005 111 TABLE OF CONTENTS Timing and 27 STATUS REGISTERS Naa ia 28 SYNCHRONIZING WITH OPC AND 1 222 29 CHAPTER THREE CONTROL BY LAN eene nennen nennen nnn nennen nnn nnns 32 eL 33 IMPLEMENTATION STANDARD tenens 33 GONNEGTIONS reete ooo leta Mn bees teu esiste teens 33 Connecting the Instrument to its sienne ennt 33 SCOPE RBEARJPANEL 15 53 21 haie nuts 34 ETHERNET CONNECTION ssssssssseseseeeeee enne snnt inttr inrer nn 34 HEADERS FOR LAN DATA 34 MANUAL SETTING OF LAN ADDRESS sse nnne nene 36 MAKING PHYSICAL CONNECTION 38 NETWORK 2222 4 2 000
245. uld be as follows VBS app InternalCollection Display CleatSweeps Other examples of actions are as follows app Display FactoryDefault app Acquisition Horizontal ZeroDelay app Acquisition Trigger ZeroLevel app Measure SetGateToDefault app Memory ClearAllMem 395 WM RCM E Rev D ISSUED February 2005 7 7 PART ONE ABOUT REMOTE CONTROL BLANK PAGE 7 8 ISSUED February 2005 WM RCM E Rev D PART Two COMMANDS Part Two describes the commands and queries you will need to operate your instrument remotely Important Note for users of other LeCroy instruments with existing remote control software Trace labels TA TB TC and TD have been replaced by traces F1 F2 F3 and F4 respectively Existing software that includes the old trace labels will work with X Stream scopes but new software should use the new labels unless it will also be used on an eatlier instrument In addition to these four traces the instrument includes F5 F6 F7 and F8 Responses to queries will always use the new labels even if the old labels are used in the query however Traces F1 through F8 are completely equivalent in ability to perform zooms or processing Parameter labels have also changed These are now P1 through P8 but the older labels Cust1 through Cust5 etc will still work Responses to queries will always use the new labels even if the old labels are used WM RCM E Rev D ISSUED February 2005 79 PART Two COMMANDS In this part of
246. us Bud lt space gt 64 ASCII DEVICE 3244 36 ASCII 6444 68 ASCII D y INCLUDE NATIONAL INSTRUMENTS GPIB ROUTINES CLS PRINT Control of the 9300 address 4 via GPIB and IBM PC PRINT PRINT Options EX to exit LC local mode PRINT ST store data RC recall data PRINT UnListen Chr 63 UnTalk Chr 95 Y General UnListen and UnTalk WM RCM E Rev D ISSUED February 2005 263 APPENDIX I Program Examples BaseListen 32 BaseTalk 64 DSOAddress 4 DSOListen UnListen UnTalk Chr BaseTalk DSOAddress DSOTalk UnListen UnTalk Chr BaseListener DSOAddress BDNAMES GPIBO CALL IBFIND BDNAMES BRDO Chr BaseListen Chr BaseTalk IF BRDO lt 0 THEN PRINT IBFIND ERROR STOP CALL IBSIC BRDO IF 5 lt 0 THEN PRINT IBFIND ERROR STOP LOOP 1 WHILE LOOP LINE INPUT Enter command EX gt Exit CMDS V 1 CALL IBSRE BRDO V IF CMDS ex OR CMDS EX THEN LOOP FALSE GOTO ExitGPIB IF CMDS st OR CMDS ST THEN GOSUB StoreData GOTO LoopEnd IF CMDS OR CMDS RC THEN GOSUB RecallData GOTO LoopEnd IF CMDS lc OR CMDS LC THEN GOSUB DSOLocal GOTO LoopEnd IF CMDS THEN GOTO LoopEnd CALL IBCMD BRDO0 DSOListen CALL IBWRT BRDO CMD GOSUB GetData LoopEnd WEND ExitGPIB CALL IBSIC BRD0 V 0 CALL IBSRE BRDO V CALL IBSIC BRDO END DSOLocal Vs 0 CALL IBSRE BRDO V PRIN
247. use the example was taken using an oscilloscope with an eight bit ADC we see the eight bits followed by a 0 byte for each data point However for many other kinds of waveform this second byte will not be zero and will contain significant information The data is coded in signed form two s complement with values ranging from 32768 8000 hex to 32767 7FFF hex If we had chosen to use the BYTE option for the data format the values would have been signed integers in the range 128 80 hex to 127 7F hex The ADC values are mapped to the display grid in the following way is located on the center axis e 127 BYTE format or 32767 WORD format is located at the top of the grid e 128 BYTE format or 32768 WORD format is located at the bottom of the grid From bottom to top of the screen we have 80 81 82 FD FE FR 0 1 2 7D 7E 7E To convert from these byte values to actual numerical values or vice versa we can use the following formula for eight bit values New value Old value 80 hex AND 255 56 ISSUED February 2005 WM RCM E Rev D CHAPTER FOUR Understanding and Managing Waveforms INTERPRET VERTICAL DATA Knowing now how to decipher the data you may wish to convert it to the appropriate measured values The vertical reading for each data point depends on the vertical gain and the vertical offset given in the descriptor For acquisition waveforms this corresponds to the volts div and vol
248. was set with the command ESE 32 enabling Bit 5 of ESR to be set for reporting to the summary bit ESB of the STB WM RCM E Rev D ISSUED February 2005 63 PART ONE ABOUT REMOTE CONTROL Power ON User request URR Command error found CMR Execution error detected EXR Device specific error DDR Query error Request control unused Operation complete N Standard Event Status Register Read by ESR Logical OR Internal State y Change Register amp Read by INR A N See INR command for the interpretation of the bits E qure In DID D Standard Event Status Enable Register Set by n Read by ESE Logical OR Service Request Generation ESB MAV 3 vaB 1 Status Byte Register Internal State Change Read by Serial Poll Enable Register Read by STB Setby INE n Read by INE Service Request Y Enable Register Setby SRE n A a ss Status Register Structure Logical OR 6 4 ISSUED February 2005 WM RCM E Rev D CHAPTER FIVE CHECKING WAVEFORM STATUS If you enabled the setting of the ESB summary bit in STB again nothing would occur unless you enabled further reporting by setting the corresponding bit in the SRE register wi
249. wever this can become more complex In some commands where you can specify as many as a dozen different parameters or where not all the parameters are applicable at the same time the format requires pairs of data values The first value names the parameter to be modified while the second gives its value Only those parameter pairs that are to be changed need to be indicated Example HARDCOPY_SETUP DEV EPSON PORT GPIB In this example two pairs of parameters have been used The first specifies the device as an EPSON or compatible printer while the second indicates the GPIB port While the command HARDCOPY_SETUP allows many more parameters either they are not relevant for printers or they are left unchanged NUMERIC DATA The numeric data type is used to enter quantitative information Numbers can be entered as integers or fractions or in exponential representation F1 VPOS 5 Move the display of Trace A downward by five divisions C2 OFST 3 56 Set the DC offset of Channel 2 to 3 56 V TDIV 5 0E 6 Adjust the timebase to 5 usec div Example There are many ways of setting the timebase of the oscilloscope to 5 usec div 5E 6 Exponential notation without any suffix 5 05 Suffix multiplier U for 1E 6 with the optional suffix S for seconds or TDIV 5000 NS or TDIV 5000E 3 US WM RCM E Rev D ISSUED February 2005 9 PART ONE ABOUT REMOTE CONTROL You can follow numeric values with multipliers and units to modify
250. y and more significantly for the most part our earlier scope series processed remote commands sequentially That is they would not start executing any command until execution of the previous one had finished This meant that many operations were automatically synchronous by default and remote control programs which did not use status bytes or OPC may have worked by luck That is not the case in X Stream DSOs Since they use multitasking you must be much more diligent in programming Most timing and synchronization problems are related to changing acquisitions or the completion of analysis after an acquisition occuts For example if you change the offset of channel 1 while the scope is in Auto trigger mode and then you use the PAVA query to read a parameter computed on channel 1 in the older scopes you would almost always get the results after the data has been acquired with the new offset However in X Stream DSOs the processing is overlapped with the next acquisition and as a consequence the PAVA result may have come from the acquisition prior to the offset change There are several ways of ensuting that your program gives the correct results when controlling the scope remotely To simplify the synchronization issue in most cases you can put the scope into single trigger mode Then you can use either the status registers available in the scope or the OPC query and the WAIT command to detect completion when the acquisition and any
251. y N Slide 1 of 1 Default Design English 0 5 X Stream DSO s captured waveform imported into PowerPoint Once the ActiveDSO object has been properly set within the application a macro script can be created utilizing an object method such as WriteString to send DISP ON C1 TRA ON TRMD Then RefreshImage method can be used to update the screen WM RCM E Rev D ISSUED February 2005 27 7 APPENDIX I Program Examples EXAMPLE IN VBA VBA is the programming language built in to many of the more recent Windows applications It is a subset of Visual Basic that makes using OLE Automation Servers and ActiveX Controls very simple The following VBA subroutine demonstrates how easy it is to connect to an X Stream DSO and send remote commands to it Sub LeCroyDSOTest Dim dso As Object Set dso CreateObject LeCroy ActiveDSO 1 Call dso AboutBoxPresent the control s About box Call dso MakeConnection IP 172 25 1 2 Connect to the unit Call dso WriteString DISP ON 1 Enable the internal display routine Call dso WriteString TRMD AUTO 1 Set the trigger mode to AUTO End Sub To enter the VBA editor in members of the Microsoft Office suite 1 Select Tools Macro Visual Basic Editor menu item 2 When the VBA window appears select the Insert Module menu item 3 Copy the above example into the editor window that appears To execute 4 Position the text cursor within the subroutine

Download Pdf Manuals

Related Search

Related Contents

MANUALE USO E MANUTENZIONE Troncatrice per legno  添付文書  USER MANUAL  USER`S MANUAL - Zareba Systems  CM500 High Speed Cable Modem User Manual    Ijoy IDISPLAY9109 Manual - Recambios, accesorios y repuestos    

Copyright © All rights reserved. Failed to retrieve file