Home

Remote Control Manual - DISCONTINUED

1. Unlisten Untalk PC talker DSO listener CMD2 _ D Unlisten Untalk PC listener DSO talker 27 4 INTRODUCTION Notation Example RS 232 C PIN ASSIGNMENTS RS 232 C OPERATION LeCroy oscilloscopes may be remotely controlled using a host ei ther a terminal or a computer via the RS 232 C port For this purpose the oscilloscope must be set at an address higher than 30 using the thumbwheel switch at the rear of the instrument All the commands described in Section 5 are supported but wave form transfer is only possible in HEX mode The default value for COMM_FORMAT is set appropriately The syntax of the re sponse to WF is identical to the GPIB case In this section some special RS 232 C commands are defined ei ther for configuring the oscilloscope or simulating GPIB 488 1 messages such as setting the oscilloscope into remote or local modes Throughout this section characters which cannot be printed in ASCII will be represented by their mnemonics lt LF gt is the ASCII line feed character whose decimal value is 10 lt BS gt is the ASCII backspace character whose decimal value is 8 CTRL_U_ means that the control key and the U key are pressed simultaneously The remote RS 232 C pin assignments indicated on the rear panel are as follows Pin Description 2 T xX D Transmitted data from the oscilloscope 3 RxD Received data to the oscilloscope 4 RTS Request to send from t
2. DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 162 VERT POSITION VPOS Command Query The VERT_POSITION command adjusts the vertical position of the specified trace on the screen The VERT_POSITION com mand does not affect the original offset value obtained at acquisition time The VERT_POSITION query returns the current vertical posi tion of the specified trace lt trace gt Vert_POSition lt display_offset gt lt trace gt EA EB MC MD FE FF lt display_offset gt 56 DIV to 56 DIV Note The suffix DIV is optional lt trace gt Vert_POSition lt trace gt Vert_POSition lt display_offset gt The following command shifts Expand A EA upwards by 3 divi sions relative to the position at the time of acquisition CMD EA VPOS 3DIV CALL IBWRT SCOPE CMD VERT_MAGNIFY System Commands 5 ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB t 4 channel oscilloscopes only VOLT_DIV VDIV Command Query The VOLT_DIV command sets the vertical sensitivity in Volts div The VAB bit bit 2 in the STB register Table 8 page 137 is set if an out of range value is entered Note The probe attenuation factor is not taken into account for adjusting vertical sensitivity The VOLT_DIV query returns the vertical sensitivity of the speci fied channel lt channel gt Volt
3. lt equation gt MC MD FE FF FFT lt source_expr gt REAL FFT lt source_expr gt IMAG FFT lt source_expr gt MAG FFT lt source_expr gt PHASE FFT lt source_expr gt PS FFT lt source_expr gt PSD FFT lt source_expr gt lt source_expr gt lt multiplier gt lt source gt lt addend gt lt source_expr gt lt multiplier gt lt source gt 73 A System Commands QUERY SYNTAX Response Format EXAMPLE GPIB COMMAND SYNTAX FFT Power Average 4 channel oscilloscopes only 74 lt source_expr gt lt source gt lt addend gt lt source_expr gt lt source gt lt multiplier gt 0 001e 33 to 999 999e33 lt addend gt 999 999e33 to 999 999e33 lt source gt EA EB MC MD FE FF C1 C2 C3 C4 lt window_type gt RECT HANN HAMM FLTP BLHA lt off_on gt OFF ON 9410 14 All others lt max_points gt 50 to 10000 50 to 50000 Note The source waveform must be a time domain signal lt function gt DEFine lt function gt DEFine EQN lt equation gt MAXPTS lt max_points gt WINDOW lt window_type gt DCSUP lt off_on gt The following command defines Function E to compute the Power Spectrum of the FFT of Channel 1 Prior to FFT computation Channel 1 is multiplied by 1 018 and 0 055 units of Channel 1 i e Volts is added A maximum of 1000 points will be used for the input The
4. Lines 100 and 110 open the device DEV4 and associate with it the descriptor SCOPE All I O calls from now on will refer to SCOPE The default configuration of the GPIB handler recog nizes DEV4 and associates with it a device with GPIB address 4 If you want to use another GPIB address between 1 and 16 use the string DEVx with x 1 16 If you want to use another name run IBCONF EXE to declare this name to the handler Lines 120 and 130 prepare the command string TDIV and trans fer it to the instrument The command instructs it to respond with the current setting of the time base Line 140 reads the response of the instrument and places it into the character string RDS Line 150 displays the response on the terminal When running this sample program the oscilloscope will automati cally be set to the remote state when IBWRT is executed and will remain in that state Pressing the LOCAL button on the front pan el will return the oscilloscope to local mode if the GPIB handler was modified to inhibit Local LOckout LLO Here is a slightly modified version of the sample program which checks if any error occurred during GPIB operation 17 3 GPIB Operation Some Additional Driver Calls 18 1 99 lt DECL BAS gt 100 DEV DEV4 110 CALL IBFIND DEV SCOPE 120 CMD TDIV 130 CALL IBWRT SCOPE CMD 140 IF ISTA lt 0 THEN GOTO 200 150 CALL IBRD SCOPE RD 160 IF ISTA lt
5. PaNel_SetUp PaNel_SetUp lt setup gt 1 The following instruction saves the instrument s current panel setup in the file PANEL SET FILE PANEL SET CMD PNSU CALL IBWRT SCOPE CMD CALL IBRDF SCOPE FILE 2 The following command recalls the front panel setup stored previously in the file PANEL SET into the oscilloscope CALL IBWRTF SCOPE FILES RCL SAV 113 5 System Commands CURSOR DESCRIPTION 114 PARAMETER_VALUE PAVA Query The PARAMETER_VALUE query returns the current value s of the pulse waveform parameter s for the specified trace Traces do not need to be displayed or selected to obtain the values meas ured by the pulse parameters Pulse parameters cannot be evaluated on waveforms composed of segments acquired in sequence mode However pulse parameters may be applied to individual segments if they are singled out using the expansion function Parameter Names ALL all parameters ALLI all points in TRUE 1 FALSE 0 AMPLI amplitude ANYO any points TRUE 1 FALSE 0 AREA area BASE base CYCL cycles DLY delay DUTY duty cycle FALL falltime FREQ frequency FRST first point LAST last point MAX maximum MEAN mean MIN minimum OVSN negative overshoot OVSP positive overshoot PER period PNTS points PKPK peak to peak RISE _risetime RMS root mean square SDEV standard deviation TOP top WID width See Table 4 in Chapter 7 of Operator
6. The following instruction reads the contents of the URR register CMD URR CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RSP PRINT RSP Response message URR 0 CALL_HOST KEY ALL_STATUS CLS Description no button has been pressed button 1 has been pressed button 2 has been pressed button 3 has been pressed button 4 has been pressed button 5 has been pressed button 6 has been pressed button 7 has been pressed button 8 has been pressed button 9 has been pressed The Call Host key button 10 in root menu has been pressed 0 1 2 3 4 5 6 7 8 9 1 User Request Status Register Structure URR Table 9 System Commands R DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 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 VERT_MAGNIFY query returns the magnification factor of the specified trace lt trace gt Vert_MAGnify lt factor gt lt trace gt EA EB MC MD FE FF lt factor gt 0 2 to 50 maximum lt trace gt Vert_MAGnify lt trace gt Vert_MAGnify lt factor gt The following command enlarges the vertical amplitude of Func tion E by a factor of 3 45 with respect to its original amplitude CMD FE VMAG 3 45 CALL IBWRT SCOPE CMD VERT_POSITION 161 5 System Commands
7. arbitrary data block lt trace gt WaveForm lt block gt lt trace gt EA EB MC MD FE FF C1 C2 C3 C4 lt block gt DESC TEXT TIME DAT1 DAT2 ALL Note If no parameter is given ALL will be assumed System Commands 5 Response format lt trace gt WaveForm lt block gt lt waveform_data_block gt Note It may be convenient to disable the response header if the waveform is to be restored Refer to command COMM_HEADER for further details EXAMPLE GPIB 1 The following command reads the block DAT 1 from Memory C and saves it in the file MEMC DAT The path header MC is saved together with the data FILE MEMC DAT CMD MC WF DAT1 CALL IBWRT SCOPE CMD CALL IBRDF SCOPE FILES 2 In the following example the entire contents of Channel 1 are saved in the file CHAN1 DAT The path header Ci is skipped to ensure that the data can later be recalled into the oscilloscope FILE CHAN1 DAT RD SPACE 3 CMD CHDR SHORT C1 WF CALL IBWRT SCOPE CMD CALL IBRD SCOPE RD Skip first 3 characters C1 CALL IBRDF SCOPE FILE Save data in the file CHANI DAT 3 The following example illustrates how the waveform data saved in example 2 can be recalled into Memory C FILE CHAN1 DAT CMD MC TRACE ON CALL IBWRT SCOPE CMD CALL IBWRTF SCOPE FILES The MC TRACE ON command ensures that the lt trace gt is set
8. count 5 dev4 ibrd lt CR gt enter byte count 10 lt CR gt 0100 cmp count 10 54 44 49 56 20 35 30 45 TDIV 50E 2D 39 9 dev4 ibwrt lt CR gt enter string cl cpl lt CR gt 0100 cmpl count 7 dev4 jbrd lt CR gt enter byte count 20 lt CR gt 2100 end cmpl count 11 43 31 3A 43 50 4C 20 44 C 35 30 0A 5 dev4 q lt CR gt for quitting the program Appendix A A E A _ 7 EXAMPLE 2 GPIB PROGRAM FOR IBM PC HIGH LEVEL FUNCTION CALLS 200 The following BASICA program allows full interactive control of the 9420 24 50 using an IBM PC as GPIB controller It is again assumed that the controller is equipped with a National Instru ments GPIB interface card All the remote control commands listed in Section 5 can be used by simply entering the text string of the command i e c1 vdiv 50 mv without the quotes The pro gram 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 disk if proper drive and file names are provided The command LC returns the oscilloscope to local mode Re sponses sent back by the oscilloscope are interpreted as character strings and are thus limited to a maximum of 255 characters Note 1 It is assumed that the National Instruments GPIB driver GPIB C
9. 1024 from the hexadecimal word 0400 at byte 369 value 0 0 0109 V as stated in the inspect command above If your computer or available software is incapable of understand ing the IEEE floating point values you can find a description of this format in the template see Appendix B The data values in a waveform may not all correspond to measured points The parameters FIRST_VALID_PNT and LAST_VAL ID_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 segment 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 arrays of the result Each vertical data value has a corresponding horizontal position usually measured in time or in frequency units The calculation of this position depends on the type of waveform being examined We will treat separately the single sweep the sequence and the interleaved RIS waveform Each data value has a position 1 in 185 6 Waveform Structure 186 the original waveform with i 0 corresponding to the
10. Key words BITS DITHER MAXPTS REJECT SWEEPS WEIGHT Resolution enhancement bits Enhanced Resolution only Dither Summed Average only Maximum number of points Reject overflow underflow Summed Aver age only Maximum number of sweeps Average and Extrema only Weight Continuous Average only lt function gt DEFine EQN lt equation gt MAXPTS lt max_points gt SWEEPS lt max_sweeps gt DITHER lt off_on gt REJECT lt off_on gt WEIGHT lt weight gt BITS lt bits gt lt function gt MC MD FE FF lt equation gt AVGS lt source gt Summed Average lt equation gt AVGC lt source gt Continuous Average lt equation gt lt paren_source_expr gt Identity lt equation gt lt paren_source_expr gt Identity lt equation gt lt paren_source_expr gt Negation lt equation gt 1 lt paren_source_expr gt Reciprocal lt equation gt lt paren_source_expr gt lt source gt Addition lt equation gt lt paren_source_expr gt lt source gt Subtraction lt equation gt lt paren_source_expr gt lt source gt Multiplication lt equation gt lt paren_source_expr gt lt source gt Ratio lt equation gt EXTR lt source gt Extrema R F t 4 channel oscilloscopes only System Commands 5 lt equation gt FLOOR EXTR lt source gt Floor lt equation gt ROOF EXTR lt source gt Roof lt equation gt SQR lt source_exp
11. RQS if serial polling Is conducted 2 Example If SRE 10 and STB 10 then MSS 1 If SRE 010 and STB 100 then MSS 0 3 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 4 The Message AVallable bit MAV indicates whether or not the Output queue is empty The MAV summary bit is set true 1 whenever a data byte resides in the Output queue 5 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 time base is redefined as 2 5 usec div since the adapted value is 2 pisec div 6 The INternal state Bit INB is set true 1 whenever certain enabled internal states are entered For further information refer to the INR query 137 be System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX EXAMPLE RELATED COMMANDS 138 STOP Command The STOP command immediately stops the acquisition of a signal It changes the acquisition state from ready to triggered and if the trigger mode is AUTO or NORM it will change to trigger mode SINGLE to prevent further acquisition STOP The following command stops the acquisition process CMD STOP CALL IBWRT SCOPE CMD ARM_ACQUISITION TRIG_MODE W
12. The following example turns dual zoom on CMD DZOM ON CALL IBWRT SCOPE CMDS HOR_MAGNIFY HOR_POSITION MULTI_ZOOM ZOOM 79 5 System Commands STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 80 ESE Command Query The ESE command sets the standard Event Status Enable regis ter 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 Table 5 page 82 The ESE query reads the contents of the ESE register Note This command can be executed in both local and remote modes ESE lt value gt lt value gt 0 to 255 ESE ESE lt value gt The following command allows the ESB bit to be set if a user re quest 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 CMD ESE 72 CALL IBWRT SCOPE CMD ESR System Commands 5 SL ow STATUS ESR Query DESCRIPTION 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 Refer to Table 5 page 82 for an overview of the ESR register structure QUERY SYNTAX ESR Response format ESR lt value gt lt value gt
13. WAVEFORM TRANSFER DESCRIPTION COMMAND SYNTAX QUERY SYNTAX t 4 channel oscilloscopes only 166 WAVEFORM WF Command Query A WAVEFORM query transfers a waveform from the oscillo scope to the controller whereas a WAVEFORM command transfers a waveform from the controller to the oscilloscope The WAVEFORM command stores an external waveform back into the oscilloscope s internal memory A waveform consists of several distinct entities 1 the descriptor DESC 2 the user text TEXT 3 the time TIME descriptor 4 the data DAT1 block and optionally 5 a second block of data DAT2 For further information on the structure of the waveform refer to Section 6 In the 9424 the WAVEFORM command automatically sets the corresponding function to the memory state Note Only complete waveforms queried with WAVEFORM ALL can be restored into the oscilloscope The WAVEFORM query instructs the oscilloscope to transmit a waveform to the controller The entities may be queried independ ently If the ALL parameter is specified all 4 or 5 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 command the last COMM_ORDER command and the last COMM_FORMAT command lt memory gt WaveForm ALL lt waveform_data_block gt lt memory gt MC MD FEf FFT lt waveform_data_block gt
14. lt CR gt lt LF gt END lt CR gt lt LF gt 58 System Commands 5 ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB 4 channel oscilloscopes only COUPLING CPL Command Query The COUPLING command selects the coupling mode of the speci fied input channel The COUPLING query returns the coupling mode of the speci fied channel lt channel gt CouPLing lt coupling gt lt channel gt C1 C2 C3 C4 lt coupling gt A1M D1M D50 GND lt channel gt CouPLing lt channel gt CouPLing lt coupling gt The following command sets the coupling of Channel 2 to 50 Q DC CMD C2 CPL D50 CALL IBWRT SCOPE CMD 59 5 System Commands CURSOR DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 60 CURSOR_MEASURE CRMS Command Query The CURSOR_MEASURE command specifies the type of cursor to be displayed The CURSOR _MEASURE query indicates which cursors are currently displayed Notation HABS Horizontai absolute HREL Horizontal relative VABS Vertical absolute VREL Vertical relative PARAM Parameters OFF Cursors off PASS Pass test FAIL Fail test SHOW Extended parameters display Note The PARAM mode is turned OFF when the XY mode is ON CuRsor_MeaSure lt mode gt lt mode gt HABS VABS HREL VREL PARAM OFF PASS FAIL SHOW CuRsor_MeaSure CuRsor_MeaSure
15. lt command query gt gt lt command query gt lt terminator gt Upper and or lower case characters can be used for program mes sages The instrument does not decode an incoming program message before a terminator has been received exception if the program message is longer than the 256 byte input buffer of the instrument the oscilloscope starts analyzing the message when the buffer is full The commands or 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 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 pro grams The lt NL gt lt EOI gt terminator is always used in response messages sent by the instrument to the controller In RS 232 C the terminator may be defined by the user with the command COMM_RS232 The default value is lt CR gt i e the ASCII carriage return character the decimal value of which is 13 2 About Remote Control Examples COMMAND QUERY FORM Example Header GRID DUAL This program message consists
16. 1 2 Index D Data Arrays 179 180 ASCII forms 7 9 Blocks 179 Formatting 181 183 188 HEX mode 29 33 182 188 Horizontal position 185 187 Interpretation 182 185 Sparsing 188 Time of 185 187 Values 181 183 186 DATE Command Query 64 DDR Device Dependent error status Regis ter 196 DDR Query 65 66 DEFINE DEF Command Query Oscillo scopes fitted with WP01 69 72 DEFINE DEF Command Query Oscillo scopes fitted with WP02 73 75 DEFINE DEF Command Query Standard Oscilloscopes 67 68 DELETE_FILE DELF Command 76 Descriptor Block 179 183 Values 181 183 Diagnostics Help Messages 4 DIRECTORY_LIST DIR Query 77 DISPLAY DISP Command Query 78 DUAL 180 181 DUAL_ZOOM DZOM Command Query 79 E Error Messages 4 ESE Command Query 80 ESE Standard Event Status Enable regis ter 20 191 193 195 ESR Query 81 82 ESR Standard Event Status Register 20 191 194 EXR EXecution error Register 191 196 EXR Query 83 84 F FORMAT_CARD FCRD Command Query 85 FUNCTION_RESET FRST Command 87 FUNCTION_STATE FSTA Command Query 9424 only 88 89 G GPIB 11 Address switches 3 12 25 ATN ATteNtion 12 Data lines 12 DCL Device CLear 13 14 EOI End Or Identify 5 13 GET Group Execute Trigger 14 19 GTL Go To Local 14 18 Handshake lines 12 Hard copies 25 27 Hardware Configuratio
17. Austin Texas 78727 15 3 GPIB Operation Simple Transfers 16 The following files in the sub directory GPIB PC are of particular use IBIC EXE allows interactive control of the GPIB via functions en tered at the keyboard Use of this program is highly recommended to anyone who is not familiar with GPIB programming or with the oscilloscope s remote commands An example of the use of IBIC EXE is shown in Appendix A DECL BAS is a declaration file that contains code to be included at the beginning of any BASICA application program Simple application programs can be quickly written by appending the user s instructions to DECL BAS and executing the complete file IBCONF EXE is an interactive program which allows inspection or modification of the current settings of the GPIB handler To run IBCONF EXE refer to the National Instruments user s manual In the program examples in this section it is assumed that the National Instruments GPIB driver GPIB COM is in its default State i e that the user has not modified it with IBCONF EXE This means that the interface board can be referred to by the sym bolic name GPIBO and that devices on the GPIB bus with addresses between 1 and 16 can be called by the symbolic names DEV to DEV16 Note If you have a National Instruments PC2 interface card rath er than PC2A you must run IBCONF to declare the presence of this card rather than the default PC2A For a large num
18. lt trace gt MC MD FE FF C1 C2 C34 C4 QUERY SYNTAX lt exp_trace gt ZOOM Response format lt exp_trace gt ZOOM lt trace gt EXAMPLE GPIB The following example selects Memory C MC as the source for Expand B EB CMD EB ZOOM MC CALL IBWRT SCOPE CMD RELATED COMMANDS DUAL_ZOOM 4 channel oscilloscopes only 177 REMOTE CONTROL INDEX OF GPIB COMMANDS Full Command ALL_STATUS ARM_ACQUISITION ATTENUATION AUTO_CALIBRATE AUTO_SETUP BANDWIDTH_LIMIT BUZZER CAL CALL_HOST CLS CMR COMM_FORMAT COMM_HEADER COMM_HELP COMM_ORDER COMM_RS232 COUPLING CURSOR_MEASURE CURSOR_SET CURSOR_ VALUE DATE DDR DEFINE DELETE_FILE DIRECTORY LIST DISPLAY DUAL_ZOOM ESE ESR EXR FORMAT_CARD FUNCTION RESET FUNCTION_STATE GRID HARDCOPY_SETUP HARDCOPY TRANSMIT HOR_MAGNIFY HOR_POSITION IDN INE INR INSPECT INTENSITY INTERLEAVED IST KEY MESSAGE MULTI_ZOOM OFFSET OPC OPT PANEL_SETUP PARAMETER_VALUE 178 Abbrev ALST ARM ATTN ACAL ASET BWL BUZZ CAL CHST CLS CMR CFMT CHDR CHL CORD CORS CPL CRMS CRST CRVA DATE DDR DEF DELF DIR DISP DZOM ESE ESR EXR FCRD FRST FSTA GRID HCSU HCTR HMAG HPOS IDN INE INR INSP INTS ILVD ST KEY MSG MZOM OFST OPC OPT PNSU PAVA Page 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 58 59 60 61 62 63 64 65 66 67
19. lt trig_condi tion gt The following command configures the logic state of the pattern as HLX CH1 H CH2 L EX X and defines the trigger con dition as pattern absent AB CMD TRPA H L X AB CALL IBWRT SCOPE CMD TRIG_SELECT 153 5 System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 154 TRIG_PATTERN TRPA 4 channel oscilloscopes without external trigger Command Query The TRIG_PATTERN command defines a trigger pattern The command specifies the logic composition of the pattern sources Channel 1 Channel 2 and Channel 4 and the conditions under which a trigger can occur Note that this command can be used even if the complex trigger mode has not been activated Notation Low High Don t Care pattern present AB pattern absent pattern entered EX pattern exited The TRIG_PATTERN query returns the current trigger pattern TRig_PAttern lt C1_state gt lt C2_state gt lt C4_state gt lt trig_condi tion gt lt C1_state gt L H X lt C2_state gt L H X lt C4 state gt L H X lt trig_condition gt PR AB EN EX TRig_ PAttern TRig_PAttern lt C1_state gt lt C2_state gt lt C4_state gt lt trig_condi tion gt The following command configures the logic state of the pattern as HLX CH1 H CH2 L CH4 X and defines the trigger con dition as pattern absent AB CMD TR
20. they are in the following sequence the basic descriptor block WAVEDESC the history text descriptor block USERTEXT may or may not be present the time array block for RIS and sequence acquisitions only data array block auxiliary or second data array block With the exception of the data and time arrays every block starts with an 8 character name which identifies which kind of block it is In the following explanation every element of a block is described by a Single line in the form lt byte position gt lt variable name gt lt variable type gt lt comment gt where lt byte position gt position in bytes decimal offset of the variable relative to the beginning of the block lt variable name gt name of the variable lt variable type gt string up to 16 character name terminated with a null byte byte 8 bit signed data value 205 Appendix B OOO el 206 word long float double enum time_stamp data text 16 bit signed data value 32 bit signed data value 32 bit IEEE floating point value with the format shown below 31 30 23 22 ive 0 bit position S 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 6 127 1 f 64 bit IEEE floating point value with the format shown below 63 62 52 S1 ass 0 bit position S exponent fraction where s sign of th
21. 0 to 10 DIV lt segment gt 1 to 200 Note I The suffix DIV is optional Note 2 The segment number is only relevant for waveforms ac quired in sequence mode The segment number is ignored in single waveform acquisitions 95 5 System Commands QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 96 lt exp_trace gt Hor_POSition lt exp_trace gt Hor_POSition lt hor_position gt lt segment gt Note The segment number is only given for sequence waveforms The following example positions the center of the intensified zone on the trace currently viewed by Expand A EA at division 3 CMD EA HPOS 3 CALL IBWRT SCOPE CMD DUAL_ZOOM ZOOM System Commands 5 MISCELLANEOUS IDN Query DESCRIPTION The IDN query is used for identification purposes The response consists of four different fields providing information on the manu facturer the scope model the serial number and the firmware revision level QUERY SYNTAX IDN Response format IDN LECROY lt model gt lt serial_number gt lt firmware_level gt lt model gt 5 character model identifier lt serial number gt an 8 digit decimal code 94xxxxxx lt firmware_level gt 2 digits giving the release level followed by a period and a 1 digit update level xx y EXAMPLE GPIB This example issues an identification request to the scope CMD IDN CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP
22. 0 to 255 EXAMPLE GPIB The following instruction reads and clears the contents of the ESR register CMD ESR CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message ESR 0 RELATED COMMANDS ALL_STATUS CLS ESE 81 by System Commands Bit Value Bit Name Description Reserved by IEEE 488 2 a Power off to ON transition has occurred a User ReQuest has been issued a CoMmand parser Error has been found an Execution Error has been detected a Device Specific Error has occurred a QueRy Error has occurred The Instrument never requests bus control The OPeration Complete bit is not used Standard Event Status Register ESR Table 5 Notes 1 The Power On PON bit Is always turned on 1 when the unit is powered up 2 The User Request URQ bit is set true 1 when a soft key is pressed An associated register URR Identifies which key was selected For further detalis refer to the URR query 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 4 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 Tne EXE bit has an assoclated Execution Error Register EXR which specifies the error code
23. 1 GET Group Execute Trigger message TRG The following command enables signal acquisition CMD TRG CALL IBWRT SCOPE CMD ARM_ACQUISITION STOP WAIT System Commands 5 ACQUISITION TRIG_COUPLING TRCP Command Query DESCRIPTION The TRIG_COUPLING command sets the coupling mode of the specified trigger source The trigger slope is automatically changed to positive when the trigger coupling is set to HFDIV Note HFDIV is indicated as HF on the front panel See the Oper ator s Manual Section 5 9424 or Section 6 9450 20 The TRIG_COUPLING query returns the trigger coupling of the selected source COMMAND SYNTAX lt trig_source gt TRig CouPling lt trig_coupling gt C1 C2 EX EX10 C1 C2 EX EX10 c1 C2 04 C1 C2 EX lt trig_coupling gt AC DC HFREJ LFREJ AC DC HFREJ LFREJ HFDIV QUERY SYNTAX lt trig_source gt TRig_CouPling Response format lt trig_source gt TRig_CouPling lt trig_coupling gt EXAMPLE GPIB The following command sets the coupling mode of the trigger source Channel 2 to high frequency reject CMD C2 TRCP HFREJ CALL IBWRT SCOPE CMD RELATED COMMANDS TRIG_SELECT 149 5 System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 150 TRIG_DELAY TRDL Command Query The TRIG_DELAY command sets the time at which the trigger is to occur with respect to the first ac
24. 200 CALL IBWRT SCOPE CMD INSPECT WAVEFORM TEMPLATE 169 by System Commands WAVEFORM TRANSFER DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 4 channel oscilloscopes only 170 WAVEFORM _TEXT WFTX Command Query The WAVEFORM_TEXT command is used to document the con ditions under which a waveform has been acquired The text buffer is limited to 400 characters The WAVEFORM_TEXT query returns the text section of the specified trace lt trace gt WaveForm_TeXt lt text gt lt trace gt EA EB MC MD FE FF C1 C2 C3 C4 lt text gt An ASCII message max 400 characters long lt trace gt WaveForm_TeXt lt trace gt WaveForm_TeXt lt text gt The following example shows how to document Function E FE MSG Averaged pressure signal Experiment carried out Oct 15 88 CMD FE WFTX MSG CALL IBWRT SCOPE CMD INSPECT WAVEFORM TEMPLATE System Commands 5 DISPLAY XY_ASSIGN XYAS Command Query DESCRIPTION The XY_ASSIGN command assigns traces to the X and Y axis to create an X versus Y display The XY_ASSIGN query returns the traces currently assigned to the XY display If there is no trace assigned to the X axis and or the Y axis the value UNDEF will be returned instead of the trace name COMMAND SYNTAX XY_ASsign lt X_source gt lt Y_source gt lt X_source gt EA EB MC M
25. 56 58 Command Execution 37 Command Notation 37 38 Command Summary 35 37 Commands ALL_STATUS ALST 39 ARM_ACQUISITION ARM 40 ATTENUATION ATTN 41 AUTO_CALIBRATE ACAL 42 AUTO_SETUP ASET 43 BANDWIDTH_LIMIT BWL 44 BUZZER BUZZ 45 CAL 46 CALL_HOST CHST 47 CLS 48 CMR 49 COMM_FORMAT CFMT 50 51 COMM_HEADER CHDR 52 COMM_HELP CHLP 53 COMM_ORDER CORD 54 55 COMM_RS232 CORS 56 58 COUPLING CPL 59 CURSOR_MEASURE CRMS 60 CURSOR_SET CRST 61 62 CURSOR_VALUE CRVA 63 DATE 64 DDR 65 66 DEFINE DEF Oscilloscopes fitted with WP01 69 72 DEFINE DEF Oscilloscopes fitted with WP02 73 75 DEFINE DEF Standard Oscilloscopes 67 68 DELETE FILE DELF 76 DIRECTORY_LIST DIR 77 DISPLAY DISP 78 DUAL_ZOOM DZOM 79 ESE 80 ESR 81 82 EXR 83 84 FORMAT_CARD FCRD 85 FUNCTION_RESET FRST 87 FUNCTION_STATE FSTA 9424 only 88 89 GRID 90 HARDCOPY_ SETUP HCSU 91 92 HARDCOPY_TRANSMIT HCTR 93 Index paS HOR_MAGNIFY HMAG 94 HOR_POSITION HPOS 95 96 IDN 97 INE 98 INR 99 INSPECT INSP 100 101 INTENSITY INTS 102 INTERLEAVED ILVD 103 IST 104 KEY 105 106 MESSAGE MSG 107 MULTI_ZOOM MZOM 108 OFFSET OFST Command Query 109 110 OPC 111 OPT 112 PANEL_SETUP PNSU 113 PARAMETER_VALUE PAVA 114 115 PASS_FAIL_CONDITION PFCO 116 PASS_FAIL_COUNTER PFC
26. 65535 The following instruction reads the contents of all the status regis ters CMD ALST CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message ALST STB 000000 ESR 000052 INR 000005 DDR 000000 EXR 000024 CMR 000004 URR 000000 CLS CMR DDR ESR EXR STB URR 39 5 System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX EXAMPLE RELATED COMMANDS 40 ARM_ACQUISITION ARM Command The ARM_ACQUISITION command enables the signal acquisi tion process by changing the acquisition state from triggered to ready ARM_acquisition The following command enables signal acquisition CMD ARM CALL IBWRT SCOPE CMD STOP TRG TRIG_MODE WAIT ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB 4 channel oscilloscopes only System Commands 5 ATTENUATION ATTN Command Query The ATTENUATION command selects the vertical attenuation factor of the probe Values of 1 10 100 1000 or 10000 may be specified The ATTENUATION query returns the attenuation factor of the specified channel lt channel gt ATTeNuation lt attenuation gt lt channel gt Ci C2 C3 C4 lt attenuation gt 1 10 100 1000 10000 lt channel gt ATTeNuation lt channel gt ATTeNuation lt attenuation gt The following command sets the attenuation factor of channel 1 to 100 CMD C1 ATTN 100 CALL
27. 7 plus 32 bit 5 See Table 5 page 82 for a description of the conditions corresponding to the bits set The Power ON bit appears only on the first ESR query after power on because the query clears the register The type of com mand error can be determined by reading the Command Error Status Register with the query CMR Note that it is not neces sary to read and simultaneously clear this register in order to be able to set the CMR bit in the ESR on the next command error Status Registers 7 STANDARD EVENT STATUS ENABLE REGISTER ESE Example SERVICE REQUEST ENABLE REGISTER SRE PARALLEL POLL ENABLE REGISTER PRE Example INTERNAL STATE CHANGE STATUS REGISTER INR The ESE allows one or more events in the Standard Event Status Register to be reported to the ESB summary bit in the STB The Standard Event Enable Register is modified with the com mand ESE It is cleared with the command ESE 0 or after power on It may be read with the query ESE ESE 4 sets bit 2 i e binary 4 of the standard event enable register enabling query errors to be reported The Service Request Enable Register specifies which summary bit s in the Status Byte Register will cause a service request The Service Request Enable Register consists of 8 bits Setting a bit in the register allows the summary bit located at the same bit position in the Status Byte Register to generate a s
28. Execution Error Status Register contains the code of the last execution error detected by the instrument Execution error codes are listed with the command EXR in Section 5 The Execution Error Status Register may be read via the query EXR The response is the error code The register is cleared with a EXR or ALST query a CLS command or after power on USER REQUEST STATUS REGISTER URR The URR contains the identification code of the last menu button which was pressed The codes are listed with the command URR in Section 5 196 Status Registers T The User Request Status Register may be read via the query URR The response is the decimal code associated with the selected menu button The register is cleared with a URR or ALST query a CLS command or after power on 197 APPENDIX A EXAMPLE 1 USE OF THE INTERACTIVE GPIB PROGRAM IBIC This example assumes the use of an IBM PC or a compatible comput er equipped with a National Instruments GPIB interface card It also assumes that the GPIB driver is left in the default state so that the device name dev4 corresponds to the GPIB address 4 which is as sumed to be the address of the oscilloscope All text entered by the user is underlined ibic lt CR gt program announces itself enter board device name devy4 lt CR gt dev4 ibwrt lt CR gt enter string tdiy lt CR gt 0100 cmpl
29. Function E FE has been defined as the summed average of Channel 1 the following example will restart the aver aging process CMD FE FRST CALL IBWRT SCOPE CMD RELATED COMMANDS DEFINE INR t 4 channel oscilloscopes only 5 System Commands FUNCTION DESCRIPTION COMMAND SYNTAX t 4 channel oscilloscopes only 88 FUNCTION_STATE FSTA Command Query The FUNCTION_STATE command allows the user to control or enquire how Functions C D E and F are being used The four waveform processing functions may assume up to three different states MEM static memory of a waveform no further automatic pro cessing occurs ZOOM expansion of another waveform updated as the source changes FUNC a mathematical function of one or two other waveforms updated if one of the sources change The two Functions C and D may assume all three states whereas E and F may assume only the states MEM and FUNC The setup information needed to execute expansions or mathematical wave form processing is memorized separately by the oscilloscope for each function When the state of a function is changed the last setup information associated with the new state will be reactivated There are three other commands which may cause a State transi tion The command ZOOM applied to Functions C or D will automatically switch them into zoom state The commands STORE storage from internal waveform and WAVEFORM storage from external wavef
30. IBWRT SCOPE CMD 41 5 System Commands MISCELLANEOUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 42 AUTO_CALIBRATE ACAL Command Query The AUTO_CALIBRATE command is used to enable or disable automatic calibration of the instrument At power up auto cali bration is turned ON i e all input channels are periodically calibrated for the current input amplifier and time base settings The automatic calibration may be disabled by issuing the com mand ACAL OFF Whenever it is convenient a CAL query may be issued to fully calibrate the oscilloscope When the oscillo scope is returned to local control the periodic calibrations will be resumed The response to the AUTO_CALIBRATE query indicates whether auto calibration is enabled Auto_CALibrate lt state gt lt state gt ON OFF Auto_CALibrate Auto_CALibrate lt state gt The following instruction disables auto calibration CMD ACAL OFF CALL IBWRT SCOPE CMDS CAL ACQUISITION DESCRIPTION COMMAND SYNTAX EXAMPLE System Commands 5 AUTO_SETUP ASET Command The AUTO_SETUP attempts to display the input signal s by ad justing the vertical time base and trigger parameters Auto setup operates only on the channels whose traces are currently turned on The only exception occurs when no traces are turned on in which case AUTO_SETUP operates on all channels and turns
31. KEY 3 key 3 line 2 L2 KEY 4 key 4 line 1 LI KEY 4 key 4 line 2 L2 KEY 5 key 5 center LC KEY S between 5 6 LB KEY 6 key 6 center LC KEY 9 Exit LC URR DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB System Commands by MESSAGE MSG Command Query The MESSAGE command displays a string of characters in the Message Field above the grid The string may be up to 45 charac ters in length The string is displayed as long as the instrument is in remote mode and no internal status message is generated Turning the oscilloscope back to local mode deletes the message After the next transition from local to remote the message will be redisplayed The message is cleared at power up when the RESET button on the rear panel is pressed or if an empty string is sent MSG The MESSAGE query allows the user to read the last message which was sent Note This command can be executed in both local and remote modes MeSsaGe lt string gt lt string gt a string of max 45 characters MeSsaGe MeSsaGe lt string gt The following code causes the message Connect Probe 1 to appear in the message field CMD MSG Connect Probe 1 CALL IBWRT SCOPE CMDS 107 5 System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 1
32. PA0 0 PD LBData from Oct 15 O3IN SP0 PA0 0 CALL IBWRT SCOPE CMD HARDCOPY_SETUP SCREEN _DUMP 93 5 System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 4 channel oscilloscopes only 94 HOR_MAGNIFY HMAG Command Query The HOR_MAGNIFY command horizontally expands the se lected expansion trace by a specified factor Magnification factors which are not within the range of permissible values will be rounded to the closest legal value If multiple zoom is enabled the magnification factor for all expan sion traces is set to the specified factor If the specified factor is too large for any of the expanded traces depending on their current source it is reduced to an acceptable value and only then applied to the traces The VAB bit bit 2 in the STB register Table 8 page 137 is set if 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 EA EB MCt MD 9410 14 All others lt exp_source gt Hor_MAGnify lt exp_source gt Hor_MAGnify lt factor gt The following example horizontally magnifies Expand B EB by a factor of 5 CMD EB HMAG 5 CALL IBWRT SCOPE CMD DUAL_ZOOM ZOOM DISPLAY DESCRIPTION COMMAND SYNTAX t 4 channel oscilloscope
33. Refer to Section 6 for further information QUERY SYNTAX TeMPLate Response format TeMPLate lt template gt lt template gt A variable length string detailing the structure of a waveform RELATED COMMANDS INSPECT 144 System Commands 5 ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format t 2 ns div for Model 9430 TIME_DIV TDIV Command Query The TIME_DIV command modifies the time base setting The new time base setting may be specified with suffixes NS for nanoseconds US for microseconds MS for milliseconds S for seconds or KS for kiloseconds An out of range value causes the VAB bit bit 2 in the STB register Table 8 STB to be set The oscilloscope will force random interleaved sampling RIS for time base settings in the ON only range and single shot sam pling for time base settings in the OFF only range For time base settings in the Selectable range the INTERLEAVED command allows the user to choose the required sampling mode 2 ns div 1 ns div 1 ns div to 5 ns div to to 20 ns div 20 ns div Selectable 50 ns div 50 ns div 10 ns div ON OFF to to to 5 us div 20 us div 5 ps div OFF 10 us div 50 us div 10 us div only to to to 1000 s div 5000 s div 5000 s div Sequence mode acquisitions also force single shot sampling and therefore cannot be performed for time base settings in the RIS ON onl
34. 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 or execution time such as a channel overload condition a trigger or a time base circuit defect The origin of the failure may be localized via the DDR or the self test TST query 6 The Query Error bit QYE Is set true 1 whenever a an attempt Is being 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 query was read output buffer flushed 7 The ReQuest Control bit RQC is always false 0 since the oscilloscope has no GPIB controlling capability 8 The OPeration Complete bit OPC is set true 1 whenever OPC has been recelved since commands and queries are strictly executed In sequential order The oscilloscope starts processing a command only once the previous command has been entirely executed 82 System Commands 5 STATUS EXR Query DESCRIPTION The EXR query reads and clears the contents of the EXecution error Register EXR The EXR register specifies the type of the last error detected during execution Refer to Table 6 page 84 for further details QUERY SYNTAX EXR Response format EX
35. Response message IDN LECROY 9450_ 94501153 02 2 97 5 System Commands STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 98 INE Command Query The INE command sets the Internal state change Enable register INE This command allows one or more events in the INR regis ter 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 Table 7 page 99 The INE query reads the contents of the INE register Note This command can be executed in both local and remote modes INE lt value gt lt value gt 0 to 65 535 INE INE lt value gt The following command allows the INB bit to be set whenever a screen dump has finished bit 1 i e decimal 2 and or a waveform has been acquired bit 0 i e decimal 1 Summing these two val ues yields the INE mask 2 1 3 CMD INE 3 CALL IBWRT SCOPE CMDS INR System Commands 5 STATUS INR Query DESCRIPTION The INR query reads and clears the contents of the INternal state change Register INR The INR register Table 7 keeps track of the completion of various internal operations and state transitions QUERY SYNTAX INR Response format INR lt state gt lt state gt 0 to 65535 EXAMPLE GPIB The following instruction reads the contents of the INR register CMD INR CALL IBWRT SCOPE CMD Response message INR
36. a waveform For an acquisition with 42 points we get 1 71875e 02 2 03125e 02 2 03125e 02 2 6562 5e 02 3 9062 5e 02 4 5312 5e 02 5 15625e 02 5 15625e 02 6 71875e 02 6 71875e 02 7 65625e 02 7 96875e 02 9 2187 5e 02 9 53125e 02 1 04687e 01 1 04687e 01 1 20312e 01 1 20312e 01 1 26562e 01 1 29688e 01 1 42187e 01 1 51562e 01 1 54687e 01 1 57812e 01 1 70312e 01 1 73437e 01 1 70312e 01 1 76563e 01 These numbers are the fully converted measurements in volts Of course when the data block contains thousands of items the string will contain many lines Depending on the application you may prefer to have the data in its raw form as either a BYTE 8 bits or a WORD 16 bits for each data value In this case you must use the relations given below in association with the WAVEFORM command to interpret the measurement The command might then Say INSPECT SIMPLE BYTE The examination of data values for waveforms with two data arrays can be done 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 It is also possible to examine just a part of the waveform or a sparsed form of the waveform This is controlled with the WAVE FORM_SETUP command mentioned later in this section The INSPECT command has only a query form It cannot be used to send a waveform back into the osci
37. and the input coupling of Channel 1 to 50 Q Whenever a response is expected from the instrument the control program must instruct the GPIB or RS 232 C interface to read from the instrument If the controller sends another program mes sage without reading the response to the previous one the response message in the output buffer of the instrument is dis carded The instrument uses somewhat stricter rules for response messages than for the acceptance of program messages Whereas the con troller may send program messages in upper or lower case characters response messages are always returned in upper case Program messages may contain extraneous spaces or tabs white space response messages do not Whereas program messages may contain a mixture of short and long command query headers response messages always use short headers as a default However the instrument can be forced with the command COMM_HEADER to use long headers or no headers at all If the response header is omitted the response transfer time is mini mized but such a response could not be sent back to the instrument again In this case suffix units are also suppressed in the response If the trigger slope of Channel 1 is set to negative the query C1 TRSL could yield the following responses C1 TRIG_SLOPE NEG header format long C1 TRSL NEG header format short NEG header format off Waveforms which are obtained from the instrument using the query W
38. better transfer and decod ing speed The two forms are fully equivalent and can be used interchangeably For example the following two commands for switching to the automatic trigger mode are fully equivalent TRIG_MODE AUTO and TRMD AUTO About Remote Control 2 Header path Example Data Some command query mnemonics are imposed by the IEEE 488 2 standard They are standardized so that different instru ments present the same programming interface for similar functions All these mnemonics begin with an asterisk lt gt e g the command RST is the IEEE 488 2 imposed mnemonic for resetting the instrument whereas TST instructs the instru ment to perform an internal self test and to report the outcome Some commands or queries apply to a sub section of the oscillo scope e g a single input channel or a trace on the display In such cases the header must be preceded by a path name that indicates the channel or trace to which the command applies The header path normally consists of a 2 letter path name followed by a colon lt gt which immediately precedes the command header Usually one of the waveform traces can be specified in the header path refer to the individual commands listed in Section 5 for de tails on which values apply to a given command header C1 C2 Channels 1 and 2 C3 C4 Channels 3 and 4 in 4 channel instruments MC MD Memory C and D FE FF Function E and F EA EB Expand A and
39. data is given in the WAVEDESC descriptor by the COMM TYPE variable 215 Appendix B 00 ENDARRAY A SS e e a y a a g es ee DUAL ARRAY Explanation of the DUAL array This data block is repeated for each pair of computed data points composing respectively the first and second data array of a waveform e g the real and imaginary parts of an FFT lt 0 gt MEASUREMENT_1 data data in the first data array the actual format of a data is given in the WAVEDESC descriptor by the COMM_TYPE variable lt 0 gt MEASUREMENT_2 data data in the second data array the byte offset depends on the actual format of the data which is given in the WAVEDESC descriptor by the COMM_TYPE variable 00 ENDARRAY 000000 ENDTEMPLATE 39 216 INDEX A ALL_STATUS ALST Query 39 ARM_ACQUISITION ARM Command 40 Assistance 1 ATTENUATION ATTN Command Query 41 AUTO_CALIBRATE ACAL Command Query 42 AUTO_SETUP ASET Command 43 B BANDWIDTH_LIMIT BWL Command Query 44 BASIC A 15 22 181 200 Binary Blocks 183 BUZZER BUZZ Command 45 C CAL Query 46 CALL_HOST CHST Command Query 47 CLS Command 48 CMR CoMmand error Register 191 193 194 196 CMR Query 49 COMM_FORMAT CFMT Command Query 50 51 COMM_HEADER CHDR Command Query 52 COMM_HELP CHLP Command Query 53 COMM_ORDER CORD Command Query 54 55 COMM_RS232 CORS Command Query
40. gt whose decimal value is 27 followed by another character Such commands are interpreted as soon as the second character has been received Note The RS 232 C baud rate parity character length and number of stop bits are among the parameters that are saved or recalled by the front panel SAVE or RECALL button or by the remote commands SAV RCL or PANEL SETUP When recalling care must be taken to ensure that these parame ters are set at the same value as the actual ones Otherwise the host may no longer be able to communicate with the oscilloscope and a manual reconfiguration would be necessary The serial port may echo the received characters Echo is useful if the oscilloscope is attached to a terminal Echoing can be turned on or off by sending the two character sequence lt ESC gt or lt ESC gt respectively Echoing is on by default Note The host must not echo characters received from the oscillo scope When the oscilloscope input buffer becomes almost full the in strument sends a handshake signal to the host telling it to stop transmitting When this buffer has enough room to receive more characters another handshake signal will be sent The handshake signals are either the CTRL S or lt XOFF gt and CTRL Q lt XON gt characters or a signal level on the RTS line pin 4 This is selected by sending the two character sequence lt ESC gt for XON XOFF handshake this is the default
41. is usually much more efficient to enable propagation of the errors of interest into the STB with the enable registers ESE and INE A command error CMR sets bit 5 of ESR if bit 5 of ESE is set ESB of STB is also set if bit 5 of SRE is set MSS RQS of STB is also set and a Service Request is generated The Status Byte Register is the instrument s central reporting struc ture The STB is composed of 8 single bit summary messages of which 3 are unused which reflect the current status of the asso ciated data structures implemented in the instrument Bit 0 is the summary bit INB of the Internal State Change Register It is set if any of the bits of the INR are set provided that they are enabled by the corresponding bit of the INE register 193 7 Status Registers STANDARD EVENT STATUS REGISTER ESR Example 194 Bit 2 is the Value Adapted Bit indicating that a parameter value was adapted during a previous command interpretation Bit 4 is the Message Available MAV bit indicating that the in terface output queue is not empty Bit 5 of STB is the summary bit ESB of the Standard Event Status Register It is set if any of the bits of the ESR are set provided that they are enabled by the corresponding bit of the ESE register Bit 6 of the Status Byte Register STB is alternatively called the Master Summary Status bit MSS or the Request for Service bit RQS because the STB can be read in two different ways
42. lt mode gt The following command switches on the vertical relative cursors CMD CRMS VREL CALL IBWRT SCOPE CMD The following command determines which cursor is currently turned on CMDS CRMS CALL IBWRT SCOPE CMD CALL IBRD SCOPE RD PRINT RD Example of response message CRMS OFF CURSOR_MEASURE CURSOR_SET PASS_FAIL_COUNTER PASS_FAIL_DO PASS_FAIL_MASK PARAMETER_VALUE CURSOR DESCRIPTION 4 channel oscilloscopes only System Commands A CURSOR_SET CRST Command Query The CURSOR_SET command allows the user to position any one of the eight independent cursors at a given screen location The positions of the cursors can be modified or queried even if the required cursor is not currently displayed on the screen When setting a cursor position a trace must be specified relative to which the cursor will be positioned The CURSOR_SET query indicates the current position of the cursor s The values returned depend on the grid type selected Note 1 When the oscilloscope is in the dual grid mode traces are assigned to either the upper grid EA MC FE Cl C3 or lower grid EB MD FF C2 C4 The trace specified determines whether a vertical cursor will be placed relative to the upper or lower grid In quad grid modet each channel is permanently assigned to its respective grid with C1 at the top and C4 at the bottom All other traces may be re positioned anywhere on the screen u
43. many lines This feature is very useful for waveform or front panel setup transfers although it is applicable to all response messages Two parameters control this feature Line Separator Off messages will not be split into lines lt CR gt lt LF gt or lt CR gt lt LF gt possible line termi nators Line length the maximum number of characters in a line COMM_RS232 LS LF LL 40 The line separator is the ASCII character lt LF gt the line is a maxi mum of 40 characters long excluding the line separator If the oscilloscope receives the command PNSU it may answer PNSU 9000001496 AAAA5555000655AA4030005 8001 9000000000001 000000000000000000000000000C1B01005 80000 0000000000000000000000000000000000000000 Long commands sent to the oscilloscope may not be split into lines If a command sent to the oscilloscope is the response to a previous query the line split characters lt LF gt and or lt CR gt must be removed COMMANDS SIMULATING GPIB COMMANDS lt ESC gt C or lt ESC gt c Device clear command lt ESC gt R or lt ESC gt r Set to remote command REN lt ESC gt L or lt ESC gt l Set to local command lt ESC gt F or lt ESCof Set local lockout command lt ESC gt T or lt ESC gt t Trigger command GET RS 232 C Operation 4 This also applies to line split characters inside strings sent to the oscilloscope However hex ASCII data sent to the oscilloscope may contain line split characters I
44. of a single command which instructs the instrument to display a dual grid The terminator is not shown since it is usually automatically added by the interface driver routine which writes to the GPIB or RS 232 BWL ON DISPLAY OFF DATE This program message consists of two commands followed by a query They instruct the instrument to turn on the bandwidth limit turn off the display and then ask for the current date Again the terminator is not shown The general form of a command or a query consists of a command header lt header gt which is 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 The detailed listing of all commands in Section 5 indicates which commands may also be queries There is a space between the header and the first parameter There are commas between parameters DATE 15 OCT 1989 13 21 16 This command instructs the oscillo scope to set its date and time to 15 OCT 1989 13 21 16 The com mand header DATE indicates the action the 6 data values specify it in detail The header is the mnemonic form of the operation to be per formed by the oscilloscope All command mnemonics are listed in alphabetic order in Section 5 The majority of the command query headers have a long form for optimum legibility and a short form for
45. of the Operator s Manual Pause button 1 Continue key 3 line 1 key 3 line 2 key 4 line 1 key 4 line 2 button 2 button 3 button 4 button 5 key 5 center button 6 button 7 button 8 O O O O O O O O O button 9 EXAMPLE OF A MENU CREATED BY A REMOTE USER Figure 1 Text assigned to the menu buttons will disappear on the next tran sition to local but reappear when the instrument is switched back into the remote state Text is cleared at power up when the rear 105 5 System Commands COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 106 panel RESET button 64 is pressed or if an empty string is assigned to a location e g KEY L1 Pressing any one of the menu buttons while in remote mode causes the User Request status Register URR and the URQ bit of the Event Status Register to be set This can generate an SRQ provided that the service request mechanism has been enabled Note This command can be executed in both local and remote modes KEY lt button gt lt string gt lt position gt lt button gt 1 to 9 lt string gt a 12 character string any ASCII code lt position gt L1 LC L2 LB Note If the position is omitted LC will be assumed The example menu shown in Figure 1 was created by issuing the following series of KEY commands KEY 1 Pause LC KEY 1 MEASUREMENT LB KEY 2 Continue LC KEY 3 key 3 line 1 LI
46. parameter String data are formed by simply enclosing any sequence of ASCII characters between simple or double quotes MESSAGE Connect probe to point J3 The instrument displays this message in the Message field above the grid These are binary data values coded in hexadecimal ASCII i e 4 bit nibbles are translated into the digits 0 9 A F and trans mitted as ASCII characters They are only used for the transfer of waveforms command WAVEFORM and of the instrument configuration command PANEL SETUP The instrument sends a response message to the controller as an answer to a query The format of such messages is the same as that of program messages i e individual responses in the format of commands separated by semicolons lt gt and ended by a termina tor They can be sent back to the instrument in the form in which they are received and will be accepted as valid commands In GPIB response messages the lt NL gt lt EOI gt terminator is always used For example if the controller sends the program message TIME_DIV TRIG_MODE NORM C1 COUPLING terminator not shown 2 About Remote Control 10 the instrument might respond as follows TIME_DIV 50 NS C1 COUPLING D50 terminator not shown The response message only refers to the queries i e TRIG_MODE is left out If this response is sent back to the instrument it is a valid program message for setting its time base to 50 nsec div
47. program waits until time out and then asks for the next command Appendix A 1 99 100 110 115 120 125 130 140 145 150 155 160 165 170 200 205 210 220 230 240 250 260 270 275 280 300 310 320 400 405 410 420 425 430 500 505 510 515 520 525 530 535 540 545 550 600 lt DECL BAS gt CLS PRINT Control of the 9450 via GPIB and IBM PC PRINT PRINT Options EX to exit LC local mode PRINT ST store dataRC recall data PRINT LINE INPUT GPIB address of oscilloscope 1 16 ADDR DEVS DEV ADDRS CALL IBFIND DEV SCOPE IF SCOPE lt O THEN GOTO 830 TMO 10 timeout 300 msec rather than default 10 sec CALL IBTMO SCOPE TMO LOOP 1 WHILE LOOP LINE INPUT Enter command EX gt Exit CMD IF CMD ex OR CMD EX THEN LOOP 0 GOTO 310 IF CMD st OR CMD ST THEN GOSUB 600 GOTO 300 IF CMD re OR CMD RC THEN GOSUB 700 GOTO 300 IF CMD le OR CMDS LC THEN GOSUB 400 GOTO 300 IF CMD THEN GOTO 300 CALL IBWRT SCOPE CMD IF IBSTA lt O THEN GOTO 840 GOSUB 500 WEND GOSUB 400 END SUBROUTINE LOCAL MODE CALL IBLOC SCOPE PRINT RETURN SUBROUTINE GET_DATA If there are no data to read simply wait until timeout occurs CALL IBRD SCOPE RD I IBCNT IBCNT is the number of characters read FOR J 1 TOI PRINT MID RD J 1 NEXT J PRINT RETURN 201 Appendix A 605
48. r n This command indicates to the oscilloscope that it must ap pend the string r nEND r n to each response After these settings a host command will look like TDIV lt ETX gt The oscilloscope responds TDIV 1 S END Note Having sent a COMM_RS232 command the host must wait for the oscilloscope to change its behavior before sending a com mand in the new mode A safe way to do this is to include a query on the line which contains the COMM_RS232 command and wait until the response is received For example COMM _RS232 EI 3 STB 31 4 RS 232 C Operation SRQ Message Example Long Line Splitting Example Remarks 32 Each time the Master Summary Status MSS bit of the STatus Byte STB is set the SRQ message a string of characters is sent to the host to indicate that the oscilloscope requests service The RS 232 C SRQ message has the same meaning as the GPIB SRQ message If the string is empty no message will be sent This is the default setting Note that no response message terminator is added at the end of the SRQ message COMM_RS232 SRQ r n nSRQ r n a When the MSS bit is set the oscilloscope will send a lt CR gt followed by 2 lt LF gt s SRQ a lt CR gt followed by 1 lt LF gt and the buzer will sound Line splitting is a feature provided for hosts that cannot accept lines with more than a certain number of characters The oscillo scope may be configured to split responses into
49. register URR bit position 6 the ESE enable register must be set first with the command ESE 64 to allow the URQ setting to be reported in STB An SRQ request will now be gener ated provided that the ESB summary bit bit position 5 in the SRE enable register is set SRE 32 CMD ESE 64 SRE 32 CALL IBWRT SCOPE CMDS 20 INSTRUMENT POLLS Continuous Poll GPIB Operation 3 State transitions occurring within the instrument can be remotely monitored by polling selected internal status registers This sub section discusses a number of polling methods which may be used to detect the occurrence of a given event 1 Continuous poll 2 Serial poll 3 Parallel poll 4 IST poll To emphasize the differences between these methods the same example will be presented in each case i e determining if a new acquisition has taken place By far the simplest poll is the continu ous poll The other methods only make sense if interrupt service routines servicing the SRQ line are supported or if multiple de vices on GPIB must be monitored simultaneously In continuous polling a status register is continuously monitored until a transition is observed This is the most straightforward method for detecting state changes but may be impracticable in some situations especially in multiple device configurations In the following example the event new signal acquired is ob served by continuously polling the INt
50. s Manual Parameter Computation States OK deemed to be determined without problem AV averaged over several up to 100 periods PT window has been period truncated IV invalid value insufficient data provided NP no pulse waveform LT less than given value OF signal partially in overflow UF signal partially in underfiow OU signal partially in overflow and underflow See Figure 15 in Chapter 5 of Operator s Manual System Commands A QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 4 channel oscilloscopes only lt trace gt PArameter_VAlue lt parameter gt lt parameter gt lt trace gt EA EB MC MD FE FF C1 C2 C34 C4 lt parameter gt FRST LAST PNTS MIN MAX MEAN SDEV RMS DLY PER WID RISE FALL ALL lt trace gt PArameter_VAlue lt parameter gt lt value gt lt state gt lt parameter gt lt value gt lt state gt lt value gt decimal numeric value lt state gt OK AV PT IV NP LT OF UF OU Note If lt parameter gt is not specified or equal to ALL all the parameters followed by their values and states are returned The following query reads the risetime of Expand B EB CMD EB PAVA RISE CALL IBWRT SCOPE CMD CALL IBRD SCOPE RD PRINT RD Response message EB PAVA RISE 3 6E 9S OK CURSOR_MEASURE CURSOR_SET PASS _FAIL_COUNTER PASS_FAIL_DO PASS FAIL_MASK 115 5 System Commands MISCELLANEOU
51. scale horizontal scale time of day which are necessary for a full understanding of the data The information in a waveform can be accessed using the IN SPECT query which interprets it in an easily understood ASCII text form It can also be more rapidly transferred using the WAVEFORM query or written back into the instrument with the WAVEFORM command The oscilloscope contains a data struc ture called the template which is a detailed description of how the waveform s information is organized The template gives a detailed description of the form and contents of the logical data blocks of a waveform It is provided as a refer ence to be used by you and your programs A sample template is given in Appendix B although you are encouraged to use the TEMPLATE query to examine the actual template that your in strument is using The template may change as the instrument s firmware is enhanced The template will help provide backward compatibility for the interpretation of waveforms Usually a waveform will contain just a Waveform descriptor block 1 and a Data array block 5 In more complicated cases one or more of the other blocks will be present The data blocks are 1 Waveform descriptor block WAVEDESC This block in cludes all the information necessary to reconstitute the display of the waveform from the data This includes e hardware settings at the time of acquisition e the exact time of the event e the kinds of p
52. the menu Auxiliary Setups If the oscilloscope is addressed to talk it will remain configured to talk until a universal untalkk command UNT its own listen ad dress MLA or another instrument s talk address is received Similarly if the oscilloscope is addressed to listen it will remain configured to listen until a universal unlisten command UNL or its own talker address MTA is received The bus system consists of 16 signal lines and 8 ground or shield lines The signal lines are divided into 3 groups e 8 data lines 3 handshake lines 5 interface management lines The eight data lines usually called DI01 through DI08 carry both program and interface messages Most of the messages use the 7 bit ASCII code in which case DI08 is unused 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 The following five lines manage the flow of information across the interface ATN ATteNtion The controller drives the ATN 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 the data mode for the transfer of program mes sages from talkers to listeners IFC InterFace Clear The controller sets the IFC line true to initializ
53. to MC When the data file is sent to the instrument it first sees the header WF the characters C1 having been skipped when reading the file and assumes the default destina tion MC RELATED COMMANDS INSPECT COMM FORMAT COMM ORDER FUNC TION_STATE TEMPLATE WAVEFORM_SETUP WAVEFORM_TEXT 4 channel oscilloscopes only 167 5 System Commands WAVEFORM TRANSFER WAVEFORM_SETUP WFSU Command Query DESCRIPTION The WAVEFORM_SETUP command specifies the amount of data in a waveform which will be transmitted to the controller The command controls the settings of the following parameters a Sparsing SP The sparsing parameter defines the interval 0 25000 between data points For example SP 0 reads all data points SP 1 reads all data points SP 4 reads every 4th data point b Number of points NP The number of points parameter indicates how many points should be transmitted For ex ample NP 0 sends all data points NP 1 sends 1 data point NP 5 sends a maximum of data points NP 10 sends a maximum of 10 data points c First point FP The first point parameter specifies the address of the first data point to be sent For waveforms acquired in sequence mode this refers to the relative ad dress 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 d Segment
54. to the same interface board Refer to the National Instruments user s manual Parallel Poll GPIB Operation 3 Parallel polling is only an advantage if there are several instru ments that may need attention In parallel polling the controller simultaneously reads the Individ ual STatus bit IST of all the instruments to determine which one needs service Since parallel polling allows up to eight different instruments to be polled at the same time parallel polling is the fastest way to identify state changes of instruments supporting this capability When a parallel poll is initiated each instrument returns a status bit via one of the DIO data lines Devices may respond either indi vidually using a separate DIO line or collectively on a single data line Data line assignments are made by the controller via a Paral lel Poll Configure PPC sequence 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 set Once parallel polling has been established the parallel poll status is examined until a change on data bus line DI02 takes place Stage 1 Enable the INE and PRE registers configure the con troller for parallel poll and instruct the o
55. 0 THEN GOTO 250 170 PRINT RD 180 IBLOC SCOPE 190 END 200 PRINT WRITE ERROR IBERR 210 END 250 PRINT READ ERROR IBERR 260 END The GPIB status word ISTA the GPIB error variable IBERR and the count variable IBCNT are defined by the GPIB handler and are updated with every GPIB function call Refer to the Na tional Instruments user s manual for details The sample program above would report if the GPIB address of the instrument was set to a value other then 4 Line 180 resets the instrument to local with a call to the GPIB routine IBLOC Example 2 in Appendix A provides a more useful program which enables interactive setting and inspection of the front panel con trols as well as archiving and recalling of waveforms Note that this program is written with just 7 different GPIB calls IBLOC is used to execute the IEEE 488 1 standard message Go To Local GTL i e it returns the instrument to the local state The programming example above shows its use IBCLR executes the IEEE 488 1 standard message Selected De vice Clear SDC IBRDF and IBWRTF allow data to be read from GPIB to a file and data to be written from a file to GPIB respectively Transfer ring data directly to or from a storage device does not limit the size of the data block but it may be slower than transferring to the computer memory Example 2 in Appendix A shows the use of these calls IBRDI and IBWRTI allow data to be read from GPIB
56. 00 0000 0053 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0040 3d8e 0401 0407 d200 0000 0000 0000 0000 0c00 003f 8000 8000 003c 8000 2000 0002 0007 0009 000b 000c 000d 0013 0015 0016 0016 0019 OO1e OO1f 0022 0022 0023 0029 002a 002b 002d 002e 0034 0034 0037 0038 0037 Waveform Structure 6 ASCII translation b is for uninteresting C1 WF ALL 90000 4156 4544 4553 4300 0000 00430WAVEDESCbbb 4543 524f 595f 315f 3100 bbbbbLECROY_1_1b 0100 0000 0001 a00 0000 bbbbbbbbbbbbbbbb 0000 0000 0000 0000 0000 bbbbbbbbbbbbbbbb 0000 0000 0000 0000 0000 bbbbbbbbbbbbbbbb bLECROY9450_bbbb It can be seen that the first 10 bytes translate into ASCII and look like the simple beginning of a query response This is followed by the string 9000000430 This is the beginning of a binary block where 9 ASCII integers are used to give the length of the block 430 bytes The waveform itself starts immediately after this at byte number 21 the first byte is byte 0 Deciphering the waveform descriptor can be done with the aid of the template see Appendix B It states that the first object is a DESCRIPTOR_NAME which is a string of 16 characters with the value WAVEDESC and this is what we see At byte 16 relative to the beginning of the descriptor or byte 37 above we find the next string the TEMPLATE_NAME with the value LECROY_1 1 Several other parameters follow We can easily recognize the IN 183 6 Wav
57. 01 INTENSITY INTS Command Query 102 Interface Messages 11 INTERLEAVED ILVD Command Query 103 IST Polling 24 25 193 195 IST Query 104 K KEY Command 105 106 L Line Splitting See RS 232 C Local State 5 Logical Data Blocks 179 Index M Maintenance 1 MESSAGE MSG Command Query 107 MULTI_ZOOM MZOM Command Query 108 O OFFSET OFST Command Query 109 110 OPC Command Query 111 OPT Query 112 P PANEL_SETUP PNSU Command Query 113 PaRallel poll Enable register See PRE Parallel Polling 23 24 PARAMETER_VALUE PAVA Query 114 115 PASS_FAIL_CONDITION PFCO Com mand Query 116 PASS_FAIL_COUNTER PFCT Command Query 117 PASS_FAIL_DO PFDO Command Query 118 PASS_FAIL_MASK PFMS Command Query 119 PER_CURSOR_SET PECS Command Query 121 PER_CURSOR_VALUE PECV Query 123 PERSIST PERS Command Query 120 PERSIST_SETUP PESU Command Query 124 Pin Assignments See RS 232 C Polling 21 25 PRE Command Query 125 PRE PaRallel poll Enable register 23 24 193 195 Program Messages 3 4 5 6 R RAN Return Authorization Number 2 RCL Command 126 RECALL REC Command 128 RECALL PANEL RCPN Command 127 Remote State 5 Response Message Form 9 10 Return Procedure 2 RISTIME 180 187 RS 232 C 29 Configuration 30 Echoing 30 Editing 31 Handshake control 30 31 Immediate commands 30 Line splitt
58. 08 MULTI_ZOOM MZOM Command Query By setting MULTI_ZOOM ON the horizontal magnification and positioning controls apply to all expanded traces simultaneously This command is useful if the contents of all expanded traces are to be examined at the same time The MULTI_ZOOM query indicates whether multiple zoom is enabled or not Note This command has the same effect as DUAL_ZOOM Multi_ZOoM lt mode gt lt mode gt ON OFF Multi_ZOoM Multi_ZOoM lt mode gt The following example turns the multiple zoom on CMD MZOM ON CALL IBWRT SCOPE CMDS HOR_ MAGNIFY HOR_POSITION DUAL_ZOOM ZOOM ACQUISITION DESCRIPTION System Commands 5 OFFSET OFST Command Query The OFFSET command allows the vertical offset of the specified input channel to be adjusted The maximum ranges depend on the fixed sensitivity setting as follows 9410 14 30 Fixed Sensitivity Offset Range 2 V 6 times 12V 1 V to 10 mV 12 times 12V to 120 mV 5 mV 24 times 120 mV 2 mV 60 times 120 mV t mV 120 times 120 mVY All Others Fixed Sensitivity Offset Range 1V 10 times 10V 0 5 V to 20 mV 12 times 6 V to 240 mV 10 mV 24 times 240 mV 5 mV 48 times 240 mV If an out of range value is entered the oscilloscope is set to the closest possible value and the VAB bit bit 2 in the STB register is set Note Th
59. 1026 i e waveform processing in Function E and a screen dump have both terminated RELATED COMMANDS ALL_STATUS CLS INE Bit Value Description Reserved for future use Waveform processing has terminated in Function F Waveform processing has terminated in Function E Waveform processing has terminated in Memory D Waveform processing has terminated in Memory Cf A memory card exchange has been detected Memory card has become full in Autostore Fill mode Autostore to memory card cannot begin Check for errors in the EXecution error Register A segment of a sequence waveform has been acquired A time out has occurred In a data biock transfer A return to the local state is detected A screen dump has terminated A new signal has been acquired 2048 1024 512 256 0 1 1 1 1 1 1 b h h ee Internal State Register Structure INR Table 7 t 4 channel oscilloscopes only reserved in the 2 channel oscilloscopes only oscilloscopes equipped with the memory card option 99 5 System Commands WAVEFORM TRANSFER DESCRIPTION QUERY SYNTAX Response format t 4 channel oscilloscopes only 100 INSPECT INSP Query The INSPECT query allows the user to read parts of an acquired waveform in intelligible form The command is based on the expla nation of the format of a waveform given by the template use the query TEMPLATE to obtain an up to date copy Each logical block of a waveform ma
60. 110 PRINT Control of the 9450 address 4 via GPIB and IBM PC 115 PRINT PRINT Options EX to exit LC local mode 120 PRINT ST store data RC recall data PRINT 125 LOOP 1 130 CMD1 Unlisten Untalk Board talker Device listener 135 CMD2 _ D Unlisten Untalk Board listener Device talker 140 BDNAMES GPIBO CALL IBFIND BDNAME BRDO 145 IF BRDO lt O THEN GOTO 420 150 CALL IBSIC BRDO IF IBSTA lt O THEN GOTO 425 155 WHILE LOOP 160 LINE INPUT Enter command EX gt Exit CMD 165 V 1 CALL IBSRE BRDO amp V 170 IF CMD ex OR CMD EX THEN LOOP FALSE GOTO 205 175 IF CMD st OR CMD ST THEN GOSUB 285 GOTO 200 180 IF CMD rc OR CMD RC THEN GOSUB 365 GOTO 200 185 IF CMD lc OR CMD LC THEN GOSUB 240 GOTO 200 190 IF CMD THEN GOTO 200 195 CALL IBCMD BRDO CMD1 CALL IBWRT BRDO CMD GOSUB 270 200 WEND 205 CALL IBSIC BRDO V 0 CALL IBSRE BRDO V 210 CALL IBSIC BRDO 215 END 220 230 LOCAL MODE 235 f 240 V O CALL IBSRE BRDO V PRINT 245 RETURN 250 260 SUBROUTINE GET_DATA 265 270 CALL IBCMD BRDO CMD2 CALL IBRD BRDO RD I IBCNT 275 FOR J 1 TO I PRINT MID RD J 1 NEXT J PRINT 280 RETURN 285 i 290 SUBROUTINE STORE_DATA 295 300 RD1 SPACE 3 305 LINE INPUT Specify trace EA EB MC MD FE FF C1 C2 TRACES 310 LINE INPUT Enter filename FILES 315 CALL IBCMD BRDO CMD1 320 CMD WF
61. 153 TRIG_PATTERN TRPA Command Query 4 ch without ext trigger 154 TRIG_SELECT TRSE Command Query 155 157 TRIG_SLOPE TRSL Command Query 158 159 Trigger Time 180 TRIGTIME 179 186 TST Query 159 U URR User Request status Register 20 196 URR Query 160 USERTEXT 179 V VERT_MAGNIFY VMAG Command Query 161 VERT_POSITION VPOS Command Query 162 VOLT_DIV VDIV Command Query 163 Index W WAI Command 164 WAIT Command 165 Warning Messages 4 Warranty 1 WAVEDESC See Descriptor WAVEFORM Command 187 Query 182 187 188 Transfer Optimization 188 189 Waveform Template 205 216 WAVEFORM WF Command Query 166 167 WAVEFORM_SETUP WFSU Command Query 168 170 WAVEFORM_TEXT WFTX Command Query 170 X XY_ASSIGN XYAS Command Query 171 XY_CURSOR_ORIGIN XYCO Command Query 172 XY_CURSOR_SET XYCS Command Query 173 174 XY_CURSOR_VALUE XYCV Command Query 175 XY_DISPLAY XYDS Command Query 176 Z ZOOM Command Query 177 ADDRESSES US SALES OFFICES 800 5 LeCroy automatically connects you to your local sales office WORLDWIDE Argentina Search SA 01 394 5882 Australia Scientific Devices Pty Ltd 03 579 3622 Austria Dewetron Elek Messgerate GmbH 0316 391804 Benelux LeCroy B V 31 4902 89285 Brazil A Santos 021 233 5590 Canada Rayonics W Ontario 416 736 1600 Rayonics E Ontario M
62. 46 DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS System Commands 5 CALL_HOST CHST Command Query The CALL_HOST command allows the user to manually generate a service request SRQ Once the CALL_HOST command has been received the message Call Host will be displayed next to the lowest button 10 in the menu field II Pressing this button while in the root menu causes the User Request status Register URR and the URQ bit of the Event Status Register to be set This can generate a SRQ in local mode provided that the service re quest mechanism has been enabled The response to the CALL_HOST query indicates whether call host is enabled on or disabled off Note This command can be executed in both local and remote modes Call_HoST lt state gt lt state gt ON OFF Call_HoST Call_HoST lt state gt After executing the following code an SRQ request will be gener ated whenever button 10 is pressed It is assumed that SRQ servicing has already been enabled CMD CHST ON CALL IBWRT SCOPE CMD URR 47 5 System Commands STATUS DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 48 CLS Command The CLS command clears all the status data registers Note This command can be executed in both local and remote modes CLS The following command causes all the status data registers to b
63. 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 Full Command PASS _FAIL_CONDITION PASS _FAIL_COUNTER PASS FAIL_DO PASS _FAIL_MASK PERSIST PER_CURSOR_SET PER_CURSOR_VALUE PERSIST_SETUP PRE RCL RECALL PANEL RECALL RST SAMPLE_CLOCK SAV SCREEN_DUMP SEGMENTS SELECT SRE STB STOP STORE STORE PANEL STORE_SETUP STORE_TEMPLATE TEMPLATE TIME_DIV TRACE TRG TRIG_COUPLING TRIG_DELAY TRIG_LEVEL TRIG_MODE TRIG_PATTERN ext trig TRIG_PATTERN ext trig TRIG_SELECT TRIG_SLOPE TST URR VERT_MAGNIFY VERT POSITION VOLT_DIV WAI WAIT WAVEFORM WAVEFORM_SETUP WAVEFORM_TEXT XY_ASSIGN XY_CURSOR_ORIGIN XY_CURSOR_SET XY_CURSOR_VALUE XY_DISPLAY ZOOM 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 165 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 6 INTRODUCTION LOGICAL DATA BLOCKS OF A WAVEFORM WAVEFORM STRUCTURE This section discusses how to read and write waveforms and under stand their contents Waveforms can be divided into two basic entities the basic data array i e the raw data values from the ADC s in the acquisition and the accompanying descriptive infor mation such as vertical
64. ACQ 1 Then with j i m x i x j m HORIZ_INTERVAL j RIS_OFFSET m WAVEFORM COMMAND Waveform Structure 6 where the RIS_OFFSET s can be found in the RISTIME array There can be up to 100 8 byte double precision floating point num bers in this block The instrument tries to get segments with times such that RIS_OFFSET i PIXEL_OFFSET i 0 5 HORIZ_IN TERVAL Thus taking as an example a RIS with SWEEPS_PER_ACQ 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_OFFSETT1 0 4 ns RIS_OFFSET 2 1 6 ns RIS_OFFSET 3 2 6 ns RIS_OFFSET 4 3 4 ns RIS_OFFSET S 4 5 ns RIS_OFFSET 6 5 6 ns RIS_OFFSET 7 6 4 ns RIS_OFFSET 8 7 6 ns RIS_OFFSET 9 8 5 ns and therefore x 0 RIS_OFFSET 0 0 5 ns x 1 RIS_OFFSET 1 0 4 ns x 9 RI _OFFSET 9 8 5 ns x 10 1 ns 10 0 5 9 5 ns x 11 1 ns 10 0 4 10 4 ns x 19 1 ns 10 8 5 18 5 ns x 20 1 ns 20 0 5 19 5 ns Waveforms that have been read in their entirety with the WAVE FORM command can be sent back into the instrument Since the descriptor contains all of the necessary information you do not have to be careful about any of the communication format param eters The instrument can learn all that it needs to know from the waveform If you want to synthesize waveforms for display or comparison pur poses you are encouraged to read
65. AIT System Commands 5 WAVEFORM TRANSFER DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 4 channel oscilloscopes only STORE STO Command The STORE command stores the contents of the specified trace into one of the internal function memories Memory C Memory D Function Ef Function Ff or to the memory card lt memory gt STOre lt trace gt lt filename gt lt memory gt MC MD FE FF CARDs lt trace gt EA EB MC MD FE FF C1 C2 C34 C44 lt filename gt a string of up to 8 characters Notes applying to oscilloscopes equipped with the memory card option 1 Any extension supplied with the filename is ignored 2 Ifno filename or an empty string is supplied the oscilloscope generates a filename according to its internal rules 3 If the CARD STORE command is sent without any argument all traces currently enabled in the Store Setup will be stored on the card This setup can be modified using the STORE_SETUP command The following command stores the contents of Expand B EB into Memory D MD CMD MD STO EB CALL IBWRT SCOPE CMD The following command stores C1 on the memory card in a file called DIODE CMD CARD STO Ct DIODE CALL IBWRT SCOPE CMD FUNCTION_STATE STORE_SETUP RECALL only oscilloscopes equipped with the memory card option 139 5 System Commands SAVE RECALL PANEL DESCRIPTION COMM
66. AND SYNTAX EXAMPLE GPIB RELATED COMMANDS 140 STORE_PANEL STPN Command Oscilloscopes fitted with the MC0Q1 Option The STORE_PANEL command stores the complete front panel setup of the instrument at the time the command is issued into a file on the memory card Note The communication parameters those modified by com mands COMM_FORMAT COMM_HEADER COMM_HELP COMM_ORDER and WAVEFORM_SETUP and the enable reg isters associated with the status reporting system SRE PRE ESE INE are not saved by this command STore_PaNel FILE lt filename gt lt filename gt a string of up to 8 characters Any extension will be ignored Front panel setup files are always stored with the extension PNL on the card Note If no filename or an empty String is supplied the oscillo scope generates a filename according to its internal rules The following code saves the current instrument setup to the memory card in a file called DIODE PNL CMD STPN FILE DIODE CALL IBWRT SCOPE CMD PNSU SAV RECALL_PANEL RCL System Commands 5 WAVEFORM TRANSFER DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format t 4 channel oscilloscopes only STORE_SETUP STST Command Query Oscilloscopes fitted with the MC01 Option The STORE SETUP command controls the way in which traces will be stored on the memory card Traces may be enabled FILE or disabled DIS for storage This app
67. AVEFORM constitute a special kind of response mes sage Their exact format can be controlled with the commands COMM_FORMAT and COMM_ORDER as explained in Section 6 Crd GPIB STRUCTURE INTERFACE CAPABILITIES GPIB OPERATION This section describes how to remotely control the oscilloscope via the GPIB Topics discussed include interface capabilities address ing standard bus commands and polling schemes The GPIB is like an ordinary computer bus except that it inter connects independent devices via a cable bus whereas a computer has its circuit cards interconnected via a backplane bus The GPIB carries program messages and interface messages Program messages often called device dependent messages contain programming instructions measurement results in strument status and waveform data Their general form is described in Section 2 Interface messages manage the bus itself They perform func tions such as initializing the bus addressing and unaddressing devices and setting remote and local modes Devices on the GPIB can be listeners talkers and or controllers A talker sends program messages to one or more listeners A con troller manages the flow of information on the bus by sending interface messages to the devices The oscilloscope can be a talker or a listener but not a controller The host computer however must be able to act as a listener talker and controller For details on how th
68. AX ReCall_PaNel FILE lt filename gt lt filename gt a string of up to 8 characters Any extension will be ignored Front panel setup files are always stored with the extension PNL on the card EXAMPLE GPIB The following command recalls the front panel setup from file P012 PNL CMD RCPN FILE P012 CALL IBWRT SCOPE CMD RELATED COMMANDS PANEL_SETUP SAV STORE_PANEL RCL 127 5 System Commands WAVEFORM TRANSFER DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 4 channel oscilloscopes only 128 RECALL REC Command Oscilloscopes fitted with the MC01 Option The RECALL command recalls a waveform file from the memory card into one of the internal memories Memory C Memory D Function Ef or Function F lt memory gt RECall FILE lt mode gt lt memory gt MC MD FE FF lt mode gt SAME PREVIOUS NEXT NEWEST OLDEST lt filename gt lt filename gt an alphanumeric string of up to 8 characters fol lowed by a dot and an extension of up to 3 digits The following commands first recall a waveform file called SC1 001 into Memory C after which the NEXT waveform file in the card directory list is recalled to Memory D CMD MC REC FILE SC1 001 MD REC NEXT CALL IBWRT SCOPE CMD FUNCTION_STATE STORE INR System Commands 5 ee ee sins SAVE RECALL SETUP RST Command DESCRIPTION The RST command initiat
69. B EX EX10 External trigger C1 OFST 300 MY Set the offset of Channel 1 to 300 mV Header paths need only be specified once Subsequent commands whose header destination is not indicated are assumed to refer to the last defined path For example the following commands are identical C2 VDIV C2 OFST What is the vertical sensitivity and the offset of channel 2 C2 VDIV OFST Same as above without repeating the path Whenever a command query uses additional data values they are expressed in terms of ASCII characters There is a single excep tion the transfer of waveforms with the command query WAVEFORM where the waveform may be expressed as a se quence of binary data values Refer to Section 6 for a detailed explanation of the format of waveforms ASCII data can have the form of character numeric string or block data 2 About Remote Control Character data Numeric Data These are simple words or abbreviations for the indication of a specific action BANDWIDTH_LIMIT ON The data value ON indicates that the bandwidth limit should be turned on rather than off In some commands where as many as a dozen different parame ters can be specified or where not all parameters apply at the same time the format requires pairs of data values The first one names the parameter to be modified and the second gives its value Only those parameter pairs to be changed need to be indicated HARDCOPY_SETUP DEV
70. C PRE SRE STB URR WAI Waveform Transfer To preserve and restore waveforms INSPECT RECALL STORE STORE_SETUP STORE_TEMPLATE TEMPLATE WAVEFORM WAVEFORM_SETUP WAVEFORM_TEXT Miscellaneous To control the calibration and test the instrument AUTO_CALIBRATE CAL TST To control the built in buzzer BUZZER To control the real time clock DATE 36 COMMAND EXECUTION COMMAND NOTATION System Commands 5 To delete a file from the memory card DELETE_FILE To obtain a directory listing of the memory card DIRECTORY_LIST To format the memory card FORMAT_CARD To identify the instrument IDN OPT Before attempting to execute a command or query the oscillo scope scans it to verify its correctness and that sufficient information is given to perform the requested action To protect the local user from changes in the oscilloscope s behavior which are beyond his control the remote user must set the oscilloscope to the remote state to execute commands that affect the operation of the instrument as an oscilloscope If such a command is re ceived while the oscilloscope is operating in the local state an execution permission error is generated and the execution of the command is denied Vice versa the local user cannnot interfere with the remote user because all front panel controls are disabled while the oscilloscope is in the remote state Since interrogating the oscilloscope does not change
71. D FE FF Ci C2 C3 C4 lt Y_source gt EA EB MC MD FE FF C1 C2 C3 C4 QUERY SYNTAX XY_ASsign Response Format XY_ASsign lt X_source gt lt Y_source gt lt X_source gt UNDEF EA EB MC MD FE FF Ci C2 C34 C4 lt Y_source gt UNDEF EA EB MC MD FE FF C1 C2 C34 C4 EXAMPLE GPIB The following command will assign Channel 1 to X and Channel 2 to Y CMDS XYAS C1 C2 CALL IBWRT SCOPE CMDS t 4 channel oscilloscopes only 171 5 System Commands Ln CURSOR DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB 172 XY_CURSOR_ORIGIN XYCO Command Query The XY_CURSOR_ORIGIN command sets the position of the ori gin for absolute time cursor measurements on the XY display Absolute time cursor values may be measured either with respect to the point 0 0 volts OFF or with respect to the center of the XY grid ON The XY_CURSOR_ORIGIN query returns the current assignment of the origin for absolute time cursor measurements XY_Cursor_Origin lt mode gt lt mode gt ON OFF XY_Cursor_Origin XY_Cursor_Origin lt mode gt The following command sets the origin for absolute time cursor measurements to the center of the XY grid CMDS XYCO ON CALL IBWRT SCOPE CMDSS ed CURSOR DESCRIPTION COMMAND SYNTAX System Commands 5 XY_CURSOR_SET XYCS Command Query The XY_CURSOR_SET command allows the user to pos
72. ET are executed immediately upon reception and not in chronological order with normal com mands Note In addition to the IEEE 488 1 interface message standards the IEEE 488 2 standard specifies some standardized program messages i e command headers They are identified with a lead ing asterisk lt gt and are listed among the commands in Section 5 The command list in Section does not contain any command for clearing the input output buffers or for setting the instrument to the remote state This is because such commands are already spe cified as IEEE 488 1 standard messages Refer to the GPIB interface manual of the host controller as well as to its support programs which should contain special calls for the execution of these messages The following describes those IEEE 488 1 standard messages which go beyond mere reconfiguration of the bus and which have an effect on the operation of the instrument In response to a universal Device CLear DCL or a Selected De vice Clear message SDC the oscilloscope clears the input output 13 3 GPIB Operation Group Execute Trigger Remote ENable Local LOckout Go To Local 14 buffers aborts the interpretation of the current command if any and clears any pending commands Status registers and status en able registers are not cleared Although DCL has an immediate effect it can take several seconds to execute this command if the instrument is busy The Group Execu
73. HP7470A PORT GPIB PSIZE A4 Three pairs of parameters are spe cified The first specifies the device as the H7470A plotter or compat ible the second indicates the GPIB port and the third requests the A4 format for paper size While the command HARDCOPY_SET UP allows many more parameters they are either not relevant for plot ters or they are left unchanged The numeric data type is used to enter quantitative information Numbers can be entered as integers as fractions or in exponential representation EA VPOS 5 Move the displayed trace of Expand A down wards by 5 divisions C2 OFST 3 56 Set the DC offset of Channel 2 to 3 56 V TDIV 5 0E 6 Adjust the time base to S psec div Note Numeric values may be followed by multipliers and units modifying the value of the numerical expression The following mnemonics are recognized String Data Block Data RESPONSE MESSAGE FORM About Remote Control 2 EX 1E18 Exa PE 1E15 Peta T 1E12 Tera G 1E9 Giga MA 1E6 Mega K 1E3 kilo M 1E 3 milli U 1E 6 micro N 1E 9 nano PI 1E 12 pico F 1E 15 femto A 1E 18 atto For example there are many ways of setting the time base of the instrument to 5 jsec div TDIV S5E 6 Exponential notation without any suffix TDIV 5 US Suffix multiplier U for 1E 6 with the optional suffix S for seconds TDIV 5000 NS TDIV 5000E 3 US This data type enables the transfer of a long string of characters as a Single
74. In such cases the data arrays contain Extrema FFT DATA_ARRAY_1 Roof trace Real part DATA_ARRAY_2 Floor trace Imaginary part Note The TEMPLATE also describes an array named DUAL This is simply a way to allow the INSPECT command to examine the two data arrays together This is the simplest way to examine the contents of a waveform It can be used on both the data and descriptive parts The simplest form of the command is INSPECT name where the template gives the name of a descriptor item or data block The answer is returned as a single string but may span many lines Here is some typical dialogue question C1 INSPECT VERTICAL OFFSET response Cl1 INSP VERTICAL OFFSET 1 5625e 03 question C1 INSPECT TRIGGER_TIME response C1 INSP TRIGGER_TIME Date FEB 17 1989 Time 4 4 29 5580 n The INSPECT command can also be used to get a readable trans lation of the full waveform descriptor block with the command INSPECT WAVEDESC The template dump from your instrument or from Appendix B will give details on the interpretation of each of the parameters INSPECT SIMPLE C1 INSP 4 68749e 03 3 28125e 02 5 78125e 02 8 5937 5e 02 1 07812e 01 1 32812e 01 1 60938e 01 t d 1 0937 5e 02 3 5937 5e 02 6 4062 5e 02 8 9062 5e 02 1 14062e 01 1 39062e 01 1 60938e 01 Waveform Structure 6 The INSPECT command is also used to examine the measured data values of
75. LO Note The initial mode i e the mode after power on is HI Comm_ORDer Comm_ORDer lt mode gt The order of transmission of waveform data depends on the data type Table 3 illustrates the different possibilities System Commands 5 CORD Hi CORD Lo lt LSB gt lt MSB gt Word lt MSB gt lt LSB gt lt MSB gt lt byte 2 gt lt byte 3 gt lt LSB gt lt LSB gt lt byte 3 gt lt byte 2 gt lt MSB gt Long float Double lt MSB gt lt byte 2 gt lt byte 7 gt lt LSB gt lt LSB gt lt byte 7 gt lt byte 2 gt lt MSB gt Waveform Data Transmission Order Table 3 RELATED COMMANDS WAVEFORM 55 A System Commands COMMUNICATION DESCRIPTION 56 COMM_RS232 CORS Command Query The command COMM _RS232 sets the parameters of the RS 232 C port for remote control The COMM_RS232 query reports the settings of the parameters Note This command is ONLY valid if the oscilloscope is being remotely controlled via the RS 232 C port The parameters are a b DUPLEX behavior mode End Input character When received by the oscilloscope this character will be interpreted as the END of a command message marker The commands received will be parsed and executed End Output string The oscilloscope will add this string at the end of a response message When the host computer receives this string it knows that the oscilloscope has completed its response Line Length This
76. M8151 Philips PM8151 HP7470A HP 7470A HP7550A HP 7550A HPQJ HP QuietJet HPTJ HP ThinkJet HPLJ HP LaserJet EPSON Epson FX80 N Normal NS Non standard L Low HardCopy_SetUp DEV lt device gt PORT lt port gt SPEED lt plot_speed gt DENS lt print_density gt PENS lt plot_pens gt PFEED lt page_feed gt PSIZE lt paper_size gt GRID lt grid_square gt LLX lt lower_left_X gt LLY lt lower_left_Y gt Note Parameters are grouped in pairs The first one names the variable to be modified and the second one gives the new value to be assigned Pairs may be given in any order and may be restricted to those variables to be changed 91 5 System Commands QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 92 lt device gt FP5301 PM8151 HP7470A HP7550A HPQJ HPTJ HPLJ EPSON lt port gt GPIB RS lt plot_speed gt N L for plotters only lt density gt SINGLE DOUBLE QUADRUPLE HIGH_SPEED HIGH_RESOLUTION ONE_TO_ONE TWO_TO_ONE CRT for printers only lt plot_pens gt 1 to 8 lt page_feed gt ON OFF lt paper_size gt A5 A4 A3 NS lt grid_square gt 0 0 to 99 9 MM lt lower_left_X gt 999 to 999 MM fOr non standard eels paper size only lt lower_left_Y gt 999 to 999 MM Note For these three parameter values the suffix is optional The suffix M is assumed HardCopy_SetUp HardCopy_SetUp DEV lt device gt PORT lt port gt
77. OM 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 by the symbolic name DEVI to DEVI6 Note 2 Lines 1 99 are a copy of the file DECL BAS supplied by National Instruments The first 6 lines are required for the initial ization of the GPIB handler DECL BAS requires access to the file BIB M during the GPIB initialization BIB M is one of the files supplied by National Instruments and must exist in the directory currently in use Note 3 The first 2 lines of DECL BAS each contain a String XXXXX which must be replaced by the number of bytes which 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 you would replace XXXXX by the value 59000 or less Note 4 The default timeout of 10 seconds is modified to 300 msec during the execution of this program However the default value of the GPIB handler is not changed 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 independently of whether or not a response is expected Ifa response is received it is immediately displayed If there is no re sponse the
78. PA H L X AB CALL IBWRT SCOPE CMD TRIG_SELECT System Commands 5 ACQUISITION TRIG_SELECT TRSE Command Query DESCRIPTION The TRIG_SELECT command selects the condition that will trig ger the acquisition of waveforms Depending on the trigger type additional parameters have to be specified The additional parameters are grouped in pairs The first one names the variable to be modified and the second one gives the new value to be assigned Pairs may be given in any order and may be restricted to those variables to be changed Note The state qualified time event qualified and pattern trigger types use the trigger pattern defined by the command TRIG GER_PATTERN The TRIG _SELECT query returns the current trigger condition Trigger Notation STD Standard Single source PA Pattern State qualified TEQ Time event qualified Time PL Pulse larger interval larger Event Pulse smaller Interval smaller Source Hold type Hold value TV Trigger Notation FLD Field FLDC Field Count LINE Line CHAR Characteristics LPIC Lines per picture ILAC interlace SR does not apply to the Pattern trigger HT and HV do not apply to the standard trigger NON TV TRIGGER COMMAND SYNTAX TRig_SElect lt trig_type gt SR lt source gt HT lt hold_type gt HV lt hold_value gt lt trig type gt STD SNG SQ TEQ PA lt source gt Ci C2 LINE EX EX10 4 lt source gt C1 C2 LINE C4 2 ch and 4 ch oscilloscope
79. R lt value gt lt value gt 21 to 64 EXAMPLE GPIB The following instruction reads the contents of the EXR register CMD EXR CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message if no fault EXR 0 RELATED COMMANDS ALL_STATUS CLS 83 A System Commands Description Permission error The command cannot be executed in local mode Environment error The instrument is not configured to correctly process a command For instance the oscilloscope cannot be set to RIS at a slow time base 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 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 indi cators Waveform descriptor error An Invalid waveform descriptor has been detected Waveform time error invalid RIS or TRIG time data has been detected Waveform data error Invalid waveform data have been detected Pane setup error An invalid panel setup data block has been detected No memory card present when user attempted to access the card Memory card not formatted when user attempted to access the card Memory card was exchanged when user attempted to RECALL the NEXT PREVIOUS or SAME waveform Memory card was write protected when user attempte
80. S DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 116 PASS _FAIL_ CONDITION PFCO Command Query The PASS_FAIL_CONDITION command adds a Pass Fail test condition or an extended parameter at a specified position The PASS FAIL CONDITION query indicates the current Pass Fail test setup or the current selection of extended parame ters at a specified position Note Up to four test conditions or extended parameters can be specified at four different positions on the screen The PASS _FAIL_CONDITION command deals with one position ata time Notation GT Greater than LT Lower than Pass_Fail_COndition lt pos gt lt trace gt lt param gt lt rel_op gt lt ref_value gt lt pos gt 1 2 3 4 lt trace gt EA EB MC MD FE FF Cl C2 C3 C4 lt eparam gt extended parameters see list on next page lt rel_op gt GT LT lt ref_value gt 0 001e 33 to 999 999e33 Note The PFCO command with no arguments i e PFCO de letes all conditions PFCO lt pos gt PFCO lt pos gt lt trace gt lt param gt lt rel_op gt lt ref_value gt The following command sets the first test condition in the list to be frequency on Channel 1 lower than 10 kHz CMD PFCO 1 C1 FREQ LT 10000 CALL IBWRT SCOPE CMD CURSOR_MEASURE CURSOR_SET PASS_FAIL_COUNTER PASS_FAIL_DO PASS _FAIL_MASK PARAMETER_VALUE Syst
81. SPEED lt plot_speed gt DENS lt print_density gt PENS lt plot_pens gt PFEED lt page_feed gt PSIZE lt paper_size gt GRID lt grid_square gt LLX lt lower_left_X gt LLY lt lower_left_Y gt This example selects a HP 7550A plotter to be driven by the GPIB port CMD HCSU PORT GPIB DEV HP7550A CALL IBWRT SCOPE CMD HARDCOPY_TRANSMIT SCREEN_DUMP HARD COPY DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS System Commands 5 HARDCOPY TRANSMIT HCTR Command The HARDCOPY_TRANSMIT command sends a string of ASCII characters without modification to the hard copy unit This allows the user to control the hard copy unit by sending device specific control character sequences It also allows the user to place addi tional text on a screen dump for documentation purposes This command accepts the escape sequence ddd like those de scribed under the command COMM_RS232 see page 56 Before sending the string to the hard copy unit the escape se quence is converted to the ASCII character code HardCopy_TRansmit lt string gt lt string gt Any sequence of ASCII or escaped characters The following code sends documentation data to a printer CMD HCTR Data from Oct 15 r n CALL IBWRT SCOPE CMD The following code sends the same documentation data to an HP7470A plotter using pen 1 The text will be printed at the lower left corner of the paper CMD HCTR IN SP1
82. SU NP 0O SP 0 FP 0 SN 0 CHDR SHORT 321 CALL IBWRT BRDO CMD 325 CMD TRACE WF CALL IBWRT BRDO CMD 330 CALL IBCMD BRDO CMD2 CALL IBRD BRDO RD1 203 Appendix A 335 CALL IBRDF BRDO FILES 340 IF IBSTA lt O THEN GOTO 430 345 PRINT 350 RETURN 355 7 360 SUBROUTINE RECALL_DATA 365 j 370 LINE INPUT Specify target memory MC MD MEM 375 LINE INPUT Enter filename FILE 380 CALL IBCMD BRDO CMD1 385 CMD MEM TRACE ON CALL IBWRT BRDO CMD 390 CALL IBWRTF BRDO FILE 395 IF IBSTA lt O THEN GOTO 430 400 PRINT 405 RETURN 410 415 ERROR HANDLER 420 425 PRINT IBFIND ERROR STOP 430 PRINT GPIB ERROR IBERR IBERR IBSTA HEX IBSTA 435 STOP 440 END 204 APPENDIX B THE WAVEFORM TEMPLATE This is the response of the instrument to a command of the form TMPL TMPL 00 000000 LECROY_2_1 TEMPLATE 8 66 109 Explanation of the formats of waveforms and their descriptors on the LeCroy Digital Oscilloscopes Software Release 41 1 1 2 90 10 04 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
83. SUBROUTINE STORE_DATA 610 k 615 RD1 SPACE 3 620 LINE INPUT Specify trace EA EB MC MD FE FF C1 C2 TRACES 625 LINE INPUT Enter filename FILES 630 CMD WFSU NP O SP 0 FP 0 SN 0 CHDR SHORT 640 CALL IBWRT SCOPE CMD 645 CMD TRACES WF 650 CALL IBWRT SCOPE CMD 660 CALL IBRD SCOPE RD1 Discard first 3 chars of response 665 CALL IBRDF SCOPE FILES 670 IF IBSTA lt O THEN GOTO 840 675 PRINT 680 RETURN 700 705 SUBROUTINE RECALL DATA 710 715 LINE INPUT Specify target memory MC MD MEM 720 LINE INPUT Enter filename FILES 730 CMD MEM TRACE ON 735 CALL IBWRT SCOPE CMD 740 CALL IBWRTF SCOPE FILES 745 IF IBSTA lt O THEN GOTO 840 750 PRINT 755 RETURN 800 810 ERROR HANDLER 820 830 PRINT IBFIND ERROR 835 END 840 PRINT GPIB ERROR IBERR IBERR IBSTA HEX IBSTA 845 END EXAMPLE 3 GPIB PROGRAM FOR IBM PC LOW LEVEL FUNCTION CALLS The following example has the same function as example 2 but it is 202 written with low level function calls The program assumes that the controller board and oscilloscope device are at addresses 0 and 4 respectively The decimal listen er and talker addresses of the controller and the device thus are Listener address Talker address controller 32 ASCII lt space gt 64 ASCII device 32 4 36 ASCII 64 4 68 ASCII D Appendix A 1 99 lt DECL BAS gt 100 CLS
84. T 117 PASS_FAIL_DO PFDO 118 PASS_FAIL_MASK PFMS 119 PER_CURSOR_SET PECS 121 PER_CURSOR_VALUE PECV 123 PERSIST PERS 120 PERSIST_SETUP PESU 124 PRE 125 RCL 126 RECALL REC 128 RECALL _ PANEL RCPN 127 RST 129 SAMPLE_CLOCK SCLK 130 SAV 131 SCREEN_DUMP SCDP 132 SEGMENTS SEGS 133 SELECT SEL 134 SRE 135 STB 136 137 STOP 138 STORE STO 139 STORE_PANEL STPN 140 STORE_SETUP STST 141 STORE_TEMPLATE STTM 143 TEMPLATE TMPL 144 TIME_DIV TDIV 145 146 TRACE TRA 147 TRG 148 TRIG_COUPLING TRCP 149 150 TRIG_DELAY TRDL 150 TRIG_LEVEL TRLV 151 152 TRIG_MODE TRMD 152 TRIG_PATTERN TRPA 2 ch amp 4 ch with ext trigger 153 TRIG_PATTERN TRPA 4 ch without ext trigger 154 TRIG_SELECT TRSE 155 157 TRIG SLOPE TRSL 158 TST 159 URR 160 VERT_MAGNIFY VMAG 161 VERT_POSITION VPOS 162 VOLT_DIV VDIV 163 WAI 164 WAIT 165 WAVEFORM WF 166 167 WAVEFORM_SETUP WFSU 168 170 WAVEFORM_TEXT WFTX 170 XY_ASSIGN XYAS 171 XY_CURSOR_ORIGIN XYCO 172 XY_CURSOR_SET XYCS 173 174 XY_CURSOR_VALUE XYCV 175 XY_DISPLAY XYDS 176 ZOOM 177 Commands and Queries 4 6 9 Continuous Polling 21 Controller Timeout 4 13 19 22 200 COUPLING CPL Command Query 59 CURSOR_MEASURE CRMS Command Query 60 CURSOR_SET CRST Command Query 61 62 CURSOR_VALUE CRVA Query 63 Customer Service
85. T PERS Command Query The PERSIST command enables or disables the persistence dis play mode PERSist lt mode gt lt mode gt ON OFF PERSist PERSist lt mode gt The following code turns the persistence display ON CMD PERS ON CALL IBWRT SCOPE CMDS PERSIST_SETUP XY_DISPLAY CURSOR DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format System Commands 5 PER_CURSOR_SET PECS Command Query The PER_CURSOR_SET command allows the user to position any one of the six independent cursors at a given screen location The position of the cursor can be modified or queried even if the cursor is not currently displayed on the screen The PER_CURSOR_SET query indicates the current position of the cursor s Notation HABS Horizontal absolute VABS Vertical absolute HREF Horizontal reference VREF Vertical reference HDIF Horizontal difference VDIF Vertical difference PEr_Cursor_Set lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt HABS VABS HREF HDIF VREF VDIF lt position gt 0 to 10 DIV horizontal 4 to 4 DIV vertical Note 1 The suffix DIV is optional Note 2 Parameters are grouped in pairs The first one names the variable to be modified and the second one gives the new value to be assigned Pairs may be in any order and may be restricted to those variables to be changed PEr_Cursor_Set lt c
86. TE option lets you save a factor of two on the amount of data to be transmitted or stored If your computer is not able to read binary data the HEX option allows a response form where the value of each byte is given by a pair of hexadecimal digits Data only transfers The COMM_HEADER OFF mode will allow you to get a response to WF DAT1 with the data only the C1 WF DAT 1 will disap pear If you have also specified COMM_FORMAT OFF BYTE BIN you will just get a response of data bytes the 90000nnnnn will disappear e Formatting for RS 232 users The COMM_RS232 command can help you by splitting the very long WF response into individual lines In order to achieve the maximum continuous data transfer rates from the oscilloscope to your instrument you will have to optimize many factors The single most important point is to limit the work done in your computer This means avoiding having to write the data to disk minimizing the per data point computations minimiz Waveform Structure 6 ing the number of calls to the IO system etc You can let the instrument help by reducing the number of points to be transferred and the number of data bytes per point The pulse parameter ca pability and the processing functions can save you lots of computing and lots of data transfer time if employed creatively Two other very important principles are Try to overlap waveform acquisition with waveform transfer The oscilloscope is capa
87. The command STB reads and clears the STB in the query mode in which case bit 6 of the STB is the MSS bit indicating if the instrument has any reason for requesting service The other way of reading the STB is the serial poll see Section 3 page 22 for the GPIB serial poll procedure In this case bit 6 of the STB is the RQS bit indicating that the instrument has actually activated the SRQ line on the GPIB The serial poll only clears the RQS bit Therefore the MSS bit of the STB and any other bits which caused MSS to be set will stay set after a serial poll The controller must reset these bits The Status Byte Register may be read via the query STB The response represents the binary weighted sum of the register bits The register is cleared by STB ALST CLS or after the instrument has been powered up The ESR is a 16 bit register reflecting the occurrence of events The register bit assignments have been standardized by IEEE 488 2 Only the lower 8 bits are currently in use The Standard Event Status Register may be read via the query ESR The response is the binary weighted sum of the register bits The register is cleared with an ESR or ALST query a CLS command or after power on The response message ESR 160 indicates that a command er ror occurred and that the ESR is being read the first time after power on The value 160 can be broken down into 128 bit
88. UBARRAY_COUNT for Average or Extrema number of sweeps accumulated else 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 209 Appendix B a E a to the lower edge of the grid lt 172 gt NOMINAL_BITS word a measure of the intrinsic precision of the observation ADC data is 8 bit averaged data is 10 12 bit etc lt 174 gt NOM_SUBARRAY_COUNT word for Sequence nominal segment count else 1 lt 176 gt HORIZ_ INTERVAL float sampling interval for time domain waveforms lt 180 gt HORIZ OFFSET double trigger offset for the first sweep of the trigger seconds between the trigger and the first data point lt 188 gt PIXEL_OFFSET double needed to know how to display the waveform lt 196 gt VERTUNIT unit_definition units of the vertical axis lt 244 gt HORUNIT unit_definition units of the horizontal axis lt 292 gt RESERVED3 word lt 294 gt RESERVED4 word 2 expansion entries lt 296 gt TRIGGER TIME time stamp time of the trigger lt 312 gt ACQ_DURATION float duration of the acquisition in sec in multi trigger waveforms e g sequence RIS or averaging lt 316 gt RECORD_TYPE enum Single_sweep 1 interleaved 2 histogram 8 trend 4 filter coefficient 5 complex 6 extrema 7 sequence_obsolete endenum 210 Append
89. UTO_SETUP BANDWIDTH_LIMIT INTERLEAVED SAMPLE CLOCK SEGMENTS STOP TRG WAIT To select vertical input parameters to capture waveforms ATTENUATION COUPLING OFFSET VOLT_DIV To select time base parameters to capture waveforms TIME_DIV TRIG_DELAY To select trigger conditions to capture waveforms TRIG_COUPLING TRIG_LEVEL TRIG_MODE TRIG_PATTERN TRIG_SELECT TRIG_SLOPE To set communication characteristics COMM_FORMAT COMM_HEADER COMM_HELP COMM_ORDER COMM_RS232 PERSIST_SETUP 35 5 System Commands Cursor To perform measurements CURSOR_MEASURE CURSOR_SET CURSOR_VALUE PARAMETER_VALUE PER_CURSOR_SET PER_CURSOR_VALUE XY_CURSOR_ORIGIN XY_CURSOR_SET XY_CURSOR_VALUE Display To display waveforms DISPLAY DUAL_ZOOM GRID HOR_MAGNIFY HOR_POSITION INTENSITY MULTI_ZOOM PERSIST SELECT TRACE VERT_MAGNIFY VERT_POSITION XY_ASSIGN XY_DISPLAY ZOOM To display messages to a local user CALL_HOST KEY MESSAGE Function To perform mathematical operations on waveforms DEFINE FUNCTION_RESET FUNCTION_STATE Hard Copy To plot or print the contents of the display screen HARDCOPY_SETUP HARDCOPY_TRANSMIT SCREEN_DUMP Save Recall Setup To preserve and restore front panel settings PANEL_SETUP RCL RECALL_PANEL RST SAV STORE_PANEL Status To obtain status information and set up service requests ALL_STATUS CLS CMR DDR ESE ESR EXR INE INR IST OP
90. _DIV lt v_gain gt lt channel gt C1 C2 C3 C4 9410 14 30 All others lt v_gain gt 4 mvto2 5V 15 0 mV to 2 5 V Note The suffix V is optional lt channel gt Volt_DIV lt channel gt Volt_DIV lt v_gain gt The following command sets the vertical sensitivity of channel 1 to 50 mV div CMD C1 VDIV 50MV CALL IBWRT SCOPE CMD 163 5 System Commands STATUS WAI Command DESCRIPTION The WAI WAIt to continue command required by the IEEE 488 2 standard has no effect on the oscilloscope as the oscillo scope only starts processing a command when the previous command has been entirely executed Note This command can be executed in both local and remote modes Command syntax WAI RELATED COMMANDS OPC 164 System Commands 5 ACQUISITION WAIT Command DESCRIPTION The WAIT command prevents the instrument from analyzing new commands until the oscilloscope has completed the current acqui sition process COMMAND SYNTAX WAIT EXAMPLE send TRMD SINGLE loop send ARM WAIT C1 PAVA MAX read response process response This example finds the maximum amplitudes of several signals ac quired 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 instrument to evaluate the maxi mum data value in the Channel 1 waveform 165 5 System Commands
91. a array If there are two data arrays FFT or Extrema this number applies to each array separately lt 120 gt PNTS_PER_SCREEN long nominal number of data points on the screen lt 124 gt FIRST_VALID_PNT long count of number of points to skip s before first good point FIRST_VALID_POINT O for normal waveforms 208 Appendix B lt 128 gt lt 132 gt lt 136 gt lt 140 gt lt 144 gt lt 148 gt lt 152 gt lt 156 gt lt 180 gt lt 164 gt lt 168 gt LAST_VALID_PNT long FIRST_POINT long SPARSING_FACTOR long SEGMENT_INDEX long SUBARRAY_COUNT long SWEEPS_PER_ACQ long OBSOLETE1 long VERTICAL_GAIN float VERTICAL_OFFSET float MAX_VALUE float MIN_VALUE float 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 O and NOM_S
92. al parameter A may be used to abort a screen dump SCreen_DumP SCreen_DumP lt status gt lt status gt ON OFF The following code initiates a screen dump CMD SCDP CALL IBWRT SCOPE CMDS INR HARDCOPY_SETUP HARDCOPY_TRANSMIT System Commands 5 ACQUISITION SEGMENTS SEGS Command Query DESCRIPTION The SEGMENTS command sets the number of segments for se quence mode acquisition The response to the SEGMENTS query indicates the number of segments which is set in the oscilloscope COMMAND SYNTAX SEGmentS lt segments gt 9410 14 All others lt segments gt 2 5 10 20 50 2 5 10 20 50 100 200 QUERY SYNTAX SEGmentS Response Format SEGmentS lt segments gt EXAMPLE The following command sets the segment count to 100 CMD SEGS 100 CALL IBWRT SCOPE CMD RELATED COMMANDS TRIG_MODE 133 5 System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 134 SELECT SEL Command Query The SELECT command selects the specified trace for manual dis play control An environment error Table 6 page 84 is generated if the specified trace is not displayed The SELECT query returns the selection status of the specified trace lt trace gt SELect lt trace gt EA EB MC MD FE FF lt trace gt SELect lt trace gt SELect lt mode gt lt mode gt ON OFF The following command sel
93. allel Poll Enable Register PRE which acts exactly like the Service Request Enable Register SRE but it sets the ist bit not shown in Figure 2 used in the Parallel Poll The ist bit can also be read with the IST query If an erroneous remote command e g TRIG_MAKE SINGLE is transmitted to the instrument it rejects the command and sets the Command Error Register CMR to the value 1 unrecognized command query header The non zero value of CMR is reported to bit 5 of the Standard Event Status Register ESR which is then set Nothing further happens unless the corresponding bit 5 of the Standard Event Status Enable Register ESE is set with the com mand ESE 32 enabling the fact that bit 5 of ESR is set to be reported to the summary bit ESB of the Status Byte Register STB If setting of the ESB summary bit in STB is enabled again nothing happens unless further reporting is enabled by setting the corre sponding bit in the Service Request Enable Register with the command SRE 32 In this case the generation of a non zero value of CMR ripples through to the Master Summary Status bit MSS generating a Service Request SRQ The value of CMR can be read and simultaneously reset to zero at any time with the command CMR The occurrence of a com mand error can also be detected by analyzing the response to ESR However if several types of potential errors must be surveyed it
94. anitoba 613 521 8251 Rayonics Quebec 514 335 0105 Rayonics W Canada 604 293 1854 Denmark Lutronic 42 459764 Finland Labtronic OY 90 847144 France LeCroy Sarl 1 69073897 Germany LeCroy GmbH 06221 831001 North 0405 42713 Greece Hellenic S R Ltd 01 721 1140 India Electronic Ent 022 4137096 Israel Ammo 03 453157 Italy LeCroy S r 1l Roma 06 300 9700 Milano 02 2940 5634 02 204 7082 Japan LeCroy Japan Tokyo 0081 3 376 9400 Osaka 0081 6 330 0961 Korea Samduk Science amp Ind Ltd 02 468 04914 Mexico Nucleoelectronica SA 905 593 6043 New Zealand E C Gough Ltd 03 798 740 Norway Avantec A S 02 630520 Pakistan Electronuclear Corp 021 418087 Portugal M T Brandao Lta 02 691116 Singapore Singapore Electronics and Eng Ltd 065 481 8888 Spain Tempel SA 36 3323 4278 Sweden MSS AB 0764 68100 Switzerland LeCroy S A 022 719 21 11 Taiwan Topward El Inst Ltd 02 601 8801 Thailand Measuretronix Ltd 02 374 2516 United Kingdom LeCroy Ltd 0235 33 114 LeCROY CORPORATE HEADQUARTERS 700 Chestnut Ridge Road Chestnut Ridge NY 10977 6499 Telephone 914 425 2000 TWX 710 577 2832 Fax 914 425 8967 LeCROY EUROPEAN HEADQUARTERS 2 rue du Pr de la Fontaine P O Box 341 1217 Meyrin 1 Geneva Switzerland Tel 022 719 21 11 Telex 419 058 Fax 022 782 39 15
95. annel 2 hardware failure is detected a Channel 1 hardware failure Is detected 1 0 Reserved t a Channel 4t overload condition is detected me fp 4 1 a Channel 3 overload condition is detected 1 1 a Channel 1 overload condition is detected Device Specific Register Structure DDR Table 4 4 channel oscilloscopes only reserved in the 2 channel oscilloscopes 66 1 1 a Channel 2 overload condition is detected System Commands A FUNCTION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format 4 channel oscilloscopes only DEFINE DEF Command Query Standard Oscilloscopes The DEFINE command specifies the mathematical expression to be evaluated by a function Notation MAXPTS maximum number of points SWEEPS maximum number of sweeps equation AVGS average summed Channel 1 C2 Channel 2 Channel 34 C4 Channel 4 lt function gt DEFine EQN lt equation gt MAXPTS lt max_points gt SWEEPS lt max_sweeps gt lt function gt MC MD FE FF lt equation gt lt source gt lt source gt lt source gt lt source gt lt source gt lt source gt AVGS lt source gt lt source gt C1 C2 C3 C4 lt max_points gt 50 to 10000 50 to 50000 lt max_sweeps gt 1 to 1000 Note 1 Parameters are grouped in pairs The first one names the variable to be modified and the second one gives the new val
96. antability fitness or adequacy for any particular purpose or use LeCroy shall not be liable for any special incidental or con sequential damages whether in contract or otherwise Answers to questions concerning installation calibration and use of LeCroy equipment are available from the Customer Service Department 700 Chestnut Ridge Road Chestnut Ridge New York 10977 6499 U S A tel 914 578 6061 and 2 rue du Pr de la Fontaine 1217 Meyrin 1 Geneva Switzerland tel 41 22 719 21 11 or your local field engineering office LeCroy offers a selection of customer support services Mainte nance agreements provide extended warranty and allow the customer to budget maintenance costs after the initial two year warranty has expired Other services such as installation training enhancements and on site repair are available through specific Supplemental Support Agreements 1 General Information DOCUMENTATION DISCREPANCIES SERVICE PROCEDURE RETURN PROCEDURE LeCroy is committed to providing state of the art instrumenta tion and is continually refining and improving the performance of its products While physical modifications can be implemented quite rapidly the corrected documentation frequently requires more time to produce Consequently this manual may not agree in every detail with the accompanying product There may be small discrepancies in the values of components for the purposes of pulse shape timing offse
97. at XY_Cursor_Set lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt lt position gt EXAMPLE GPIB The following command positions the XREF and YDIF at 3 DIV and 2 DIV respectively CMDS XYCS XREF 3DIV YDIF 2DIV CALL IBWRT SCOPE CMDS 174 System Commands g CURSOR DESCRIPTION Parameter Names QUERY SYNTAX Response Format EXAMPLE GPIB XY_CURSOR_VALUE XYCV Command Query The XY_CURSOR_VALUE query returns the current values of the X versus Y trace parameters The X versus Y trace does not need to be displayed to obtain these parameters but valid sources must be assigned to the X and Y axes lt cursor type gt _X X lt cursor type gt _Y Y lt cursor type gt _RATIO AY AX lt cursor type gt _PROD AY AX lt cursor type gt _ANGLE arc tan AY AX lt cursor type gt _RADIUS sqrt AX AX AY AY lt cursor_type gt HABS HREL VABS VREL XY_Cursor_ Value lt parameter gt lt parameter gt lt parameter gt HABS_X HABS_Y HABS_RATIO HABS_ PROD HABS_ANGLE HABS_RADIUS HREL_X HREL_Y HREL_ RATIO HREL_ PROD HREL _ANGLE HREL_RADIUS VABS_X VABS_Y VABS_RATIO VABS_ PROD VABS_ANGLE VABS_RADIUS VREL_X VREL_Y VREL_RATIO VREL_PROD VREL_ANGLE VREL_RADIUS ALL Note If lt parameter gt is not specified or equals ALL all the mea sured cursor values are returned If the value of a cursor could not be determined in the current environme
98. be inserted Before using the string the oscilloscope will replace the escape sequence by the corresponding ASCI character For example the escape sequences Nr 13 and O13 are all replaced by the single ASCII character lt Carriage Return gt Notation DUPLEX duplex El End input character EO End output string LL Line length LS Line separator SRQ SRQ Service request COmm_RS232 DUPLEX lt duplex gt EI lt ei_char gt EO lt eo_string gt LL lt line_length gt LS lt Line_sep gt SRQ lt srq_string gt lt duplex gt FULL only full duplex is currently implemented lt ei_char gt 1 to 126 default 13 lt CR gt lt eo_string gt A non empty ASCII string of up to 20 characters default n r lt line_length gt 40 to 1024 default 256 lt line_sep gt OFF CR LF CRLF default OFF lt srq_string gt An ASCII string which may be empty default empty string 57 5 System Commands QUERY SYNTAX COmm_RS232 Response Format COmm_RS232 DUPLEX lt duplex gt EI lt ei_char gt EO lt eo_string gt LL lt line_length gt LS lt line_sep gt SRQ lt srq_string gt EXAMPLE After executing the command COMM_RS232 EI 3 EO R NEND R N the oscilloscope will assume that it has received a complete mes Sage each time the lt ETX gt decimal value 3 is detected Response messages will be terminated by sending the character sequence
99. ber of remote control operations it is sufficient to use just 3 different subroutines IBFIND IBRD and IBWRT pro vided by National Instruments The following complete program reads the time base setting of the oscilloscope and displays it on the terminal 1 99 lt DECL BAS gt 100 DEV DEV4 110 CALL IBFIND DEV SCOPE 120 CMD TDIV 130 CALL IBWRT SCOPE CMD 140 CALL IBRD SCOPE RD 150 PRINT RD 160 END Explanation GPIB Operation 3 Lines 1 99 are a copy of the file DECL BAS supplied by National Instruments The first 6 lines are required for the initialization of the GPIB handler The other lines are declarations which may be useful for larger programs but are not really required code The sample program above only uses the strings CMD and RD which are declared in DECL BAS as arrays of 255 characters Note DECL BAS requires access to the file BIB M during the GPIB initialization BIB M is one of the files supplied by National Instruments and it must exist in the directory currently in use Note The first 2 lines of DECL BAS each contain a string XXXXX which must be replaced by the number of bytes which determine the maximum workspace for BASICA computed by subtracting the size of BIB M from the space currently available in BASICA For example if the size of BIB M is 1200 bytes and when BASICA is loaded it reports 60200 bytes free you should replace XXXXX by the value 59000 or less
100. betical order Each command starts on a new page and the name header of the command is given in both the long and short forms Below each name header it is indicated whether it denotes a command only a command as well as a query or a query only For those headers that may be used to command an action for example to modify a setup parameter or to obtain some information such as the current value of a setup parameter the query form is derived by appending a question mark immediately to the header without intervening spaces The description of each command starts with a short explanation of the function performed by it followed by a presentation of the formal syntax In the formal syntax the header appears in mixed mode characters with the characters used to construct the short form shown in upper case Where applicable the syntax of the query form is given along with the format of the response the oscilloscope will produce For most commands the description terminates with a short exam ple illustrating a typical use of the command The GPIB examples assume that the controller is equipped with a National Instruments interface board and they show calls to the National Instruments interface subroutines in BASIC The device name of the oscillo scope has been defined as SCOPE The following is an overview of the commands grouped according to their functionality To control the acquisition of waveforms ARM_ACQUISITION A
101. ble of transferring an already acquired or pro cessed waveform after a new acquisition has been started This can also considerably increase the total time that the oscilloscope will be able to acquire events if it has to wait for triggers livetime Minimize the number of waveform transfers by using the se quence mode to accumulate many triggers for each transfer This is preferable to using the WAVEFORM_SETUP command to re duce the number of data points to be transferred It also reduces the oscilloscope transfer overhead significantly Here is an example of the type of commands to be given ARM to acquire the first event or sequence WAIT ARM C1 WF to wait for the event start the next acqui sition and then transfer the data This second line can be repeated by your program as soon as it has finished reading the waveform 189 N OVERVIEW OF STATUS AND SERVICE REQUEST REPORTING STATUS REGISTERS An extensive set of status registers allows the user to quickly deter mine the oscilloscope s internal processing status at any time The status registers as well as the status reporting system have been designed to comply with IEEE 488 2 recommendations Related functions are grouped together in common status registers Some such as the Status Byte Register STB or the Standard Event Status Register ESR are required by the IEEE 488 2 stan dard However other registers are device specific They include the Command Er
102. cannot accept responsibility for shortages in comparison with the Packing List unless notified promptly If the shipment is damaged in any way please contact the Customer Service Depart ment or local field office immediately LeCroy warrants its oscilloscope products to operate within specifi cations under normal use for a period of two years from the date of shipment Spares replacement parts and repairs are warranted for 90 days The instrument s firmware is thoroughly tested and thought to be functional but is supplied as is with no warranty of any kind covering detailed performance Products not manufac tured by LeCroy are covered solely by the warranty of the original equipment manufacturer In exercising this warranty LeCroy will repair or at its option replace any product returned to the Customer Service Department or an authorized service facility within the warranty period pro vided that the warrantor s examination discloses that the product is defective due to workmanship or materials and that the defect has not been caused by misuse neglect accident or abnormal con ditions or operation The purchaser is responsible for transportation and insurance charges for the return of products to the servicing facility LeCroy will return all in warranty products with transportation prepaid This warranty is in lieu of all other warranties expressed or im plied including but not limited to any implied warranty of merch
103. ck 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 present BLOCKS lt 36 gt WAVE_DESCRIPTOR long length in bytes of block WAVEDESC lt 40 gt USER_TEXT long length in bytes of block USERTEXT lt 44 gt RES _DESC1 long ARRAYS lt 48 gt TRIGTIME_ ARRAY long length in bytes of TRIGTIME array 207 Appendix B SN neal lt 52 gt RIS TIME ARRAY long length in bytes of RIS TIME array lt 56 gt RES_ARRAY1 long an expansion entry is reserved lt 60 gt WAVE_ARRAY_1 long length in bytes of 1st simple gt 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 lt 64 gt WAVE_ARRAY_2 long length in bytes of 2nd simple data array lt 68 gt RES_ARRAY2 long lt 72 gt RES _ARRAY3 long 2 expansion entries are reserved The following variables identify the instrument lt 76 gt INSTRUMENT_NAME string i 92 gt INSTRUMENT_NUMBER long 96 gt TRACE LABEL string identifies the waveform oe RESERVED1 word lt 114 gt RESERVED2 word 2 expansion entries The following variables describe the waveform and the time at which the waveform was generated lt 116 gt WAVE ARRAY_COUNT long number of data points in the dat
104. d by the controller The oscilloscope must be set to an address between 0 and 30 which differs from the controller s and the hard copy device s address Different schemes can be used to transfer the screen contents 1 The controller reads the data into internal memory and then sends them to the printer plotter This alternative can be done with simple high level GPIB function calls 2 The oscilloscope sends data to both the controller and the printer plotter 3 The controller goes into a standby state The oscilloscope becomes a talker and sends data directly to the printer plot ter The controller stores the full set of printer plotter instructions and sends them afterwards to the graphics device This method is the most straightforward way of transferring screen contents but it re quires a large amount of buffer storage 110K for 4 traces CMD SCDP CALL IBWRT SCOPE CMDS FILE PLOT DAT CALL IBRDF SCOPE FILE CALL IBWRTF PLOTTER FILE The oscilloscope puts the printer plotter instructions on to the bus The data is directly plotted out and saved in scratch memory in the controller The contents of the scratch file can be deleted later on Stage 1 Controller talker oscilloscope listener Issue the screen dump command CMD1 _ CALL IBCMD BRD0 CMD1 CMD SCDP CALL IBWRT BRD0 CMDS Stage 2 Oscilloscope talker controller and plotter listeners Plot data while storing data in scratch fi
105. d to create a file to delete a file or to format the card Bad memory card detected during formatting Memory card root directory full LECROY_1 DIR subdirectory cannot be created Memory card full when user attempted to write to it Memory card file sequence numbers exhausted 999 reached Memory card file not found Attempt to retrieve a file from memory card that is neither a waveform nor a panel Memory card file is write protected DOS Read Only attribute speeds card filename not DOS compatible or waveform filename begins with an AY A retrieved panel or waveform contains invalid bytes or a waveform is too long for the instrument Read Write outside of memory card cluster chains Can indicate a corrupted FAT table Can also indicate a waveform or panel file with a length shorter than the internal byte count Execution Error Status Register Structure EXR Table 6 only oscilloscopes equipped with the memory card option 84 System Commands 5 MISCELLANEOUS FORMAT_CARD FCRD Command Query Oscilloscopes fitted with the MC01 Option DESCRIPTION The FORMAT_CARD command formats the memory card ac cording to the PCMIA JEIDA standard with a DOS partition The FORMAT _CARD query returns the status of the card COMMAND SYNTAX Format_CaRD QUERY SYNTAX Format_CaRD Response format Format_CaRD lt card_status gt lt read write gt lt free_space gt lt card_size gt lt battery_status g
106. data format the values would have been signed integers in the range 128 80 hex to 127 7f hex Now that we know how to decipher the data it would be useful 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 corre sponds to the volts div and voltage 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 respectively of the descriptor 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 verti cal value is given by the relationship value VERTICAL_GAIN data VERTICAL_OFFSET A data value of 0 is normally displayed as a point in the middle of the grid Calculating the horizontal position of a data point Waveform Structure 6 In the case of the data shown above we find VERTICAL_GAIN 1 22070314e 05 from the floating point number 374c cccd at byte 177 VERTICAL OFFSET 1 56250596e 03 from the floating point number 3acc cd00 at byte 181 V volts from the string 5600 at byte 217 VERTICAL_UNIT and therefore since data 0 512 from the hexadecimal word 0200 at byte 367 value 0 0 00468 V as stated in the inspect command above and since data 1
107. div _7 200 _uV div _8 00_uv div _9 1_mV div _10 2 _mV div _11 5 _mV div _12 10 _mV div _13 20_mV div _14 50 mV div _15 100_mV div _16 200 _mV div _17 500_mV div _18 1_V div _19 2 _V div _20 _V div _21 10_V div _22 20 _V div _28 80_V div _24 100_V div _25 200 _V div _26 500 _V div _27 1_kV div endenum lt 334 gt BANDWIDTH_LIMIT enum _0 off _1 on endenum lt 336 gt VERTICAL_VERNIER float lt 340 gt ACQ_VERT_OFFSET float lt 344 gt WAVE_SOURCE enum O0 CHANNEL_1 1 CHANNEL _2 2 CHANNEL_3 _3 CHANNEL_4 _9 UNKNOWN endenum 213 Appendix B 00 ENDBLOCK a ee ee ee ee ee Z2 I I IZI TS SS SS ee ee ee ee Oe ee ee ee ee ee ee we i ee Seo eee ee ee ee ee eS Eee eee Se ee eee ee o o See ee oO ewe eS ee ee ee eS a USERTEXT BLOCK Explanation of the descriptor block USERTEXT at most 400 bytes long lt 0 gt DESCRIPTOR_NAME string the first 8 chars are always USERTEXT lt 16 gt TEXT text gt a list of ASCII characters 00 ENDBLOCK a r N a e a e A e o s e y n i e E D a a a p e e y e a o e e S G S l O ee ee eee Z T eee ee ee ee ee a e l a a a l X ee ee ee eee ee o eee ee ee ee SS eee DATA_ARRAY_1 ARRAY Explanation of the data array DATA_ARRAY_1 The data item is repeated for each acquired or computed data point of the first data array of any waveform lt 0 gt MEASUREMENT data the actual format of a data is given in the WAVEDESC desc
108. e This command can be executed in both local and remote modes COMMAND SYNTAX PRE lt value gt lt value gt 0 to 65 535 QUERY SYNTAX PRE Response format PRE lt value gt EXAMPLE GPIB The following command 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 This yields the PRE value 16 CMD PRE 16 CALL IBWRT SCOPE CMDS RELATED COMMANDS IST 125 5 System Commands SAVE RECALL SETUP DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 126 RCL Command The RCL command sets the state of the instrument using one of the eight non volatile panel setups by recalling the complete front panel setup of the instrument Panel setup 0 corresponds to the default panel setup The RCL command produces the opposite effect 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 RCL lt panel_setup gt lt panel_setup gt 0 to 7 The following code recalls the instrument setup previously stored in panel setup 5 CMD RCL 5 CALL IBWRT SCOPE CMD PANEL SETUP SAV EXR System Commands 5 SAVE RECALL SETUP RECALL_PANEL RCPN Command Oscilloscopes fitted with the MCO1 Option DESCRIPTION The RECALL_PANEL command recalls a front panel setup from the memory card COMMAND SYNT
109. e cleared CMD CLS CALL IBWRT SCOPE CMD ALL_STATUS CMR DDR ESR EXR STB URR System Commands 5 STATUS CMR Query DESCRIPTION The CMR query reads and clears the contents of the CoMmand error Register CMR The CMR register Table 2 specifies the last syntax error type detected by the instrument QUERY SYNTAX CMR Response format CMR lt value gt lt value gt 1 to 13 EXAMPLE GPIB The following instruction reads the contents of the CMR register CMD CMR CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message CMR 0 RELATED COMMANDS ALL_STATUS CLS Description Unrecognized command query header ilegal header path Illegal number Ilegal 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 EO detected during definite length data block transfer Extra bytes detected during definite length data block transfer i 2 3 4 5 6 7 0 1 1 1 GQ N Command Error Status Register Structure CMR Table 2 49 5 System Commands COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB EXPLANATION 50 COMM_FORMAT CFMT Command Query The COMM_FORMAT command selects the format which the oscilloscope will use to send waveform data The available option
110. e Format EXAMPLE GPIB 78 DISPLAY DISP Command Query The DISPLAY command controls the display screen of the oscillo scope When the user is remotely controlling the oscilloscope and does not need to use the display it may be useful to switch off the display via the DISPLAY OFF command This improves instru ment response time since the waveform graphic generation procedure is suppressed The response to the DISPLAY query indicates the display state of the oscilloscope Note When the display has been set to OFF the real time clock and the message field are updated However the waveforms and associated texts remain unchanged DISPlay lt state gt lt state gt ON OFF DISPlay DISPlay lt state gt The following instruction turns off the display generation CMD DISP OFF CALL IBWRT SCOPE CMD System Commands 5 DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS DUAL_ZOOM DZOM Command Query By setting DUAL_ZOOM ON the horizontal magnification and positioning controls apply to all expanded traces simultaneously This command is useful if the contents of all expanded traces are to be examined at the same time The DUAL_ZOOM query indicates whether multiple zoom is en abled or not Note This command has the same effect as MULTI_ZOOM Dual_ZOoM lt mode gt lt mode gt ON OFF Dual_ZOoM Dual_ZOoM lt mode gt
111. e changed lt trace gt CuRsor_SeT lt cursor gt lt cursor gt lt cursor gt HABS VABS HREF HDIF VREF VDIF PREF PDIF ALL lt trace gt CuRsor_SeT lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt lt position gt If lt cursor gt is not specified ALL will be assumed If the position of a cursor cannot be determined in a particular situation its posi tion will be indicated as UNDEF The following command positions the VREF and VDIF cursors at 3 DIV and 7 DIV respectively using Function E as a reference CMD FE CRST VREF 3DIV VDIF 7DIV CALL IBWRT SCOPE CMD CURSOR_MEASURE CURSOR VALUE PASS FAIL COUNTER PASS_FAIL_DO PASS FAIL _MASK PARAMETER_VALUE CURSOR DESCRIPTION QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 4 channel oscilloscopes only System Commands 5 CURSOR_VALUE CRVA Query The CURSOR_VALUE query returns the values measured by the specified cursors for a given trace The PARAME TER_VALUE query is used to obtain measured waveform parameter values Notation HABS Horizontal absolute HREL Horizontal relative VABS Vertical absolute VREL Vertical relative lt trace gt CuRsor_VAlue lt mode gt lt mode gt lt trace gt EA EB MC MD FE FF C1 C2 C3 C4 lt mode gt HABS VABS HREL VREL ALL lt trace gt CuRsor_VAlue lt mode gt lt hor_value gt lt ver_value
112. e controller configures the GPIB for specific functions refer to the GPIB interface man ufacturer s manual The interface capabilities of the oscilloscope include the following IEEE 488 1 definitions AH1 Complete Acceptor Handshake SH1 Complete Source Handshake L4 Partial Listener Function TS Complete Talker Function SR1 Complete Service Request Function RL1 Complete Remote Local Function DC1 Complete Device Clear Function DT1 Complete Device Trigger PP1 Parallel Polling remote configurability Co No Controller Functions E2 Tri state Drivers 3 GPIB Operation See ADDRESSING GPIB SIGNALS Data Lines Handshake Lines Interface Management Lines 12 Every device on the GPIB has an address When the thumbwheel address switches on the rear panel of the oscilloscope are set to a value between 0 and 30 the instrument can be controlled via GPIB When the switches are set to above 30 the instrument can execute talk only operations on the GPIB for example driving a GPIB plotter In this case no controller is present and the instru ment is directly connected to the plotter Addresses above 30 also enable the instrument to be controlled via the RS 232 C port The instrument reads the address switches once at power on or when the RESET button on the rear panel is pressed If the ad dress is changed during operation the instrument must be powered again to enable the new address The value of the GPIB address appears in
113. e fraction exponent 11 bit exponent e fraction 52 bit fraction f and the final value is 1 s 2 e 1023 1 f 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 _ double precision floating point number for the number of seconds and some bytes for minutes hours days months and year double seconds 0 00 to 59 999999 byte minutes O to 59 byte hours 0O to 23 byte days 1 to 31 byte months 1 to 12 word year O 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 Appendix B 2 a aaa maximum 400 unit _definition a unit definition consists of a 48 character ASCII string terminated with a null byte for the unit name SSS SSS SSS S22 S252 5 2 SS S525 SS Leese es eee es eT SB ee eS eS Se Se eee eS eS See eee esse ese n n a a a a WAVEDESC BLOCK Explanation of the wave descriptor block WAVEDESC lt O gt DESCRIPTOR_NAME string the first 8 chars are always WAVEDESC lt 18 gt TEMPLATE_NAME string lt 32 gt COMM_TYPE enum s chosen by remote command COMM_FORMAT O byte 1 word endenum lt 34 gt COMM_ORDER enum _0 HIFIRST a LOFIRST endenum The following variables of this basic wave descriptor blo
114. e probe attenuation factor is not taken into account for adjusting the offset The OFFSET query returns the DC offset value of the specified channel 109 5 System Commands COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB 4 channel oscilloscopes only 110 lt channel gt OFfSeT lt offset gt lt channel gt C1 C2 C3 C4 lt offset gt 12V to 12V maximum range Note The suffix V is optional lt channel gt OFfSeT lt channel gt OFfSeT lt offset gt The following command sets the offset of Channel 2 to 3 V CMD C2 OFST 3V CALL IBWRT SCOPE CMDS STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format RELATED COMMANDS System Commands 5 OPC Command Query The OPC OPeration Complete command sets the OPC bit bit 0 in the standard Event Status Register ESR to true This com mand has no other effect on the operation of the oscilloscope as the instrument starts parsing a command or query only after it has completely processed the previous command or query The OPC query always responds with the ASCII character 1 as the oscilloscope responds to the query only once the previous command has been entirely executed Note This command can be executed in both local and remote modes OPC OPC OPC 1 WAI 111 5 System Commands MISCELLANEOUS OPT Query DESCRIPTION The OPT query identifies oscilloscope opti
115. e the bus I O Buffers IEEE 488 1 STANDARD MESSAGES Device Clear GPIB Operation 3 REN Remote ENable The controller uses this line to place de vices 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 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 The instrument has a 256 byte input buffer and a 256 byte output buffer An incoming program message is not decoded before a message terminator has been received However if the input buff er becomes full because the program message is longer than the buffer the instrument 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 The IEEE 488 1 standard specifies not only the mechanical and electrical aspects of the GPIB but also the low level transfer pro tocol e g it defines how a controller addresses devices turns them into talkers or listeners resets them or puts them in the re mote state Such interface messages are executed with the interface management lines of the GPIB usually with ATN true All of these messages except G
116. e to beep and stop acquiring when the test passes CMD Pass_ Fail_ DO PASS BEEP STOP CALL IBWRT SCOPE CMD PASS_FAIL_COUNTER PASS_FAIL_MASK PARAMETER _VALUE CURSOR_MEASURE CURSOR_SET System Commands 5 MISCELLANEOUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS PASS_FAIL_ MASK PFMS Command Query The PASS _FAIL_MASK command generates a tolerance mask around a selected waveform and stores the result in Memory C The PASS_FAIL_MASK query returns the current tolerance values lt trace gt Pass_Fail_ MaSk lt htol_minus gt lt htol_plus gt lt vtol_minus gt lt vtol_plus gt lt htol_minus gt lt htol_plus gt lt vtol_minus gt lt vtol_plus gt float numbers Note if any arguments are missing the previous settings will be used Pass_Fail_MaSk Pass_Fail_MaSk lt htol_minus gt lt htol_plus gt lt vtol_minus gt lt vtol_plus gt The following command generates a tolerance mask around the Channel 1 trace The tolerance is set at 1 5 V over the trace and 0 7 V under 25 nanoseconds before the trace and 12 after CMD C1 PASS_FAIL_MASK 25 NS 12 NS 0 7 V 1 5 V CALL IBWRT SCOPE CMD CURSOR_MEASURE CURSOR_SET PASS FAIL_COUNTER PASS_FAIL_DO PARAMETER_VALUE 119 A System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 120 PERSIS
117. ectly viewed Note This command can be executed in both local and remote modes The COMM_HELP query indicates if the diagnostics utility has been enabled Comm_HeLP lt target gt lt target gt RS OFF The initial lt target gt i e after power on is OFF Comm_HeLP Comm_HeLP lt target gt The following code turns on the remote control diagnostics utility CMD CHLP RS CALL IBWRT SCOPE CMD 53 5 System Commands COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE 54 COMM _ORDER CORD Command Query The COMM_ORDER command controls the byte order of wave form data transfers Waveform data may be sent with the most significant byte MSB or the least significant byte LSB in the first position The default mode is the MSB first COMM_ORDER applies equally to the waveform s descriptor and time blocks In the descriptor some values are 16 bits long word 32 bits long long or float or 64 bits long dou ble In the time block all values are floating values i e 32 bits long When COMM_ORDER HI is selected the most significant byte is sent first When COMM_ORDER LO is specified the least significant byte is sent first The COMM_ORDER query returns the byte transmission order currently in use Note This command can be executed in both local and remote modes Comm_ORDer lt mode gt lt mode gt HI
118. ects Expand B EB CMD EB SEL CALL IBWRT SCOPE CMD TRACE STATUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB System Commands 5 SRE Command Query The SRE command sets the Service Request Enable register SRE This command allows the user to specify which summary message bit s in the STB register will generate a service request Refer to Table 8 page 137 for an overview of the available sum mary messages A summary message bit is enabled by writing a 1 into the corre sponding bit location Conversely writing a 0 into a given bit location prevents the associated event from generating a service request SRQ Clearing the SRE register disables SRQ interrupts The SRE query returns a value which when converted to a bi nary number represents the bit settings of the SRE register Note that bit 6 MSS cannot be set and its returned value is always zero Note This command can be executed in both local and remote modes SRE lt value gt lt value gt 0 to 255 SRE SRE lt value gt The following command allows an SRQ to be generated as soon as the MAV summary bit bit 4 i e decimal 16 and or the INB summary bit bit 0 i e decimal 1 in the STB register are set Summing these two values yields the SRE mask 16 1 17 CMD SRE 17 CALL IBWRT SCOPE CMD 135 5 System Commands ef E O E STATUS DESCRIPTION QUERY SYNTAX Response
119. eform Structure Interpreting the waveform vertical data 184 STRUMENT_NAME at 76 bytes from the descriptor start or byte 97 above In a similar way we learn that a 4 byte long integer giving the length of the descriptor starts at byte 36 or byte 57 above WAVE_DESCRIPTOR 15a hex 346 At byte 60 or byte 81 above we find another 4 byte integer giving the length of the data array WAVE_ARRAY_1 54 hex 84 and at byte 116 or byte 137 above the number of data points WAVE_ARRAY_COUNT 2a hex 42 Now we know that the data will start at byte 346 from the begin ning of the descriptor or byte 367 above and that each of the 42 data points will be represented by two bytes The waveform has a total length of 346 84 which is the same as the ASCII string told us at the beginning of the block The final 0a at byte 451 is the NL character associated with the GPIB message terminator lt NL gt lt EOI gt The data can be easily seen starting at byte 367 above Since the example was taken using an oscilloscope with an 8 bit ADC we see those 8 bits followed by a 0 byte for each data point It should be noted that for oscilloscopes with 10 bit ADCs or for many other kinds of waveform this second byte will not be zero and contains interesting 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
120. em Commands 5 MISCELLANEOUS PASS_FAIL_COUNTER PFCT Command Query DESCRIPTION The PASS_FAIL_COUNTER command resets the Passed Failed acquisitions counter The PASS _FAIL_COUNTER query re turns the current count COMMAND SYNTAX Pass_Fail_CounTer QUERY SYNTAX Pass_Fail_CounTer Response Format Pass_Fail_CounTer lt pass_fail gt lt value gt OF lt value gt lt pass fail gt PASS FAIL lt value gt 0 to 999999 RELATED COMMANDS CURSOR MEASURE CURSOR_SET PASS_FAIL_DO PASS_FAIL_MASK PARAMETER_VALUE 117 5 System Commands MISCELLANEOUS DESCRIPTION COMMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 118 PASS FAIL DO PFDO Command Query The PASS_FAIL_DO command defines the actions that have to be performed by the oscilloscope after a Pass Fail test The PASS_FAIL_DO query indicates which actions are currently se lected Notation STOP Stop acquisition SCDP Make a hardcopy STO Store in Memory PULS Send a pulse from the rear panel accessory BEEP Emit a loud beep STCD Store to Memory Card Pass_Fail_ DO lt pass_fail gt lt act gt lt act gt lt pass_fail gt PASS FAIL lt act gt STOP SCDP STO PULS BEEP STCD Note The PFDO command with no arguments i e PFDO deletes all actions Pass_Fail_DO Pass_Fail_ DO lt pass_fail gt lt act gt lt act gt The following command forces the oscilloscop
121. ernal state change Register INR until the corresponding bit in this case bit 0 i e value 1 is non zero to indicate that a new waveform has been acquired Reading INR clears it at the same time so that there is no need for an additional clearing action after a non zero value has been de tected The command CHDR OFF instructs the instrument to omit any command headers when responding to a query This sim plifies the decoding of the response The instrument would therefore send 1 rather than INR 1 CMD CHDR OFF CALL IBWRT SCOPE CMD MASK 1 New Signal Bit has value 1 LOOP 1 WHILE LOOP CMD INR CALL IBWRT SCOPE CMD CALL IBRD SCOPE RD NEWSIG VAL RD AND MASK IF NEWSIG MASK THEN LOOP 0 WEND 21 3 GPIB Operation Serial Poll 22 Serial polling takes place once the SRQ interrupt line has been asserted The controller examines which instrument has generated the interrupt by inspecting the SRQ bit in the STB register of each instrument Because service request is based on an interrupt mech anism serial polling offers a reasonable compromise in terms of servicing 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 funct
122. ervice request provided that the associated event becomes true Bit 6 MSS cannot be set and is always reported as zero in response to the query SRE The Standard Event Enable Register is modified with the com mand SRE It is cleared with the command SRE 0 or after power on It may be read with the query SRE The Parallel Poll Enable Register specifies which summary bit s in the Status Byte Register will set the ist individual local message This register is quite similar to the Service Request Enable Register SRE but it is used to 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 if the ist message has been set or not values are 1 or 0 The Parallel Poll Enable Register is modified with the command PRE It is cleared with the command PRE 0 or after pow er on It may be read with the query PRE See Section 3 page 23 for the GPIB parallel poll procedure PRE 5 sets bits 2 and 0 decimal 4 and 1 of the Parallel Poll Enable Register The INR reports the completion of a number of internal opera tions The events tracked by this 16 bit wide register are listed with the command INR in Section 5 195 7 Status Registers The Internal State Change Status Register may be read via the query INR The response is the binary
123. es a device reset The RST sets all 8 traces to the GND line recalls the default setup and causes a cali bration to be performed COMMAND SYNTAX RST EXAMPLE GPIB This example resets the oscilloscope CMD RST CALL IBWRT SCOPE CMD RELATED COMMANDS CAL RCL 129 5 System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE not available on 941X 130 SAMPLE_CLOCK SCLKi Command Query The SAMPLE CLOCK command allows the user to control the use of an external time base The user sets the number of data points that will be acquired when the oscilloscope is using the ex ternal clock Sample_CLocK lt state gt lt recordlength gt lt state gt INT EXT lt recordlength gt 50 100 200 500 1000 2000 5000 10000 20000 50000 Note If lt recordlength gt is not specified the previous value will not be modified The parameter lt recordlength gt is initially set to 50000 Sample_CLocK Sample_CLocK lt state gt lt recordlength gt The following command sets the oscilloscope to use the external clock with 1000 data point records CMD SCLK EXT 1000 CALL IBWRT SCOPE CMD System Commands 5 SAVE RECALL SETUP DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS SAV Command The SAV command stores the current state of the instrument in non volatile internal memory The SAV command st
124. ess This section introduces the basic remote control concepts which are common to both RS 232 C and GPIB It also presents a brief description of remote control messages Sections 3 and 4 explain how to send program messages over the GPIB or the RS 232 C interfaces respectively Section 5 alpha betically lists all the remote control commands Section 6 is a detailed description and tutorial of the transfer and format of waveforms whereas Section 7 explains the use of status bytes for error reporting Appendix A shows some complete programming examples Appendix B contains a printout of a waveform tem plate The remote commands conform to the GPIB IEEE 488 2 stan dard This standard may be seen as an extension of the IEEE 488 1 standard which dealt mainly with electrical and me chanical issues The IEEE 488 2 recommendations have also been adopted for RS 232 C communications whenever applica ble To remotely control the oscilloscope the controller must send pro gram messages which conform to precise format structures The instrument will execute all program messages which are in the cor rect form and ignore those where errors are detected 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 2 About Remote Control COMMANDS AND QUERIES Warning or error messages are normall
125. executing a parallel response in binary form is 01101PPP where PPP specifies the data line Since data line 2 is selected the identification code is 001 which results in the code 01101001 binary or amp H69 hex See Table 38 of the IEEE 488 1978 Standard for further details The state of the Individual STatus bit IST returned in parallel polling can also be read by sending the IST query To enable this poll mode the oscilloscope must be initialized as for parallel polling by writing into the PRE register Since IST polling emu lates parallel polling this method is applicable in all instances where parallel polling is not supported by the controller DRIVING A HARD COPY DEVICE Plotting Printing without a GPIB Controller GPIB Operation 3 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 response of the in strument simplifying the interpretation The status of the IST bit is then continuously monitored until it is set by the instrument CMD CHDR OFF INE 1 PRE 1 CALL IBWRT SCOPE CMDS LOOP 1 WHILE LOOP CMD IST CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RD IF VAL RD 1 THEN LOOP 0 WEND The oscilloscope can be interfaced to a
126. f you wish to use line splitting ensure that neither the input message terminator characters nor the line split characters occur in the data This command clears the input and output buffers It has the same meaning as the GPIB DCL or SDC interface messages This command puts the oscilloscope into the remote mode Its function is the same as GPIB asserting the REN line and setting the oscilloscope to listener This command puts the oscilloscope into local mode It clears local lockout It has the same function as GPIB setting the REN line to false This command disables the front panel LOCAL button either immediately if the oscilloscope is already in the remote mode or later when the oscilloscope is next set to remote control This dis abling of the front panel LOCAL button is called Local Lockout and can only be cancelled with the lt ESC gt L command lt ESC gt F has the same meaning as the GPIB LLO interface mes sage This command rearms the oscilloscope while it is in SINGLE or in SEQUENCE mode valid only while the oscilloscope is in the remote mode It has the same meaning as the TRG com mand and also the same meaning as the GPIB GET interface message 33 5 ORGANIZATION COMMAND SUMMARY Acquisition Communication SYSTEM COMMANDS This section of the manual lists all commands and queries recog nized by the oscilloscope For easy reference the listings are arranged in alpha
127. first data point acquired The descriptor parameter HORUNIT gives a string with the name of the horizontal unit Single sweep waveforms x i HORIZ_INTERVAL 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 2 5000e 09 from the floating point num ber 312b cc77 at byte 197 HORIZ_ OFFSET 1 21044098e 08 from the double preci sion floating point number be49 fe78 3be8 0000 at byte 201 HORUNIT S seconds from the string 300 at byte 265 which gives x 0 1 210e 08 S x 1 0 960e 08 S Sequence waveforms Since sequence waveforms are really many independent acquisi tions each segment will have its own horizonta offset These can be found in the TRIGTIME array For the n th segment x i n HORIZ_INTERVAL i TRIGGER_OFFSET n The TRIGTIME array can contain up to 200 segments of timing information with two 8 byte double precision floating point num bers for each segment Interleaved RIS waveforms These waveforms are composed of many acquisitions interleaved together The descriptor parameter SWEEPS_PER_ACQ gives the number of acquisitions The i th point will belong to the m th segment where m i modulo SWEEPS_PER_ACQ will have a value between 0 and SWEEPS _ PER_
128. format EXAMPLE GPIB RELATED COMMANDS 136 STB Query The STB query reads the contents of the 488 1 defined status register STB and the Master Summary Status MSS The re sponse represents the values of bits 0 to 5 and 7 of the Status Byte 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 Table 8 page 137 for further details on the status register structure STB STB lt value gt lt value gt 0 to 255 The following instruction reads the status byte register CMD STB CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message STB 0 ALL_STATUS CLS PRE SRE System Commands 5 Description Di07 Reserved for future use MSS RQS MSS 1 at least 1 bit in STB masked by SRE is 1 RQS 1 service is requested ESB an ESR enabled event has occurred MAV Output queue is not empty DIOS Reserved VAB a command data value has been adapted DIO1 Reserved INB an enabled iNternal state change has occurred Status Byte Register STB Table 8 Notes 1 The Master Summary Status MSS indicates that the instrument 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 a STB query is received
129. g the SRQ interface line If several devices are connected to the GPIB the controller may have to identify which instrument caused the inter rupt by serial polling the various devices Note The SRQ bit is latched until the controller reads the STatus Byte Register STB The action of reading the STB with the com mand STB clears the register contents except the MAV bit bit 4 until a new event occurs Service requesting may be dis abled by clearing the SRE register SRE 0 Example 1 To assert SRQ in response to the events new signal acquired or return to local pressing the front panel button LO CAL These events are tracked by the INR register which is reflected in the SRE register as the INB summary bit in position 0 Since the 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 which may be summa rized in the INB bit must be specified The event new signal acquired corresponds to INE bit 0 value 1 while the event re turn 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 Example 2 To assert SRQ when soft key 10 is pressed The event soft key 10 pressed is tracked by the URR register Since the URR register is not directly reflected in STB but only in the ESR
130. ger level of the speci fied 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 Table 8 page 137 to be set The range of values is as follows 5 times the total V div setting with CHAN 1 2 or 4 as trigger source 2 V with EXT as trigger source 0 8 V in 9424E 20 V with EXT 10 as trigger source The TRIG_LEVEL query returns the current trigger level COMMAND SYNTAX lt trig_ source gt TRig LeVel lt trig_level gt 2 channel 4 channel 4 channel oscilloscopes with Ext trigger without Ext trigger C1 C2 EX EX10 C1 C2 EX EX10 amp C1 C2 C4 lt trig level gt 20V to 20V maximum range Note The suffix V is optional QUERY SYNTAX lt trig_source gt TRig_LeVel Response format lt trig source gt TRig_LeVel lt trig_level gt EXAMPLE GPIB The following command adjusts the trigger level of Channel 2 to 3 4 V CMD C2 TRLV 3 4V CALL IBWRT SCOPE CMD RELATED COMMANDS TRIG_SELECT amp Not available in 9424E 151 5 System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 152 TRIG_MODE TRMD Command Query The TRIG_MODE command specifies the trigger mode An envi ronment error Table 6 page 84 will be generated when TRMD SEQNCE is received while the instrument is in the interleaved sampling RIS acqui
131. gt lt mode gt lt hor_value gt lt ver_value gt For horizontal cursors both horizontal as well as vertical values are given whereas for vertical cursors only vertical values are given Note If lt mode gt is not specified or equals ALL all the measured cursor values for the specified trace are returned If the value ofa cursor could not be determined in the current environment the value UNDEF will be returned The following query reads the measured absolute horizontal value of the cross hair cursor HABS on Channel 2 CMD C2 CRVA HABS CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message C2 CRVA HABS 34 2 US 244 MV CURSOR_SET 63 5 System Commands MISCELLANEOUS DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB 64 DATE Command Query The DATE command changes the date time of the oscilloscope s internal real time clock The DATE query returns the current date time setting DATE lt day gt lt month gt lt year gt lt hour gt lt minute gt lt second gt lt day gt 1 to 31 lt month gt JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC lt year gt 1987 to 2500 lt hour gt 0 to 23 lt minute gt 0 to 59 lt second gt 0 to 59 Note It is not always necessary to Specify all the DATE parame ters Only the parameters up to and including the parameter to be changed need to be specified
132. he oscilloscope If the software Xon Xoff handshake is se lected it is always TRUE Otherwise hardware handshake it is TRUE when the oscilloscope is able to receive char acters and FALSE when the oscilloscope is unable to receive characters 5 CTS Clear to send to the oscilloscope When true the oscilloscope can transmit when false transmission stops It is used for the oscilloscope output hardware handshake 20 DTR Data terminal ready from oscilloscope Always TRUE 29 4 RS 232 C Operation RS 232 C CONFIGURATION Echo of Received Characters by the Oscilloscope Handshake Control 30 GND Protective Ground 7 SIG GND Signal Ground The RS 232 C port is configured in full duplex This means that the two sides i e the controller and the oscilloscope can both send and receive messages at the same time However when the oscilloscope receives a new command it stops outputting Transmission of long messages to the oscilloscope should be done while the oscilloscope is in a triggered mode with no acquisition in progress This is especially important when sending waveforms or front panel setups into the oscilloscope The behavior of the RS 232 C port may be set according to the user s needs For this purpose in addition to the basic setup on the front pane menu there are immediate commands as well as a special command COMM_RS232 Immediate commands consist of the ASCII ESCape character lt ESC
133. i e to change the year setting specify day month and year together with the required settings The time settings will remain unchanged To change the second setting all the DATE parameters must be specified with the re quired settings DATE DATE lt day gt lt month gt lt year gt lt hour gt lt minute gt lt second gt This example will change the date to October 1 88 and the time to 1 21 16 p m 13 21 16 in 24 hour notation f CMD DATE 1 OCT 1988 13 21 16 CALL IBWRT SCOPE CMD System Commands 5 STATUS DDR Query DESCRIPTION The DDR query reads and clears the contents of the Device De pendent or device specific error Register DDR In the case of a hardware failure the DDR register specifies the origin of the fail ure Refer to Table 4 page 66 for further details QUERY SYNTAX DDR Response format DDR lt value gt lt value gt 0 to 65535 EXAMPLE GPIB The following instruction reads the contents of the DDR register CMD DDR CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message DDR 0 RELATED COMMANDS ALL_STATUS CLS 65 A System Commands Bt Bit Value Description 1 time base hardware failure is detected 12 4096 11 2048 1 a trigger hardware failure Is detected 1 a Channel 4 hardware failure is detected 1 a Channel 3 hardware failure is detected 1 a Ch
134. ing 32 33 Message terminators 31 Pin assignments 29 30 Simulating GPIB commands 33 SRQ Service request 32 RST Command 129 S SAMPLE_CLOCK SCLK Command Query 130 SAV Command 131 SCREEN_DUMP SCDP Command Query 132 SEGMENTS SEGS Command Query 133 SELECT SEL Command Query 134 Serial Polling 22 Service Procedure 2 Service Requests 191 193 Index SIMPLE 180 SRE Command Query 135 SRE Service Request Enable register 19 191 193 195 SRO Service ReQuest 19 21 32 193 194 Standard Event Status Enable Register See ESE Standard Event Status Register See ESR Status Register Reporting 191 STB Query 136 137 STB STatus Byte register 20 25 32 191 194 STOP Command 138 STORE STO Command 139 STORE_PANEL STPN Command 140 STORE_SETUP STST Command Query 141 STORE_TEMPLATE STTM Command 143 Suffix Multipliers 8 9 T Template 179 180 183 184 185 205 216 TEMPLATE TMPL Query 144 Terminators 5 9 31 184 Thumbwheel Switch See GPIB Address Switches TIME_DIV TDIV Command Query 145 146 TRACE TRA Command Query 147 Transfers See GPIB TRG Command 148 TRIG_COUPLING TRCP Command Query 149 150 TRIG_DELAY TRDL Command Query 150 TRIG_LEVEL TRLV Command Query 151 152 TRIG_MODE TRMD Command Query 152 TRIG_PATTERN TRPA Command Query 2 ch amp 4 ch with ext trigger
135. ion call IBWAIT instructs the computer to wait until one of three conditions occur amp H8000 in the mask MASK corre sponds to a GPIB error amp H4000 to a time out 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 instrument generated the interrupt It will only exit if there was a time out or if the instrument SCOPE generated SRQ The additiona function call IBRSP fetches the value of the status byte which may be further interpreted For this example to function properly the value of Disable Auto Serial Polling must be set off in the GPIB handler use IBCONF EXE to check CMD CLS INE 1 SRE 1 CALL IBWRT SCOPE CMD MASK amp HC800 CALL IBWAIT SCOPE MASK IF IBSTA AND amp HC000 lt gt 0 THEN PRINT GPIB or Time out Error STOP CALL IBRSP SCOPE SPR PRINT Status Byte SPR Note After the serial poll 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 instrument is reset If these bits are not cleared they cannot generate another interrupt Serial polling is only an advantage if there are several instruments that may need attention Board level function calls can deal simul taneously with several instruments attached
136. ion is finished before it can read the acquired waveform The simplest way of checking if a certain event has occurred is by continuously or periodically reading the status bit associated with it until the required transition is detected Continuous status bit poll ing is described in more detail in the sub section Instrument Polls For a complete explanation of the status bytes refer to Sec tion 7 A potentially more efficient way of detecting events occurring in the instrument is the use of the Service Request SRQ This GPIB interrupt line can be used to interrupt program execution in the controller Therefore the controller can execute other programs while waiting for the instrument Unfortunately not all interface manufacturers support the programming of interrupt service rou tines In particular National Instruments only supports the SRQ bit within the ISTA status word This requires the user to contin uously or periodically check this word either explicitly or with the function call IBWAIT In the absence of real interrupt service rou tines the use of SRQ may not be very advantageous In the default state after power on the Service ReQuest is dis abled The SRQ is enabled by setting the Service Request Enable register with the command SRE and specifying which event should generate an SRQ The oscilloscope will interrupt the con 19 3 GPIB Operation troller as soon as the selected event s occur by assertin
137. ired CMD C1 INSP TIMEBASE CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message C1 INSP TIMEBASE 500 US DIV 2 The following command reads the entire contents of the wave form descriptor block CMD C1 INSP WAVEDESC TEMPLATE WAVEFORM_SETUP 101 5 System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB 102 INTENSITY INTS Command Query The INTENSITY command sets the intensity level of the grid or the trace text provided the local control of the intensity has been turned off Note that normally the screen intensity is still under manual control when the oscilloscope operates remotely The local intensity control has to be turned off using the command INTS LOCAL OFF before the intensity levels can be modified re motely The intensity level is expressed as a percentage PCT A level of 100 PCT corresponds to the maximum intensity while a level of 0 PCT sets the intensity to its minimum value The response to the INTENSITY query indicates the grid and trace intensity levels and their control mode INTenSity LOCAL lt mode gt GRID lt value gt TRACE lt value gt lt mode gt ON OFF lt value gt 0 to 100 PCT Note 1 Parameters are grouped in pairs The first one names the variable to be modified and the second one gives the new value to be assigned Pairs may be given in any order a
138. ition any one of the nine independent XY cursors at a given screen location The positions of the cursors can be modified or queried even if the required cursor is not currently displayed or if the XY display mode is OFF The XY_CURSOR_SET query indicates the current position of the cursor s The values returned are quoted relative to the origi nal waveform time or frequency domain Notation HABS Horizontal absolute HREF Horizontal reference HDIF Horizontal difference XABS Vertical absolute on X axis XREF Vertical reference on X axis XDIF Vertical difference on X axis YABS Vertical absolute on Y axis YREF Vertical reference on Y axis YDIF Vertical difference on Y axis XY_Cursor_Set lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt HABS HREF HDIF XABS XREF XDIF YABS YREF YDIF lt position gt 0 to 10 DIV horizontal 4 to 4 DIV vertical Note 1 The suffix DIV is optional Note 2 Parameters are grouped in pairs The first one names the cursor to be modified and the second one indicates its new value Pairs may be given in any order and may be restricted to those items to be changed 1735 5 System Commands QUERY SYNTAX XY_Cursor_Set lt cursor lt cursor gt lt cursor gt HABS HREF HDIF XABS XREF XDIF YABS YREF YDIF ALL Note If lt cursor gt is not specified ALL will be assumed Response Form
139. its internal state it may be queried at any time independently of local or remote operation There are only two exceptions to this rule the queries CAL and TST both recalibrate the oscilloscope and are therefore executed in the remote state only Commands that only affect the remote behavior are executed in dependently of whether the oscilloscope is in the local or remote state In this category are all commands that modify communica tion parameters COMM_FORMAT COMM_HEADER COMM_HELP COMM_ORDER COMM_RS232 all com mands affecting status information CLS ESE INE OPC PRE SRE WAI and the commands used to display messages on the screen to the local user CALL_HOST KEY MESSAGE In the description of each command only exceptions to the rule that a command is executed only in the remote state and a query is executed in both the local and remote states are mentioned The following notation is used in the description of the individual commands lt gt Angular brackets enclose words that are used as placehold ers There are two types of placeholders 1 the header path 2 a data parameter of a command 37 5 System Commands 38 A colon followed by an equals sign separates a placeholder from the description of the type and range of values that may be used in a command instead of the placeholder Braces enclose a list of choices from which one must be se lected Square brackets enclose opti
140. ix B lt 318 gt PROCESSING DONE enum 2 no_processing _1 fir_filter _2 interpolated _3 sparsed 4 autoscaled 5 no_result _6 rolling _7 cumulative endenum lt 320 gt RESERVED5 word gt expansion entry lt 322 gt RIS_SWEEPS word for RIS the number of sweeps else 1 The following variables describe the basic acquisition conditions used when the waveform was acquired lt 324 gt TIMEBASE enum _O 1 ps div _1 2_ps div _2 5_ps div _3 10_ps div _4 20_ps div 5 50_ps div 6 100_ps div 1 200_ps div _8 500_ps div _9 1_ns div 10 2_ns div _11 5_ns div 12 10_ns div 13 20_ns div 14 50_ns div 15 100_ns div 16 200_ns div _17 500_ns div 18 1_us div 19 2_us div _20 5_us div _21 10_us div _22 20_us div 211 Appendix B ee E E een eee ne er eer ener ee een eeee _23 50_us div _24 100_us div 25 200_us div _26 500_us div _27 1_ms div _28 2_ms div _29 5_ms div _30 10_ms div _31 20_ms div _32 50_ms div _33 100_ms div _34 200_ms div _35 500_ms div _36 1_s div _87 2 s div _38 5_s div _39 10_s div _40 20 s div _41 50_s div _42 100_s div 43 200_s div _44 500_s div _45 1_ks div 46 2_ks div _47 5_ks div _100 EXTERNAL endenum lt 326 gt VERT_COUPLING enum _9 Dc_50_Ohms _1 ground _2 DC_1MOhm _3 ground 4 AC _1MOhm endenum lt 328 gt PROBE_ATT float lt 332 gt FIXED_VERT_GAIN enum O0 1_uV div 2_uV div _2 _uV div 3 10_uV div 212 Appendix B _4 20_uV div _5 50_uV div 6 100_uV
141. le SCRATCH DAT CMD2 _ D CALL IBCMD BRD0 CMD2 FILE SCRATCH DAT CALL IBRDF BRD0 FILES 3 Oscilloscope talks directly to plotter printer GPIB Operation 3 The controller goes into stand by and resumes GPIB operations once the data have been plotted that is when an EOI is detected Stage 1 Controller talker oscilloscope listener Issue the screen dump command CMD1 CALL IBCMD BRD0 CMD1 CMD SCDP CALL IBWRT BRD0 CMDS Stage 2 Oscilloscope talker plotter listener Put controller in stand by CMD2 D CALL IBCMD BRD0 CMD2 V 1 CALL IBGTS BRD0 V Note 1 In schemes 2 and 3 board level GPIB function calls are used It is assumed that the controller board the oscilloscope and the plotter are respectively located at addresses 0 4 and 5 The listener and talker addresses for the controller oscilloscope and plotter are Logic device Listener address Talker address controller 32 ASClIlI lt space gt 64 ASCII oscilloscope 32 4 36 ASCII 644 4 68 ASCII D hard copy dev 324 5 37 ASCII 64 5 69 ASCII E Note 2 The characters and _ appearing in the command strings stand for unlisten and untalk respectively They are used to set the devices to a known State Note 3 To shorten the size of the program examples device talk ing and listening initialization instructions have been grouped into character chains They are CMD1 _
142. lies to autostoring or to the CARD_STORE STST command Traces may be autostored to the memory card after each acquisition until the card becomes full FILL or forever WRAP replacing the oldest traces by new ones They may be stored keeping the full precision of the data WORD or with reduced precision BYTE most significant bits only to conserve space on the card The STORE SETUP query returns the current mode of opera tion of Autostore the current data size and the current trace selection STore_SeTup lt trace gt lt enable gt lt trace gt lt enable gt AUTO lt mode gt SIZE lt data size gt lt trace gt EA EB MC MD FE FF C1 C2 C3 C44 lt enable gt FILE DIS lt mode gt OFF WRAP FILL lt data_size WORD BYTE Note 1 Parameters are grouped in pairs The first one names the variable to be modified and the second one gives the new value to be assigned Pairs may be given in any order and may be restricted to those variables which have to be changed Note 2 The STORE SETUP command only modifies the current setup for storing traces to the memory card Any parameters not given in a particular STORE_SETUP command will not be af fected i e they will stay at their previous settings STore_SeTup STore_SeTup lt trace gt lt enable gt lt trace gt lt enable gt AUTO lt mode gt SIZE lt size gt 141 5 System Commands EXAMPLE GPIB The following command
143. llect Return Shipments Air freight is generally rec ommended Wherever possible the original shipping carton should be used If a substitute carton is used it should be rigid and be packed such that the product is surrounded with a minimum of four inches of excelsior or similar shock absorbing material In addressing the shipment it is important that the Return Authoriza tion Number be displayed on the outside of the container to ensure its prompt routing to the proper department within LeCroy ABOUT REMOTE CONTROL GPIB IMPLEMENTATION STANDARD PROGRAM MESSAGES Two modes of operation are available in the oscilloscope The in strument may be operated either manually by using the front panel controls or remotely by means of an external control ler which is usually a computer but may be a simple terminal This Remote Control Manual describes how to control the oscillo scope in the remote mode For explanations on how to manually set front panel controls refer to the Operator s Manual The oscilloscope is remotely controlled via either the GPIB Gen eral Purpose Interface Bus or the RS 232 C communication ports Whenever the rear panel GPIB address switches are set be tween 0 and 30 control is via GPIB when they are at 31 or above control is via RS 232 C The instrument can be fully controlled in remote mode The only actions which cannot be performed re motely are switching on the instrument or setting the remote addr
144. lloscope It is also a very verbose way in which to send the information and is not very fast Users who need speed or the ability to send the waveform back to the instrument should use the WAVEFORM commands BASIC users might find it convenient to combine the capabilities of the inspect facility with the waveform query command in order to construct files containing a human and BASIC readable version of the waveform descriptor together with the full waveform in a format suitable for retransmission to the instrument This can be 181 6 Waveform Structure WAVEFORM COMMAND Interpreting the waveform descriptor 182 done for a waveform in a memory location by sending the com mand MC INSPECT WAVEDESC WAVEFORM and putting the response directly into a disk file The WAVEFORM commands are an efficient way to transfer waveform data using the block formats defined in the IEEE 488 2 standard You have the possibility of reading all of the logical blocks of the waveform with a single query C1 WAVEFORM This is the preferred form for most applications since it is complete and the response can be downloaded back into the instrument using the WAVEFORM command You can also choose to read any single block with a query like Ci WAVEFORM DAT1 This can save time and space when you need to read many wave forms all with the same acquisition conditions or if you are only interested in lots of raw integer data Consult the descrip
145. lows another beep request will be held off for approximately 200 msec Note This command is always accepted local and remote BUZZer BEEP ON OFF Sending the following code will cause the oscilloscope to sound two short tones CMD BUZZ BEEP BUZZ BEEP CALL IBWRT SCOPE CMD 45 A System Commands MISCELLANEOUS CAL Query DESCRIPTION The CAL query performs a complete internal calibration This calibration sequence is the same as that which occurs at power up At the end of the calibration the response indicates how the cali bration terminated When the calibration is finished the instrument returns to the state it was in prior to the query Hardware failures are identified by a unique binary code in the returned lt status gt number see Table 1 A 0 response indicates that no failures occurred Note This query is only accepted in remote mode QUERY SYNTAX CAL Response Format CAL lt diagnostics gt lt diagnostics gt 0 calibration successful BIT VALUE DESCRIPTION CH1 failure CH2 failure CH3 failure CH4 failuret TDC failure Trigger circuit failure Failures Table 1 EXAMPLE GPIB The following instruction forces a self calibration CMD CAL CALL IBWRT SCOPE CMD CALL IBRD SCOPE RD PRINT RD Response message if no failure CAL 0 RELATED COMMANDS AUTO_CALIBRATE t 4 channel oscilloscopes only reserved in the 2 channel oscilloscopes
146. mmands A TST Query The TST query performs an internal self test The response in dicates if the self test detected any errors The self test includes testing the hardware of all channels the time base and the trigger circuits Hardware failures are identified by a unique binary code in the returned lt status gt number see Table 1 page 46 A 0 response indicates that no failures occurred Note This query is only accepted in remote mode TST TST lt status gt lt status gt 0 self test successful This example causes a self test to be performed CMD TST CALL IBWRT SCOPE CMD CALL IBRD SCOPE RD PRINT RD Response message if no failure TST 0 CAL 159 5 System Commands STATUS DESCRIPTION QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 160 URR Query The URR query reads and clears the contents of the User Request status Register URR The URR register specifies which button in the menu field was pressed Refer to Table 9 for further details In the remote mode the URR register indicates the last button 2 10 which was pressed In local mode the URR register indi cates whether the CALL HOST button has been pressed If no menu button has been pressed since the last URR query the value 0 is returned Figure 1 page NO TAG shows the button assignments on the instrument URR URR lt value gt lt value gt 0 to 9 100
147. n 15 IEEE 488 1 3 13 15 24 IEEE 488 2 3 13 191 194 IFC InterFace Clear 12 15 Interface capabilities 11 Interface management lines 12 13 Listener address 24 LLO Local LOckout 14 MLA Listen address 12 24 27 MTA Talker address 12 24 27 Polling 21 25 Programs for GPIB 15 18 21 26 199 202 REN Remote ENable 13 14 ROS ReQuest for Service 22 SDC Selected Device Clear 13 18 Signals 12 13 Software Configuration 15 SRE Service Request Enable register 19 22 SRQ Service ReQuest 13 19 20 Talker address 24 Transfers 15 UNL Universal unlisten 12 24 25 27 UNT Universal untalk 12 24 25 27 GRID Command Query 90 H Hard Copies See GPIB HARDCOPY_SETUP HCSU Command Query 91 92 HARDCOPY_TRANSMIT HCTR Com mand 93 Header 6 7 Header Path 7 Help Messages 4 HOR_MAGNIFY HMAG Command Query 94 HOR_POSITION HPOS Command Query 95 96 I IBCLR 18 IBCMD 23 IBFIND 16 IBLOC 18 IBRD 16 IBRDF 18 IBRDI 18 19 IBRPP 24 IBRSP 22 Index IBTMO 19 IBTRG 19 IBWAIT 19 22 IBWRT 16 IBWRITF 18 IBWRTI 18 19 IDN Query 97 IEEE Standards See GPIB INE INternal state change Enable register 20 22 23 25 191 193 196 INE Command Query 98 INR INternal state change Register 20 21 22 23 25 191 193 195 INR Query 99 INSPECT Queries 180 182 INSPECT INSP Query 100 1
148. n gt MAXPTS lt max_points gt SWEEPS lt max_sweeps gt DITHER lt off_on gt REJECT lt off_on gt WEIGHT lt weight gt BITS lt bits gt EXAMPLE GPIB The following command defines Function E to compute the prod uct of Channel 1 multiplied by 2 1 and augmented by 3 3 and Channel 2 using a maximum of 10000 input points CMD FE DEF EON 2 1 C1 3 3 C2 MAXPTS 10000 CALL IBWRT SCOPE CMD RELATED COMMANDS FUNCTION_RESET FUNCTION_STATE INR t 4 channel oscilloscopes only 72 System Commands 5 FUNCTION DESCRIPTION DEFINE DEF Command Query Oscilloscopes fitted with the WP02 Option An oscilloscope fitted with the FFT option WP02 accepts addi tional forms of the DEFINE command Notation WINDOW FFT window function Fast Fourier Transform complex result Real part of complex result Imaginary part of complex result Magnitude of complex result Phase angle degrees of complex result Power Spectrum Power Density Power Average Rectangular window von Hann window Hamming window Flat Top window Blackman Harris window DC component suppression COMMAND SYNTAX FFT lt function gt DEFine EQN lt equation gt MAXPTS lt max_points gt WINDOW lt window_type gt DCSUB lt off_on gt t 4 channel oscilloscopes only lt function gt lt equation gt lt equation gt lt equation gt lt equation gt lt equation gt lt equation gt
149. nd may be restricted to those variables to be changed Note 2 The suffix PCT is optional INTenSity INTenSity LOCAL lt mode gt TRACE lt value gt GRID lt value gt The following instruction enables remote control of the intensity and changes the grid intensity level to 75 CMD INTS LOCAL OFF GRID 75 CALL IBWRT SCOPE CMDS The following instruction re enables local control of the intensity CMD INTS LOCAL ON CALL IBWRT SCOPE CMDS ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE RELATED COMMANDS t 2 ns div for Model 9430 System Commands iy INTERLEAVED ILVD Command Query The INTERLEAVED command enables or disables random inter leaved sampling RIS An environment error see Table 6 page 82 will be generated if the user attempts to turn off RIS when the time base setting allows ON only or to turn on RIS when the time base setting allows OFF only see table below RIS 9410 14 9420 24 30 9450 ON 2 ns div 1 ns divt 1 ns div only to to to 20 ns div 20 ns div 5 ns div Selectable 50 ns div 50 ns div 10 ns div ON OFF to to to 5 ps div 20 us div 5 ps div OFF 10 pis div 50 yis div 10 us div only to to to 1000 s div 000 s div 5000 s div RIS is not available for sequence mode acquisitions and therefore an attempt to turn it on in that mode will also resul
150. nt the value UNDEF will be returned If no trace has been assigned to either the X axis or the Y axis an environment error will be generated XY_Cursor_Value lt parameter gt lt value gt lt parameter gt lt value gt lt value gt decimal value or UNDEF The following query reads the ratio of the absolute horizontal cur sor the angle of the relative horizontal cursor and the product of the absolute vertical cursor CMDS XYCV HABS_RATIO HREL_ANGLE VABS_PROD CALL IBWRT SCOPE CMDS 175 5 System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB 176 XY_ DISPLAY XYDS Command Query The XY_DISPLAY command enables or disables the XY display mode The XY_DISPLAY query returns the current mode of the XY display XY_DiSplay lt mode gt lt mode gt ON OFF XY_DiSplay XY_DiSplay lt mode gt The following command turns the XY display ON CMDS XYDS ON CALL IBWRT SCOPE CMDS System Commands 5 DISPLAY ZOOM Command Query DESCRIPTION The ZOOM command allows the user to select which trace is to be expanded by one of the expansion functions The response to the ZOOM query indicates which trace is cur rently expanded In 4 channel oscilloscopes the ZOOM command automatically switches the function to the expand state COMMAND SYNTAX lt exp_trace gt ZOOM lt trace gt lt exp_trace gt EA EB MC MD
151. number SN 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 parame ters currently in use Notation SP sparsing NP number of points FP first point SN segment number 168 System Commands 5 COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS WaveForm_SetUp SP lt sparsing gt NP lt number gt FP lt point gt SN lt segment gt 9410 14 All others lt sparsing gt O to 5000 0 to 25000 0 no sparsing lt number gt Oto 10000 O to 50000 0 all points O to 10000 O to 50000 lt segment gt Oto 50 O to 200 0 all segments Note 1 After power on all values are set to O i e entire wave forms will be transmitted without sparsing Note 2 Parameters are grouped in pairs The first one names the variable to be modified and the second one gives the new value to be assigned Pairs may be given in any order and may be restricted to those variables to be changed WaveForm_SetUp WaveForm_SetUp SP lt sparsing gt NP lt number gt FP lt point gt SN lt segment gt The following command specifies that every 3rd data point SP 3 Starting at address 200 should be transferred CMD WESU SP 3 FP
152. nus on the left hand side of the screen reappear Thereafter whenever the instrument is addressed as a listener it will be imme diately set to the remote state again Note that a GTL message does not clear the local lockout if it was set Thus whenever the instrument returns to the remote state the local lockout mode would immediately be effective again A command string should not be immediately followed by a GTL message Since GTL is executed at once the instrument may al ready be returned to the local state before the commands in the input buffer are interpreted Therefore the instrument may refuse to execute them if they require the instrument to be in REMOTE GPIB Operation 3 InterFace Clear PROGRAMMING GPIB TRANSFERS Configuring the GPIB Hardware Configuring the GPIB Driver Software A safe way to ensure that all commands have been interpreted is to append a query e g STB to the command string and to wait for the response before sending a GTL The InterFace Clear message IFC initializes the GPIB but has no effect on the operation of the oscilloscope To illustrate the GPIB programming concepts a number of exam ples written in BASICA are included in this section It is assumed that the controller is IBM PC compatible running under DOS and that it is equipped with a National Instruments GPIB inter face card GPIB programming with other languages such as C or Pascal is quite similar If you use an
153. ommands Organization 35 Command Summary 35 Command Execution 37 Command Notation 37 6 Waveform Structure Introduction 179 Logical Data Blocks of a Waveform 179 Inspect Command 180 Waveform Command 182 Waveform Command 187 More Control of Waveform Queries 188 High speed Waveform Transfer 188 7 Status Registers Overview of Status and Service Request Reporting 191 Status Byte Register STB 193 Standard Event Status Register ESR 194 Standard Event Status Enable Register ESE 195 Service Request Enable Register SRE 195 Parallel Poll Enable Register PRE 195 Internal State Change Status Register INR 195 Internal State Change Enable Register INE 196 Command Error Status Register CMR 196 Device Dependent Error Status Register DDR 196 Execution Error Status Register EXR 196 User Request Status Register URR 196 Table of Contents ee ee a Appendix A Example 1 Use of the Interactive GPIB Program IBIC Example 2 GPIB Program for IBM PC High level Function Calls Example 3 GPIB Program for IBM PC Low level Function Calls Appendix B The Waveform Template 199 200 202 205 1 GENERAL INFORMATION INITIAL INSPECTION WARRANTY PRODUCT ASSISTANCE MAINTENANCE AGREEMENTS It is recommended that the shipment be thoroughly inspected im mediately upon delivery to the purchaser All material in the container should be checked against the enclosed Packing List LeCroy
154. on all of the traces If signals are detected on several channels the lowest numbered channel with a signal determines the selection of the time base and trigger source If only one input channel is turned on the time base will be ad justed for that channel Auto_SETup The following command instructs the oscilloscope to perform an auto setup CMD ASET CALL IBWRT SCOPE CMD 43 5 System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE 44 BANDWIDTH_LIMIT BWL Command Query The BANDWIDTH_LIMIT command enables or disables the bandwidth limiting low pass filter The response to the BANDWIDTH_LIMIT query indicates if the bandwidth filter is on or off BandWidth_Limit lt mode gt lt mode gt ON OFF BandWidth_ Limit BandWidth_Limit lt mode gt The following command turns the bandwidth filter on CMD BWL ON CALL IBWRT SCOPE CMDS MISCELLANEOUS DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB System Commands 5 BUZZER BUZZ Command The BUZZER command controls the built in piezo electric buzz er This may be useful to attract the attention of a local operator in an interactive working application The buzzer may either be acti vated for short beeps about 400 msec long in BEEP mode or continuously for a certain time interval selected by the user by turning the buzzer ON or OFF A beep request which immediately fol
155. onal items An ellipsis indicates that the items to the left and to the right of the ellipsis may be repeated zero or more times As an example consider the syntax notation for the command to set the vertical input sensitivity lt channel gt VOLT_DIV lt v_gain gt lt channel gt C1 C2 lt v_gain gt 5 0 mV to 2 5 V The first line shows the formal appearance of the command with lt channel gt denoting the placeholder for the header path and lt v_gain gt denoting the placeholder for the data parameter specify ing the desired vertical gain value The second line indicates that either C1 or C2 must be chosen for the header path and the third line explains that the actual vertical gain can be set to any value between 5 mV and 2 5 V System Commands 5 STATUS DESCRIPTION QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 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 ex cept 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 ALL_STATUS query is useful if a complete overview of the state of the instrument is required ALI_STatus ALL _STatus STB lt value gt ESR lt value gt INR lt value gt DDR lt value gt CMR lt value gt EXR lt value gt URR lt value gt lt value gt 0 to
156. ons i e additional firmware or hardware options The response consists of a series of response fields listing all the installed options QUERY SYNTAX OPT Response format OPT lt option_1 gt lt option_2 gt lt option_N gt lt option_i gt character data Note If no option is present the character O will be returned EXAMPLE GPIB This example queries the installed options CMD OPT CALL IBWRT SCOPE CMDS CALL IBRD SCOPE RSP PRINT RSP Response message OPT 0 If the waveform processing options WP01 and WP02 are installed the response message is OPT WP01 WP02 112 SAVE RECALL SETUP DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response syntax EXAMPLE GPIB RELATED COMMANDS System Commands A PANEL SETUP PNSU Command Query The PANEL SETUP command complements the SAV RST commands The PANEL_SETUP command allows panel setups to be archived in encoded form on external storage media Only setup data read by the PNSU query may be recalled into the oscilloscope A panel setup error see Table 6 page 84 will be generated if the setup data block contains invalid data Note The communication parameters those modified by com mands 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 block previously read by PNSU
157. or lt ESC gt for RTS handshake Editing Features Message Terminators Examples RS 232 C Operation amp The flow of characters coming from the oscilloscope may be con trolled either by a signal level on the CTS line pin 5 or by the lt XON gt lt XOFF gt pair of characters When the oscilloscope is directly connected to a terminal the fol lowing features will facilitate the correction of typing errors lt BS gt or lt DELETE gt Delete the last character CTRL_U Delete the last line Message terminators are markers that indicate to the receiver that a message has been completed On input to the oscilloscope the Program Message Terminator is one character which can be selected by the user A good choice would be a character that is never used for anything else The character is chosen using the command COMM_RS232 and the keyword EI The default Program Message Terminator is the ASCII character lt CR gt whose decimal value is 13 The oscilloscope appends a Response Message Terminator to the end of each of its responses It is a string like a computer prompt chosen by the user This string must not be empty The default Response Message Terminator is n r which means lt LF gt lt CR gt 1 COMM_RS232 EI 3 This command informs the oscilloscope that each message it receives will be terminated with the ASCII character lt ETX gt which corresponds to 3 in decimal 2 COMM_RS232 EO r nEND
158. ores the complete front panel setup of the instrument at the time the com mand is issued Note The communication parameters those modified by com mands COMM_FORMAT COMM_HEADER COMM_HELP COMM _ ORDER and WAVEFORM SETUP and the enable reg isters associated with the status reporting system SRE PRE ESE INE are not saved by this command SAV lt panel_setup gt lt panel_setup gt 1 to 7 The following code saves the current instrument setup in panel setup 5 CMD SAV 5 CALL IBWRT SCOPE CMD PANEL_SETUP RCL 131 5 System Commands HARD COPY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 132 SCREEN_DUMP SCDP Command Query The SCREEN_DUMP causes the oscilloscope to dump the screen contents onto the hard copy device For plotting this command will not halt oscilloscope activities since plotting is performed in parallel with other tasks unless it is done over the same port as the remote control Printing however cannot be done in parallel with other oscilloscope operations Screen dumps may be aborted by adding A to the screen dump command as shown in the command syntax below The time date stamp which appears on the plot corresponds to the time at which the command was executed The SCREEN_DUMP query indicates whether a screen dump is currently in progress ON or has finished OFF SCreen_DumP A Note The option
159. orm applied to any one of the Func tions C D E or F will automatically switch them into the memory state There is never an automatic transition into the function state The command FUNCTION_STATE must be used Initially Functions C and D are set to the memory state and Func tions E and F are set to the function state The query FUNCTION_STATE returns the current state of a waveform processing function lt function gt Function_STAte lt state gt lt function gt MC MD FE FF lt state gt FUNC MEM ZOOM System Commands 5 QUERY SYNTAX lt function gt Function_STAte Response format lt function gt Function_STAte lt state gt EXAMPLE GPIB The following example switches the internal function memory C into the mathematical waveform processing state thereby re estab lishing the last valid waveform processing definition CMD MC FSTA FUNC CALL IBWRT SCOPE CMD RELATED COMMANDS DEFINE STORE WAVEFORM ZOOM 89 5 System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB 4 channel oscilloscopes only 90 GRID Command Query The GRID command specifies whether the grid should be dis played in single dual or quad mode In single grid mode all the traces are displayed on a single grid In dual grid mode the screen is split into two distinct grids to sepa rate the traces In the dual channel oscilloscopes Channel 1 is alwa
160. ostored waveforms DELete_file FILE lt mode gt lt mode gt WF AUTOWF lt filename gt lt filename gt an alphanumeric string of up to 8 characters fol lowed by a dot and an extension of up to 3 digits The following commands first delete a front panel setup and then delete all the autostored waveforms from the card CMD DELF FILE P001 PNL DELF FILE AUTOWF CALL IBWRT SCOPE CMDS DIRECTORY_LIST FORMAT_CARD System Commands 5 MISCELLANEOUS DIRECTORY_LIST DIR Query Oscilloscopes fitted with the MC01 Option DESCRIPTION The DIRECTORY_LIST query produces a directory listing of the memory card The response consists of a double quoted string containing a DOS like listing of the directory If no memory card is present or if it is not formatted the string will be empty QUERY SYNTAX DIRectory_list Response format DIRectory_list lt directory gt lt directory gt a variable length string detailing the file content of the memory card EXAMPLE GPIB The following code asks for a listing of the directory of the memory card CMD DIR CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message DIR Memory card of 25 JAN 1991 12 10 40 1 SC1 001 29 JAN 1991 16 33 06 20361 2 SC2 001 29 JAN 1991 16 34 32 20361 2 File s 84992 bytes free 77 5 System Commands DISPLAY DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Respons
161. other computer or another GPIB interface refer to the interface manual for installation procedures and subroutine calls similar to those described here Check that the GPIB interface is properly installed in the comput er If it is not follow the installation instructions of the interface manufacturer 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 our program examples they are assumed to be left in their default positions Connect the oscilloscope to the computer with a GPIB interface cable Set the GPIB address on the rear of the instrument to the required value The program examples assume that it is set to 4 Remember to power the instrument up after setting the GPIB ad dress The host computer needs an interface driver which handles the transactions between the user s programs and the interface board In the case of the National Instruments interface the installation procedure copies the GPIB handler GPIB COM into the boot directory e modifies the DOS system configuration file CONFIG SYS to declare the presence of the GPIB handler creates a sub directory GPIB PC installs in GPIB PC a number of files and programs which are useful for testing and reconfiguring the system and for writing user programs 2 National Instruments Corporation 12109 Technology Boulevard
162. out a waveform of the appropriate size and then replace the data with the desired values This will assure that the descriptor is coherent Note You are only allowed to send back waveforms to memory traces MC or MD for 2 channel instruments or MC MD FE and FF for 4 channel instruments This means that you may have to remove or change the prefix Cl or CHANNEL_1 in the response to the WF query The examples for the WF command in Section 5 show how this can be done 187 6 Waveform Structure MORE CONTROL OF WAVEFORM QUERIES HIGH SPEED WAVEFORM TRANSFER 188 There are many different ways for you to use the WAVEFORM command which may simplify or speed up your work Among them are Partial readout of waveform The WAVEFORM_SETUP command allows you to specify a short part of a waveform for readout It also lets you select a spars ing factor to read only every n th data point Byte swapping The COMM_ORDER command allows you to swap the two bytes of a 16 bit word In fact byte swapping is done for all numbers represented by more than one byte This is the case for the des criptor the time blocks and WORD arrays thereby simplifying data interpretation for some computer systems e g INTEL based or DEC Data length block format and encoding The COMM_FORMAT command 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 BY
163. parameter defines the maximum number of characters that will be sent to the host in a single line Remaining characters of the response will be output in sepa rate additional lines This parameter is only applicable if a line separator has been selected Line Separator This parameter is used to select the line split ting mechanism and to define the characters used to split the oscilloscope response messages into many lines Possible line separators are CR LF CRLF A lt CR gt a lt LF gt or a lt CR gt followed by a lt LF gt will be sent to the host computer after lt line_length gt characters SROQ string This string is sent each time the oscilloscope wants to signal an SRQ to the host computer Note Some parameters of this command require ASCII strings as actual arguments In order to facilitate the embedding of non printable characters into such strings escape sequences may be COMMAND SYNTAX System Commands 5 used the back slash character is used as an escape charac ter The following escape sequences are recognized Na Bell character ND Back space character SAEN Escape character Nn Line feed character N Carriage return character NE Horizontal tab character ANTY The back slash character itself ddd ddd represents one to three decimal digit characters giv ing the code value of the corresponding ASCII character This allows any ASCII code in the range I to 127 to
164. quired data point displayed at the left hand edge of the screen The command expects positive trigger delays to be expressed as a percentage of the full horizontal screen this mode is called pre trigger acquisition as data are acquired before the trigger occurs Negative trigger delays must be given in seconds this mode is called post trigger acquisition as 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 Positive times are expressed as a percentage of the full horizontal screen and nega tive times in seconds TRig DeLay lt value gt lt value gt 0 00 PCT to 100 00 PCT pretrigger 20 PS to 50 MAS post trigger Note The suffix is optional For positive numbers the suffix PCT is assumed For negative numbers the suffix S is assumed MAS ts the suffix for Msec megaseconds useful only for extremely large delays at very slow time bases TRig DeLay TRig DeLay lt value gt The following command sets the trigger delay to 20 sec post trigger CMD TRDL 20S CALL IBWRT SCOPE CMD TIME_DIV System Commands 5 ACQUISITION TRIG_LEVEL TRLV Command Query DESCRIPTION The TRIG_LEVEL command adjusts the trig
165. r gt Square lt equation gt SORT lt source_expr gt Square Root lt equation gt LN lt source_expr gt Logarithm base e lt equation gt LOG10 lt source_expr gt Logarithm base 10 lt equation gt EXP lt source_expr gt Power of e lt equation gt EXP10 lt source_expr gt Power of 10 lt equation gt INTG lt source_expr gt Integral lt equation gt DERI lt source_expr gt Derivative lt equation gt ABS lt source_expr gt Absolute Value lt equation gt ERES lt source gt Enhanced Resolution lt paren_source_expr gt lt source_expr gt lt paren_source_expr gt lt source gt lt source_expr gt lt multiplier gt lt source gt lt addend gt lt source_expr gt lt multiplier gt lt source gt lt source_expr gt lt source gt lt addend gt lt source_expr gt lt source gt lt multiplier gt 0 001e 33 to 999 999e33 lt addend gt 999 999e33 to 999 999e33 lt source gt EA EB MC MD FE FF C1 C2 C3 C4 9410 14 lt max_points gt 50 to 10000 50 to 50000 lt max_sweeps gt 1 to 1000000 lt off_on gt OFF ON lt weight gt 1 3 7 15 31 63 127 255 511 1023 lt bits gt 0 5 1 0 1 5 2 0 2 5 3 0 Note Space blank characters inside equations are optional 71 A System Commands QUERY SYNTAX lt function gt DEFINE Response format lt function gt DEFine EQN lt equatio
166. r word 2 SHORT format i e responses start with the short form of the header word 3 OFF i e headers are omitted from the response and suffix units in num bers are suppressed Until the user requests otherwise the SHORT response format is used This command does not affect the interpretation of messages sent to the oscilloscope Headers may be sent in their long or short form regardless of the COMM_HEADER setting Querying the vertical sensitivity of Channel 1 may result in one of the following responses COMM_HEADER LONG CHANNEL_1 VOLT_DIV 200E 3 V SHORT C1 VDIV 200E 3 V OFF 200E 3 Note This command can be executed in both local and remote modes Comm_HeaDeR lt mode gt lt mode gt SHORT LONG OFF Note The default mode i e the mode just after power on is SHORT Comm_HeaDeR Comm_HeaDeR lt mode gt The following code sets the response header format to short CMD CHDR SHORT CALL IBWRT SCOPE CMD System Commands 5 COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB COMM_HELP CHLP Command Query The COMM_HELP command enables the help diagnostics utility to assist remote program debugging When turned on this utility displays all message transactions occurring between the controller and the oscilloscope on a terminal printer or similar recording device connected to the RS 232 C port Errors detected by the instrument can be dir
167. rent FLDC value The LINE value is interpreted with the current FLD and CHAR values TRig_SElect TRig SElect TV SR EX FLDC lt field_count gt FLD lt field gt CHAR lt characteristic gt LINE lt line gt EXAMPLE GPIB RELATED COMMANDS System Commands 5 CMD TRSE TV SR EX FLDC 8 FLD 3 CHAR PALSEC LINE 17 TRIG_COUPLING TRIG_LEVEL TRIG_MODE TRIG_PAT TERN TRIG SLOPE 157 A System Commands ACQUISITION TRIG_SLOPE TRSL Command Query DESCRIPTION The TRIG_SLOPE command sets the trigger slope of the specified trigger source An environment error see Table 6 page 84 will be generated when TRSL NEG is received while the trigger cou pling is set to HFDIV see TRIG_COUPLING The TRIG_SLOPE query returns the trigger slope of the selected source COMMAND SYNTAX lt trig_source gt TRig_SLope lt trig_slope gt 2 channel 4 channel 4 channel oscilloscopes with Ext trigger without Ext trigger C1 C2 EX EX10 C1 C2 EX EX108 C1 C2 C4 lt trig_slope gt NEG POS QUERY SYNTAX lt trig_source gt TRig SLope Response format lt trig_source gt TRig SLope lt trig_slope gt EXAMPLE GPIB The following command sets the trigger slope of Channel 2 to negative CMD C2 TRSL NEG CALL IBWRT SCOPE CMD RELATED COMMANDS TRIG_SELECT amp Not available in 9424E 158 MISCELLANEOUS DESCRIPTION QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS System Co
168. riptor by the COMM _TYPE variable 00 ENDARRAY DATA_ARRAY_2 ARRAY Explanation of the data array DATA_ARRAY_2 gt The data item is repeated for each acquired or computed data point gt of the second data array of any dual waveform e g the imaginary part of a FFT lt 0 gt MEASUREMENT data the actual format of a data is given in the WAVEDESC descriptor by the COMM_TYPE variable 00 ENDARRAY 214 Appendix B TRIGTIME ARRAY Explanation of the trigger time array TRIGTIME This data block is repeated for each segment which makes up the acquired sequence record lt O gt TRIGGER_TIME double for sequence acquisitions time in seconds from first trigger to this one lt 8 gt TRIGGER_OFFSET double the trigger offset is in seconds from trigger to zeroth data point 00 ENDARRAY RISTIME ARRAY Explanation of the random interleaved sampling RIS time array RISTIME This data block is repeated for each sweep which makes up the RIS record lt 0 gt RIS_OFFSET double seconds from trigger to zeroth point of segment 00 ENDARRAY e ee S2SPSsesesSsSsSSS SSS SS S222 5225 aR eee E ere oe eee eee E E E e e a a a SIMPLE ARRAY Explanation of the data array SIMPLE The data item is repeated for each acquired or computed data point of the first data array of any waveform It is identical to DATA_ARRAY_1 above lt 0 gt MEASUREMENT data the actual format of a
169. rmat A lt NL END gt new line with EOI 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 OFF Same as INDO In addition the data block type identi fier and the leading 0 of the indefinite length block will be suppressed The data presented above would be sent as WF lt DAB gt lt DAB gt lt DAB gt lt NL END gt Note The format OFF does not conform to the IEEE 488 2 stan dard and is only provided for special applications where the absolute minimum of data transfer may be important DATA TYPE BYTE Transmits the waveform data as 8 bit signed integers 1 byte WORD Transmits the waveform data as 16 bit signed integers 2 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 ENCODING BIN Binary encoding GPIB only HEX Hexadecimal encoding bytes are converted to 2 hexa decimal ASCII digits 0 9 A F WAVEFORM 51 System Commands COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB 52 COMM_HEADER CHDR Command Query The COMM_HEADER command controls the way the oscillo scope will format responses to queries The instrument provides three response formats 1 LONG format i e responses start with the long form of the heade
170. rnal changes in the instrument Additional details of the errors reported by ESR can be obtained with the queries CMR DDR EXR and URR 191 J Status Registers Power ON User request URR Command error found CMR Execution error detected EXR Device specific error DDR Query error Request control unused Operation complete ol Function F processing terminated Function E processing terminated R Segment of sequence acquired Time out in a data block transfer Return to local detected Screen dump terminated New signal acquired Standard Event Status Register Read by ESA Internal State Change Register Read by INR Na Lien Ls 27 o Logical OR Tne O poo ae a S oy O 7 m eT eT SER Standard Event Status Register Set by ESE n Read by ESE Logical OR Service Ane E R Internal State Change Enable Register Bia 5 gt o lt gt w Status Byte Register Set by INE_n Aipad by Serial Poll Read by NE Read by STB ae mi in a 9424 bits 8 9 are used for Function C D processing terminated Service Request Enable Register Set by SRE n Read by SRE Logical OR X o B STATUS REGISTER STRUCTURE Figure 2 192 Example of status reporting Summary STATUS BYTE REGISTER STB Status Registers 7 The register structure contains one more register not shown in Figure 2 It is the Par
171. rocessing that have been performed e the name and serial number of the instrument e the encoding format used for the data blocks e miscellaneous constants 2 An optional user provided text USERTEXT The WFTX command can be used to put a title or description of a wave form into this block The WFTX query command gives an alternative way to read it This text block can hold up to 400 characters However you should limit the length of each line to about 45 characters otherwise the text will be wrapped onto the next line after 56 characters 3 A block of sequence acquisition times TRIGTIME This block is needed for sequence acquisitions to record the exact 179 6 Waveform Structure INSPECT COMMAND 180 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 4 A block of random interleaved sampling times RISTIME This block is needed for RIS acquisitions to record the exact timing information for each segment 5 A data array block SIMPLE or DATA_ARRAY_1 This is the basic integer data of the waveform It can be raw or cor rected ADC data or the integer result of waveform processing 6 A second data array block DATA_ARRAY_2 This second data array is needed to hold the results of processing functions such as the Extrema WP01 option or Complex FFT WP02 option
172. ror Register CMR or the Execution Error Reg ister EXR Commands associated with IEEE 488 2 mandatory status registers are preceded by an asterisk lt gt Figure 2 shows the organization of the status registers The central reporting structure is the Status Byte Register STB It consists of 8 bits three of which are not used The Standard Event Status Bit ESB and the Internal Status Change Bit INB in the Status Byte Register are summary bits of the Standard Event Status Register 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 e g if the command TDIV 2 5 US is received the time base is set to 2 ppsec div and the VAB bit is set The Master Summary Status bit MSS indicates that the instru ment requests service The MSS bit can only be set if any of the other bits of STB are enabled with the Service Request Enable Register SRE All Enable registers SRE ESE and INE are used to generate a bitwise 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 Standard Event Status Register ESR mostly summarizes er rors whereas the Internal State Change Register INR reports inte
173. s allow 1 the block format 2 the data type and 3 the encoding mode to be modified from the default settings Note This command can be executed in both local and remote modes The COMM_FORMAT query returns the currently selected waveform data format Comm_ForMaT lt block_format gt lt data_type gt lt encoding gt lt block_format gt DEF9 INDO OFF lt data_type gt BYTE WORD lt encoding gt BIN HEX GPIB uses both encoding forms RS 232 C always uses HEX Initial settings i e after power on are DEF9 WORD BIN for GPIB DEF9 WORD HEX for RS 232 C Comm_ForMaT Comm_ForMaT lt block_format gt lt data_type gt lt encoding gt The following code redefines the transmission format of waveform data The data will be transmitted as a block of indefinite length Data will be coded in binary and represented as 8 bit integers CMD CEMT INDO BYTE BIN CALL IBWRT SCOPE CMD BLOCK FORMAT DEF9 Uses the IEEE 488 2 definite length arbitrary block re sponse 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 3 data bytes would be sent as WF DAT1 9000000003 lt DAB gt lt DAB gt lt DAB gt where lt DAB gt represents an 8 bit binary data byte RELATED COMMANDS System Commands 5 INDO Uses the IEEE 488 2 indefinite length arbitrary block response data fo
174. s only System Commands 5 HOR_POSITION HPOS Command Query The HOR_POSITION command horizontally positions the geo metric 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 speci fied 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 ex panded traces If this would cause the segment of any expanded trace to go outside of the range of the number of segments of sources the difference is adapted and then applied to the traces The VAB bit bit 2 in the STB register Table 8 page 137 is set if a value outside the legal range is specified The HOR_POSITION query returns the position of the geometric center of the intensified zone on the source trace lt exp_trace gt Hor_POSition lt hor_position gt lt segment gt lt exp_trace gt EA EB MC MD lt hor_position gt
175. s with ext trigger amp Not available in 9424E 4 ch oscilloscopes without ext trigger 155 5 System Commands QUERY SYNTAX Response format EXAMPLE GPIB TV TRIGGER COMMAND SYNTAX QUERY SYNTAX Response format for CUST50 and CUST60 only 156 TI EV PS PL IS IL 25NS to 20S for TI 1 to 10 for EV 2 5NS to 20S for PS and PL 10NS to 20S for IS 25NS to 20S for IL these values are only valid for single source and pattern triggers Note The suffix S seconds is optional lt hold_type gt lt hold_value gt on TRig SElect TRig_SElect lt trig_type gt SR lt source gt HT lt hold_type gt HV lt hold_value gt The following command selects the single source trigger with Channel 1 as trigger source Hold type and hold value are chosen as Pulse smaller than 20 psec CMD TRSE SNG SR C1 HT PS HV 20 US CALL IBWRT SCOPE CMDS TRig_ SElect TV SR lt source gt FLDC lt field_count gt FLD lt field gt CHAR lt characteristics gt LPIC lt Ipic gt ILAC lt ilace gt LINE lt line gt LINE lt line gt lt source gt EX in 2 channel oscilloscopes lt source gt C3 in 4 channel oscilloscopes lt field_count gt 1 2 4 8 lt field gt 1 to field_count lt characteristics gt NTSC PALSEC CUSTS50 CUST60 lt Ipic gt 1 to 1500 lt ilace gt 1 2 4 8 lt line gt 1 to 1500 Note The FLD value is interpreted with the cur
176. scilloscope to respond on data line 2 DIO2 CMD1 _ CALL IBCMD BRD0 CMD1 CMD INE 1 PRE 1 CALL IBWRT BRD0 CMD CMD4 CHR amp H5S CHR amp H69 CALL IBCMD BRD0 CMD4 23 3 GPIB Operation IST Poll 24 Stage 2 Parallel poll the instrument until DIO2 is set LOOP 1 WHILE LOOP CALL IBRPP BRD0 PPR IF PPR AND amp H2 2 THEN LOOP 0 WEND Stage 3 Disable parallel polling hex 15 and clear the parallel poll register CMDS CHR amp H15 CALL IBCMD BRD0 CMDS CALL IBCMD BRD0 CMDi CMD PRE 0 CALL IBWRT BRD0 CMD Note 1 In the example above board level GPIB function calls are used It is assumed that the controller board and oscillo scope device are respectively located at addresses 0 and 4 The listener and talker addresses for the controller and oscilloscope are Logic device Listener address Talker address controller 32 ASCII lt space gt 64 ASCII oscilloscope 32 4 36 ASCII 64 4 68 ASCII D Note 2 The characters and _ appearing in the command strings stand for unlisten and untalk respectively They are used to set the devices to a known State Note 3 To shorten the size of the program examples device talk ing and listening initialization instructions have been grouped into character chains They are CMD1 Unlisten Untalk PC talker DSO listener Note 4 The remote message code for
177. selects Channel 1 and Channel 2 traces to be stored It prevents Expansion A from being stored DIS and enables an autostore to the card until no more space is left on the memory card AUTO FILL Every data point will be trans ferred to the card in BYTE format CMD STST C1 FILE C2 FILE EA DIS AUTO FILL SIZE BYTE CALL IBWRT SCOPE CMD RELATED COMMANDS STORE INR 142 WAVEFORM TRANSFER DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS System Commands 5 STORE_TEMPLATE STTM Command Oscilloscopes fitted with the MC0O1 Option The STORE TEMPLATE command stores the instrument s waveform template on the memory card A filename is automati cally generated in the form of LECROYvv TPL where vv is the 2 digit revision number Note As an example the file name generated will be LECROY21 TPL for revision 2 1 Refer to Section 6 for further information about the waveform template STore_TeMplate The following code stores the current waveform template on the memory card for future reference CMD STTM CALL IBWRT SCOPE CMD TEMPLATE 143 5 System Commands WAVEFORM TRANSFER TEMPLATE TMPL Query DESCRIPTION The TEMPLATE query produces a copy of the template which formally describes the various logical entities making up a com plete waveform In particular the template describes in full detail the variables contained in the descriptor part of a waveform
178. sing the ver tical position control Note 2 If the parameter display is turned on or the pass fail dis play or the extended parameters display the parameters of the specified trace will be shown unless the newly chosen trace is not displayed or has been acquired in sequence mode these condi tions will produce an environment error see Table 6 page 84 To only change the trace without repositioning the cursors the CUR SOR_SET command may be given with no argument e g EB CRST Notation HABS Horizontal absolute VABS Vertical absolute HREF Horizontal reference HDIF Horizontal difference VREF Vertical reference VDIF Vertical difference PREF Parameter reference PDIF Parameter difference 61 5 System Commands COMMAND SYNTAX QUERY SYNTAX Response Format EXAMPLE GPIB RELATED COMMANDS 4 channel oscilloscopes only 62 lt trace gt CuRsor_SeT lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt lt position gt lt trace gt EA EB MC MD FE FF Cl C2 C3 C4 lt cursor gt HABS VABS HREF HDIF VREF VDIF PREF PDIF lt position gt 0 to 10 DIV horizontal 13 to 13 DIV vertical Note 1 The suffix DIV is optional Note 2 Parameters are grouped in pairs The first parameter specifies the cursor to be modified and the second one indicates its new value Parameters may be grouped in any order and may be restricted to those items to b
179. sition mode With the mode SINGLE this command will not arm the trigger Use the command ARM_AC QUISITION to actually start a single acquisition The TRIG_MODE query returns the current trigger mode TRig MoDe lt mode gt lt mode gt AUTO NORM SEQNCE SINGLE WRAP TRig MoDe TRig_ MoDe lt mode gt The following command selects the sequence mode CMD TRMD SEQNCE CALL IBWRT SCOPE CMD ARM_ACQUISITION STOP TRIG_SELECT ACQUISITION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS System Commands 5 TRIG_PATTERN TRPA 2 ch and 4 ch oscilloscopes with external trigger Command Query The TRIG_PATTERN command defines a trigger pattern The command specifies the logic composition of the pattern sources Channel 1 Channel 2 External and the conditions under which a trigger can occur Note that this command can be used even if the complex trigger mode has not been activated Notation Low High Don t Care pattern present AB pattern absent pattern entered EX pattern exited The TRIG_PATTERN query returns the current trigger pattern TRig PAttern lt C1_state gt lt C2_state gt lt EX_state gt lt trig_condi tion gt lt C1_state gt L H X lt C2_state gt L H X lt EX_state gt L H X lt trig_condition gt PR AB EN EX TRig PAttern TRig_ PAttern lt C1_state gt lt C2_state gt lt EX_state gt
180. t lt card_status gt NC BAD BLANK UNKNOWN_FMT DIR_MISSING OK lt read write gt WP RW lt free_space gt a decimal number giving the number of bytes still available on the card lt card_size gt a decimal number giving the total number of bytes on the card lt battery_status gt BAT_OK BAT_LOW BAT_BAD Notation NC No card BAD Bad card after formatting BLANK Empty card UNKNOWN_FMT Valid PCMIA format but not supported DIR_MISSING No LECROY 1_DIR subdirectory pres ent It will be automatically created with the next store command OK The card is correctly formatted WP Write protected RW Read Write authorized BAT_OK The battery Is in order BAT_LOW The battery should be replaced BAT_BAD Bad battery or no battery 85 5 System Commands EXAMPLE GPIB RELATED COMMANDS 86 The following code will first format a memory card and then verify its status CMD FCRD CALL IBWRT SCOPE CMD CMD FCRD CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message FCRD OK RW 130048 131072 BAT_OK DIRECTORY_LIST System Commands g FUNCTION FUNCTION_RESET FRST Command DESCRIPTION The FUNCTION_RESET command resets a waveform processing function The number of sweeps will be reset to zero and the proc ess restarted COMMAND SYNTAX lt function gt Function_ReSeT EXAMPLE GPIB lt function gt MC MD FE FF Assuming that
181. t etc and occasionally minor logic changes Where any such inconsistencies exist please be assured that the unit is correct and incorporates the most up to date cir cuitry In a similar way the firmware may undergo revision when the instrument is serviced Should this be the case manual up dates will be made available as necessary Products requiring maintenance should be returned to the Cus tomer Service Department or authorized service facility LeCroy will repair or replace any product under warranty at no charge The purchaser is only responsible for transportation charges For all LeCroy products in need of repair after the warranty pe riod the customer must provide a Purchase Order Number before repairs can be initiated The customer will be billed for parts and labor for the repair as well as for shipping To determine your nearest authorized service facility contact the Customer Service Department or your field office All products returned for repair should be identified by the model and serial numbers and include a description of the defect or failure name and phone number of the user and in the case of products re turned to the factory a Return Authorization Number RAN The RAN may be obtained by contacting the Customer Service Department in New York tel 914 578 6061 in Geneva tel 41 22 719 21 11 or your nearest sales office Return shipments should be made prepaid LeCroy will not accept C O D or Co
182. t in an environ ment error The response to the INTERLEAVED query indicates whether the oscilloscope is in the RIS mode InterLeaVeD lt mode gt lt mode gt ON OFF InterLeaVeD InterLeaVeD lt mode gt The following command sets the oscilloscope into RIS mode CMD ILVD ON CALL IBWRT SCOPE CMD TIME_DIV TRIG_MODE 103 5 System Commands STATUS DESCRIPTION QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 104 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 lt value gt lt value gt 0 or 1 The following command reads the contents of the IST bit CMD IST CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message IST 0 PRE System Commands 5 DISPLAY KEY Command DESCRIPTION The KEY command is used to display a string in the menu field next to one of the 9 menu buttons The string may consist of up to 12 characters and may be positioned at 4 different locations above L1 opposite LC or below L2 the menu buttons or LB between pairs of buttons 1 2 3 4 5 6 or 7 8 See Figure 1 on next page Note The button names shown in Figure l are not the same as those indicated in the front panel figure at the beginning
183. te Trigger message GET causes the oscillo scope to arm the trigger system It is functionally identical to the TRG command This interface message is executed when the controller holds the Remote ENable control line REN true and configures the instru ment as a listener The REMOTE LED on the front panel lights up to indicate that the instrument is set to the remote mode All the front panel controls are disabled except the left hand menu but tons the intensity controls and the LOCAL button The menu indications on the left hand side of the screen no longer appear since menus cannot now be operated manually Whenever the controller returns the REN line to false all instruments on the bus return to LOCAL Individual instruments can be returned to LO CAL with the Go To Local message see below As a rule remote commands are only executed when the instru ment is in the remote state whereas queries are always executed Local front panel control may be regained by pressing the LO CAL push button unless the instrument was placed in the Local LOckout LLO mode The Local LOckout command LLO causes the LOCAL button on the front panel of the oscilloscope to be disabled The LLO command can be sent in local or remote mode but only becomes effective once the instrument has been set to the remote mode The Go To Local message GTL causes the instrument to return to the local mode All front panel controls become active and the me
184. text may be sup pressed with the command COMM_HEADER Depending on the state of the instrument and the computation to be done the controller may have to wait up to several seconds for a response Command interpretation does not have priority over other oscilloscope activities It is therefore judicious to set the con troller IO timeout conditions to 3 or more seconds In addition it must be remembered that an incorrect query message will not gen erate a response message i x 1 LOCAL AND REMOTE STATE PROGRAM MESSAGE FORM About Remote Control 2 As a rule remote commands are only executed by the instrument when it is in the REMOTE state whereas queries are always ex ecuted A few commands which don t affect the state of the front panel are also executed in LOCAL refer to the beginning of Sec tion 5 for a list of these commands When the instrument is in REMOTE all front panel controls are disabled except the left hand menu buttons the intensity controls which can be disabled with the command INTENSITY and the LOCAL button which can be disabled by setting the instrument to LOCAL LOCKOUT For an explanation on how to set the instrument to LOCAL REMOTE or LOCAL LOCKOUT refer to Section 3 for GPIB and to Section 4 for RS 232 C An instrument is remotely controlled with program messages which consist of one or several commands or queries separated by semicolons lt gt and ended by a terminator
185. tion of the WAVEFORM command in Section for the names of the various blocks Please be aware that a waveform query response can easily be a block containing over 200 000 bytes if it is in binary format and twice as much if the HEX option is used The binary response to a query command of the form Ci WAVEFORM or C1 WAVEFORM ALL can be put into a disk file and then dumped to show the following hexadecimal and ASCII form This was done over GPIB with de fault settings Byte offset 0 16 32 48 64 80 96 112 128 144 160 176 192 208 224 240 256 272 288 304 320 336 352 368 384 400 416 432 448 Binary contents in hexadecimal 4331 3030 0000 0000 0000 0000 004c 0005 0000 2800 0100 0037 0000 OObe 0000 0000 0000 0000 0000 0000 d913 0000 0000 0004 ooof 001a 0025 0031 0039 CA57 3433 0000 0000 0000 0000 4543 alf4 0000 0000 0000 4ccc 0800 4579 0000 0000 0000 0000 0000 0000 4abo 0000 ofoo 0006 0011 001c 0027 0032 000a 4620 3057 004c 0000 0000 400 524f b100 0000 0000 0000 cd3a 0031 8ee0 0000 0000 0000 0000 0000 0000 0004 0000 oo3f 0007 0011 oo0id 0027 0033 414c 4c2c 2339 3030 3030 5939 8435 305f 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 2a00 0000 0000 2900 0000 0000 0000 0000 0100 0000 0100 0000 cccd 0046 fe00 00c7 0000 2bcc 77be 49fe 783b e800 0000 0058 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 0000 00
186. to an inte ger array and data to be written from an integer array to GPIB Since the integer array allows storage of up to 64 kilobytes in BA SIC IBRDI and IBWRTI should be used for the transfer of large PROGRAMMING SERVICE REQUESTS GPIB Operation 3 data blocks to the computer memory 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 the function calls IBRD and IBWRT for more modern programming languages such as C are much less limited in the data block size IBTMO can be used to change the time out value during program execution The default value of the GPIB driver is 10 seconds e g if the instrument does not respond to a IBRD call IBRD will return with an error after the specified time IBTRG executes the IEEE 488 1 standard message Group Ex ecute Trigger GET which causes the oscilloscope to arm the trigger system National Instruments supply 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 The use of such calls is shown in Example 3 of Appendix A When an oscilloscope is used in a remote application events often occur asynchronously i e at times that are unpredictable for the host computer The most common case is waiting for a trigger after the instrument has been armed The controller must wait until the acquisit
187. ue gt The following code returns the value measured with the vertical relative cursor on Channel 1 CMD C1 PECV VREL CALL IBWRT SCOPE CMD CALL IBRD SCOPE RSP PRINT RSP Response message C1 PECV VREL 56 MV CURSOR_MEASURE PERSIST PER_CURSOR_SET 123 5 System Commands COMMUNICATION DESCRIPTION COMMAND SYNTAX QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS 124 PERSIST_SETUP PESU Command Query The PERSIST_SETUP command sets the number of sweeps to be retained in the persistence display The PERSIST_SETUP query reports the number of sweeps that will currently be retained in the persistence display PErsist_SetUp lt sweeps gt lt sweeps gt 1 2 5 10 20 50 100 200 INF PErsist_SetUp PErsist_SetUp lt sweeps gt The following code sets the number of sweeps contributing to the persistence display to 50 CMD PESU 50 CALL IBWRT SCOPE CMD PERSIST System Commands 5 STATUS PRE Command Query DESCRIPTION The PRE command sets the PaRallel poll Enable register PRE The lowest 8 bits of the Parallel Poll Register PPR are composed of the STB bits The PRE command allows the user to specify which bit s of the parallel poll register will affect the ist individ ual status bit The PRE query reads the contents of the PRE register The re sponse is a decimal number which corresponds to the binary sum of the register bits Not
188. ue to be assigned Pairs may be given in any order and may be restricted to the variables to be changed Note 2 The pair SWEEPS lt max_sweeps gt applies only when aver aging AVGS has been chosen Otherwise it is ignored lt function gt DEFine lt function gt DEFine EQN lt equation gt MAXPTS lt max_points gt SWEEPS lt max_sweeps gt 67 5 System Commands EXAMPLE GPIB The following command defines Function E FE to compute the summed average of Channel 1 using 5000 points over 200 sweeps CMD FE DEF EON AVGS C1 MAXPTS 5000 SWEEPS 200 CALL IBWRT SCOPE CMD RELATED COMMANDS FUNCTION_RESET FUNCTION_STATE INR t 4 channel oscilloscopes only 68 System Commands 5 ee em FUNCTION DEFINE DEF Command Query Oscilloscopes fitted with the WP01 Option DESCRIPTION An oscilloscope fitted with the Waveform Processing option WP01 accepts additional forms of the DEFINE command Processing Notation ABS Absolute Value AVGC Continuous Average AVGS Summed Average DERI Derivative EXP Exponential power of e EXP10 Exponential power of 10 EXTR Extrema FLOOR Floor Extrema only ERES Enhanced Resolution Filter INTG Integral LOG10 Logarithm base 10 LN Logarithm base e ROOF Roof Extrema only SQR Square SQRT Square Root Identity or Add Negation or Subtract Multiply Ratio Reciprocal 69 n System Commands COMMAND SYNTAX 4 channel oscilloscopes only 70
189. ursor gt lt cursor lt cursor gt lt cursor gt HABS VABS HREF HDIF VREF VDIF ALL Note If lt cursor gt is not specified ALL will be assumed If the position of a cursor cannot be determined in a particular situa tion its position will be indicated as UNDEF PEr_Cursor_Set lt cursor gt lt position gt lt cursor gt lt position gt lt cursor gt lt position gt 121 5 System Commands EXAMPLE GPIB The following code positions the HREF and HDIF cursors at 2 6 DIV and 7 4 DIV respectively using Memory C as a reference CMD MC PECS HREF 2 6 DIV HDIF 7 4DIV RELATED COMMANDS CURSOR_MEASURE PERSIST PER_CURSOR_VALUE 122 System Commands 5 CURSOR DESCRIPTION QUERY SYNTAX Response format EXAMPLE GPIB RELATED COMMANDS t 4 channel oscilloscopes only PER_CURSOR_VALUE PECV Query The PER _CURSOR_VALUE query returns the values measured by the specified cursors for a given trace Notation HABS Horizontal absolute HREL Horizontal relative VABS Vertical absolute VREL Vertical relative lt trace gt PEr Cursor_Value lt cursor gt lt cursor gt lt cursor gt lt trace gt EA EB MC MD FE FF C1 C2 C34 C44 lt cursor gt HABS VABS HREL VREL ALL Note If lt cursor gt is not specified ALL will be assumed lt trace gt PEr_Cursor_Value lt cursor gt lt value gt lt cursor gt lt value gt lt cursor gt lt val
190. weighted sum of the register bits The register is cleared with an INR or ALST query a CLS command or after power on INTERNAL STATE CHANGE ENABLE REGISTER INE The INE allows one or more events in the Internal State Change Status Register to be reported to the INB summary bit in the STB The Internal State Change Enable Register is modified with the command INE It is cleared with the command INE 0 or after power on It may be read with the query INE COMMAND ERROR STATUS REGISTER CMR The Command Error Status register contains the code of the last command error detected by the instrument Command error codes are listed with the command CMR in Section 5 The Command Error Status Register may be read via the query CMR The response is the error code The register is cleared with a CMR or ALST query a CLS command or after power on DEVICE DEPENDENT ERROR STATUS REGISTER DDR The DDR indicates the type of hardware errors affecting the in strument Individual bits in this register report specific hardware failures They are listed with the command DDR in Section 5 The Device Dependent Error Status Register may be read via the query DDR The response is the binary weighted sum of the error bits The register is cleared with a DDR or ALST query a CLS command or after power on EXECUTION ERROR STATUS REGISTER EXR The
191. wide range of plotters and printers and be instructed to directly plot or print the screen con tents onto these devices The devices supported by the unit are listed with the command HARDCOPY SETUP in Section 5 When the hard copy device is connected to the GPIB two differ ent configurations should be considered depending on whether or not a GPIB controller is available When only the oscilloscope and the hard copy device are con nected to the GPIB the oscilloscope must be configured as talker only and the hard copy device as listener only to ensure proper data transfer The oscilloscope can be configured as a talker only by using the thumbwheel switch at the rear of the in strument to select an address larger than 30 The hard copy device manufacturer usually specifies an address which forces the instrument into the listening mode Select the oscilloscope s address to be larger than 30 Switch on the oscilloscope Configure the Hardcopy sub menu in the Auxiliary Set ups menu specifying GPIB as hard copy port e Put the hard copy device in listener only mode Press the screen dump button on the front panel of the in strument 25 3 GPIB Operation Plotting Printing with a GPIB Controller 1 Data read by controller and sent to printer plotter 2 Oscilloscope sends data to controller and printer plotter If a controller is connected to the GPIB data transfers must be supervise
192. window function is Rectangular The DC compo nent of the input is not suppressed CMD FE DEF EQN PS FFT 1 018 C1 0 055 MAXPTS 1000 WINDOW RECT DCSUP OFF CALL IBWRT SCOPE CMD lt function gt DEFine EQN lt equation gt SWEEPS lt max_sweeps gt lt equation gt MAG AVGP lt source gt lt equation gt PS AVGP lt source gt lt equation gt PSD AVGP lt source gt lt source gt MC MD FE FF lt max_sweeps gt 1 to 50000 Note The source waveform must be another function defined as a Fourier transform System Commands 5 QUERY SYNTAX lt function gt DE Fine Response Format lt function gt DEFine EQN lt equation gt SWEEPS lt max_sweeps gt EXAMPLE GPIB The following command defines Function F to compute the Power Spectrum of the Power Average of the FFT being computed by the Function E over a maximum of 244 sweeps CMD FE DEF EQN PS AVGP FE SWEEPS 244 CALL IBWRT SCOPE CMDS RELATED COMMANDS FUNCTION_RESET FUNCTION_STATE INR t 4 channel oscilloscopes only 75 5 System Commands MISCELLANEOUS DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 76 DELETE_FILE DELF Command Oscilloscopes fitted with the MC0O1 Option The DELETE_FILE command deletes all waveforms only Auto stored waveforms or only a single file from the memory card Notation WF all waveforms AUTOWF all aut
193. woaeawemeaeageueseeeaagaene Serial Number May 1992 REMOTE CONTROL MANUAL MODELS 9410 14 20 24 30 350 DUAL AND QUAD CHANNEL DIGITAL OSCILLOSCOPES LeCroy Corporate Headquarters 700 Chestnut Ridge Road Chestnut Ridge NY 10977 6499 Tel 914 425 2000 TWX 710 577 2832 European Headquarters 2 rue Pr de la Fontaine P O Box 341 1217 Meyrin 1 Geneva Switzerland Tel 022 719 21 11 Telex 419 058 Copyright May 1992 LeCroy All rights reserved information in this publication supersedes all earlier versions Specifications subject to change pwmeaeeeeneaeewnseaenseews eee TABLE OF CONTENTS es e peaqagaaea _i a 8a geeseea8a8ese 1 General Information Initial Inspection 1 Warranty 1 Product Assistance 1 Maintenance Agreements 1 Document Discrepancies 2 Service Procedure 2 Return Procedure 2 2 About Remote Control GPIB Implementation Standard 3 Program Messages 3 Commands and Queries 4 Local and Remote State 5 Program Message Form 5 Command Query Form 6 Response Message Form 9 3 GPIB Operation GPIB Structure 11 Interface Capabilities 11 Addressing 12 GPIB Signals 12 IEEE 488 1 Standard Messages 13 Programming GPIB Transfers 15 Programming Service Requests 19 Instrument Polls 21 Driving a Hard copy Device 25 4 RS 232 C Operation Introduction 29 RS 232 C Pin Assignments 29 RS 232 C Configuration 30 Commands Simulating GPIB Commands 33 Table of Contents se he ee 5 System C
194. y be inspected by giving its name e g TRIGTIME as mentioned in the template enclosed in quotes as the first string parameter The special logical block named WAVEDESC may also be in spected in more detail By giving the name of a variable in the block WAVEDESC enclosed in quotes as the first string parame ter it is possible to inspect only the actual value of that variable Notation BYTE raw data as integers truncated to 8 m s b WORD raw data as integers truncated to 16 m s b FLOAT normalized data gain offset applied as floating point numbers gives measured values in voits or appropriate units most significant bits lt trace gt INSPect lt string gt lt data_type gt lt trace gt EA EB MC MD FE FF C1 C2 C34 C4 lt string gt a valid name of a logical block or a valid name of a variable contained in block WAVEDESC see the command TEMPLATE and Section 6 lt data_type gt BYTE WORD FLOAT Note The optional parameter lt data_type gt applies only for in specting the data arrays It selects the representation of the data The default lt data type gt is FLOAT 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 EXAMPLES GPIB RELATED COMMANDS System Commands 5 1 The following command reads the value of the time base at which the last waveform in Channel 1 was acqu
195. y not reported by the instru ment unless the controller explicitly examines the relevant status register or if the status enable registers have been set in such a way that the controller can be interrupted when an error occurs The status registers are explained in Section 7 During the development of the control program it is possible to observe all remote control transactions including error messages on an external monitor connected to the RS 232 C port Refer to the command COMM_HELP for further details Program messages consist of one or several commands or queries A command directs the instrument to change its state e g to change its time base or vertical sensitivity A query asks the instru ment about its state Very often the same mnemonic is used for a command and a query the query being identified by a lt gt after the last character For example to change the time base to 2 msec div the controller should send the following command to the instrument TIME_DIV 2 MS To ask the instrument about its time base this query should be sent TIME_DIV A query causes the instrument to send a response message The control program should read this message with a read instruc tion to the GPIB or RS 232 C interface of the controller The response message to the query above 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
196. y range see table above The TIME DIV query returns the current time base setting Time_DIV lt value gt lt value gt 1 NS to 5 KS Note The suffix S seconds is optional Time_DIV Time_DIV lt value gt 145 5 System Commands EXAMPLE GPIB The following command sets the time base to 500 psec div CMD TDIV 500US CALL IBWRT SCOPE CMD The following command sets the time base to 2 msec div CMD TDIV 002 CALL IBWRT SCOPE CMD RELATED COMMANDS INTERLEAVED TRIG_DELAY TRIG_MODE 146 System Commands 5 DISPLAY TRACE TRA Command Query DESCRIPTION The TRACE command enables or disables the display of a trace An environment error Table 6 page 84 is set if an attempt is made to display more than four waveforms The TRACE query indicates whether the specified trace is dis played or not COMMAND SYNTAX lt trace gt TRAce lt mode gt lt trace gt C1 C2 C3 C4 EA EB MC MD FE FF lt mode gt ON OFF QUERY SYNTAX lt trace gt TRAce Response format lt trace gt TRAce lt mode gt EXAMPLE GPIB The following command displays Function E FE CMD FE TRA ON CALL IBWRT SCOPE CMDS t 4 channel oscilloscopes only 147 5 System Commands ACQUISITION DESCRIPTION COMMAND SYNTAX EXAMPLE GPIB RELATED COMMANDS 148 TRG Command The TRG command executes an ARM command Note The TRG command is the equivalent of the 488
197. ys displayed in the upper grid and Channel 2 in the lower grid In the 4 channel oscilloscopes Channels 1 and 2 are always dis played in the upper grid and Channels 3 and 4 in the lower grid All other waveforms can be vertically positioned anywhere In quad grid mode Channel 1 is always displayed in the upper grid Channel 2 in the second grid etc All other waveforms can be vertically positioned anywhere The GRID query returns the grid mode currently in use GRID lt grid gt lt grid gt SINGLE DUAL QUAD GRID GRID lt grid gt The following command sets the screen display to dual grid mode CMD GRID DUAL CALL IBWRT SCOPE CMD HARD COPY DESCRIPTION COMMAND SYNTAX System Commands 5 HARDCOPY_SETUP HCSU Command Query The HARDCOPY_SETUP command configures the instrument s hard copy driver The command enables the user to specify the device type transmission mode plot size etc of the hard copy unit connected to the oscilloscope The command allows one or more individual settings to be changed by specifying the appropriate keyword s together with the new value s For instance to select the Graphtec FP5301 plotter with normal speed the command may be restricted to HCSU DEV FP5301 SPEED N Notation DEV device PORT port SPEED plot speed DENS print density PENS plot pens PFEED page feed PSIZE paper size GRID grid square LLX lower left X LLY lower left Y FP5301 Graphtec FP5301 P

Remote Control Manual - DISCONTINUED

Contents

Download Pdf Manuals

Related Search

Related Contents