WaveAce 1000/2000 Remote Control Operator’s Manual
700 Chestnut Ridge Road Chestnut Ridge, NY, 10977-6499 Tel: (845) 425-2000, Fax: (845) 578 5985 www.teledynelecroy.com WaveAce 1000/2000 Remote Control Operator's Manual © 2012 Teledyne LeCroy Corporation. All rights reserved. WaveAce is a registered trademark of Teledyne LeCroy Corporation. Teledyne LeCroy and other product or brand names are trademarks or requested trademarks of their respective holders. Information in this publication supersedes all earlier versions.
Operator's Manual TABLE OF CONTENTS Part I: Introduction to Remote Control .....................................................................................................1 About This Manual ...................................................................................................................................1 About Remote Control .............................................................................................................................1 Remote Control Through USB ........
WaveAce Remote Control DISPLAY - INTENSITY, INTS ..................................................................................................................... 42 DISPLAY - PERSIST, PERS ......................................................................................................................... 42 DISPLAY - PERSIST_SETUP, PESU ............................................................................................................ 43 DISPLAY – SCREEN SAVE, SCSV .......................
Operator's Manual Part I: Introduction to Remote Control About This Manual This manual includes a complete list of the command you’ll need to perform most WaveAce® 1000 and 2000 operations remotely. Part I is an introduction to remote control and remote command syntax. Part II lists all supported command headers with valid data parameters and values. About Remote Control WaveAce 1000 and 2000 series oscilloscopes can be controlled remotely through a USBTMC or TCP/IP (LAN) interface.
WaveAce Remote Control Remote Control Through USB The USB interface is standard on every WaveAce oscilloscope. The rear panel USB port is the remote control interface. 1. Attach a USB A/B cable from the USB-B port on the rear panel of the scope to a USB-A port on the controller computer. 2. Install NI-VISA on the controller machine. NI-VISA contains the USB drivers needed to form the interface between the oscilloscope and the controller. NI-VISA can be downloaded free from www.ni.com/visa.
Operator's Manual Remote Control Through LAN WaveAce 2000 series oscilloscopes have a standard LAN connection port for remote control that utilizes Teledyne LeCroy's VICP protocol for transmitting messages. This protocol emulates IEEE 488.2 (GPIB) and includes operation bits corresponding to SRQ, EOI, Clear, and others in a header that is defined by the VICP protocol. The WaveAce must be assigned a static IPv4 address for remote control; do not use an address from the DHCP pool.
WaveAce Remote Control 3. Enter an IP Address, Subnet Mask, and Gate Way. Enter values by selecting each segment and turning the Adjust knob until the desired number is reached. Press the top soft key to jump to the next field or press the Adjust knob to tab to the next segment of the current field. Leave DHCP disabled. Program Messages Program messages are composed of commands or queries separated by semicolons and ending with a terminator: ; . . . . .
Operator's Manual The header path normally consists of an abbreviated path name followed by a colon ( : ) immediately preceding the command header.
WaveAce Remote Control Character Data These are simple alphanumeric words or abbreviations indicating a specific action. In commands where you can specify many parameters, or where not all parameters are applicable at the same time, the format requires pairs of character data values. The first value names the parameter to be modified, while the second gives its value.
Operator's Manual Block Data These are binary data values used to transfer waveforms from the oscilloscope to the controller using the WAVEFORM command/query. Buffer size limitations apply to block data: If data exceeding the oscilloscope’s 512 byte input buffer limited is received, the excess is discarded until a terminator (delimiter) is detected. If data exceeding the output queue is transmitted, commands that are not interpreted and excess data are discarded.
WaveAce Remote Control The oscilloscope follows stricter rules for response messages than for program messages: Program messages may be in upper- or lower-case characters, but response messages will always be upper-case. Program messages may contain extraneous spaces or tabs, but response messages will not.
Operator's Manual (Bit 7) plus 32 (bit 5). See the table with the ESR command description in Part Two for the conditions corresponding to the bit set. The Power ON bit appears only on the first *ESR? query after power-on (since the query clears the register). You can determine this type of command error by reading the CMR bit with CMR?. It is not necessary that you read/ clear this register in order to set the CMR bit in the ESR on the next command error.
WaveAce Remote Control Commands and Queries by Subsystem Acquisition - Controlling Waveform Captures Short Form Long Form What the Command/Query Does *TRG *TRG Executes an ARM command. ARM ARM_ACQUISITION Changes acquisition state from stopped to single. ASET AUTO_SETUP Adjusts vertical, timebase and trigger parameters. ATTN ATTENUATION Selects the vertical attenuation factor of the probe. BWL BANDWIDTH_LIMIT Enables/disables bandwidth-limiting low-pass filter.
Operator's Manual Display - Displaying Waveforms Short Form Long Form What the Command/Query Does DTJN DOT_JOIN Controls the interpolation lines between data points. HMAG HOR_MAGNIFY Horizontally expands the expanded trace. HPOS HOR_POSITION Horizontally positions intensified zone's center. INTS INTENSITY Controls the brightness of the grid. PERS PERSIST Enables or disables the persistence display mode. PESU PERSIST_SETUP Selects display persistence duration.
WaveAce Remote Control Status - Obtaining Status Information Using Status Registers Short Form Long Form What the Command/Query Does *CLS *CLS Clears all status data registers. *ESE *ESE Sets the standard Event Status Enable register (ESE). *ESR? *ESR? Reads, clears the Event Status Register (ESR). *OPC *OPC Sets the OPC bit in the Event Status Register (ESR). ALST? ALL_STATUS? Reads and clears the contents of all status registers.
Operator's Manual Commands and Queries by Name (Alphabetical) Short Form Long Form What the Command/Query Does *CAL? *CAL? Performs a complete internal calibration. *CLS *CLS Clears all status registers. *ESE *ESE Sets the standard Event Status Enable register (ESE). *ESR? *ESR? Reads, clears the Event Status Register (ESR). *IDN? *IDN? Returns device identification data. *OPC *OPC Sets the OPC bit in the Event Status Register (ESR). *RST *RST Initiates a device reset.
WaveAce Remote Control Short Form Long Form What the Command/Query Does OFST OFFSET Allows output channel vertical offset adjustment. PACU PARAMETER_CUSTOM Controls parameters with customizable qualifiers. PAVA? PARAMETER_VALUE? Returns current parameter, mask test values. PDET PEAK_DETECTED Enables or disables built-in peak detection function. PERS PERSIST Enables or disables the persistence display mode. PESU PERSIST_SETUP Selects display persistence duration.
Operator's Manual Part II: Command Reference All remote control commands and queries recognized by the instrument can be executed in either a local or remote state. This section lists commands and queries by short name in alphabetical order within subsystem. Command Notation A brief explanation of the operation performed by the command or query is followed by the formal syntax, with the full-name header given in lowercase characters and the short form derived from it in uppercase characters (e.g.
WaveAce Remote Control ACQUISITION - *TRG Description The *TRG command executes an ARM command. *TRG is the equivalent of the 488.1 GET (Group Execute Trigger) message. Command Syntax *TRG Related Commands ARM_ACQUISITION, STOP, WAIT, FORCE_TRIGGER ACQUISITION - ARM_ACQUISITION, ARM Description The ARM_ACQUISITION command arms the scope or forces a single acquisition if it is already armed.
Operator's Manual ACQUISITION - AUTO_SETUP, ASET Description The AUTO_SETUP command displays the input signal(s) by adjusting the vertical, timebase, and trigger parameters. AUTO_SETUP operates on all channels. If signals are detected on several channels, the lowest numbered channel with a signal determines the selection of the timebase and trigger source. If only one input channel is turned on, the timebase will be adjusted for that channel.
WaveAce Remote Control ACQUISITION - BANDWIDTH_LIMIT, BWL Description The BWL command enables or disables the bandwidth limit (low-pass filter) of the specified input channel. The BWL? query returns the enabled/disabled status. If all the channels are in the same state, it returns the state; if not, it returns each individual channel state. Command Syntax BandWidth_Limit ,[,,...
Operator's Manual ACQUISITION - COUPLING, CPL Description The COUPLING command selects the coupling mode of the specified input channel. The COUPLING? query returns the coupling mode of the specified channel. Command Syntax :CouPLing := {C1,C2,C3,C4,M1,M2,M3,M4,M5,M6,M7,M8,M9,M10} := {A1M*, D1M*, GND} * Attenuation pertains only to instruments with a probe connected.
WaveAce Remote Control ACQUISITION - FORCE_TRIGGER, FRTR Description Causes the instrument to make one acquisition. Command Syntax FoRce_TRigger Example Either of the following instructions forces the oscilloscope to make one acquisition: TRMD SINGLE;ARM;FRTR... TRMD STOP;ARM;FRTR... ACQUISITION - INTERLEAVED, ILVD Description The INTERLEAVED command enables or disables Equivalent Time Mode for timebase settings where both single shot and RIS mode are available.
Operator's Manual ACQUISITION - OFFSET, OFST Description The OFFSET command allows adjustment of the vertical offset of the specified input channel. The OFFSET? query returns the DC offset value of the specified channel. The maximum ranges depend on the fixed sensitivity setting. If an out-of-range value is entered, the oscilloscope is set to the closest possible value. NOTE: The probe attenuation factor is not taken into account in offset adjustments. Also, the unit V is optional.
WaveAce Remote Control ACQUISITION – PEAK DETECT, PDET Description The PEAK_DETECT command switches ON or OFF the peak detector built into the acquisition system. The PEAK_DETECT? query returns the current status of the peak detector.
Operator's Manual ACQUISITION - TIME_DIV, TDIV Description The TIME_DIV command modifies the timebase setting. The new timebase setting can be specified with units: N/NS for nanoseconds, U/US for microseconds, M/MS for milliseconds, or S for seconds. Alternatively, you can use exponential notation: 10E-6. The TIME_DIV? query returns the current timebase setting. Command Syntax Time_DIV := Refer to datasheet specification for your Teledyne LeCroy oscilloscope at at www.teledynelecroy.com.
WaveAce Remote Control ACQUISITION - TRIG_COUPLING, TRCP Description The TRIG_COUPLING command sets the coupling mode of the specified trigger source. The TRIG_COUPLING? query returns the trigger coupling of the selected source.
Operator's Manual ACQUISITION - TRIG_DELAY, TRDL Description The TRIG_DELAY command sets the time at which the trigger is to occur with respect to the nominal zero delay position, which defaults to the center of the grid. RANGE Negative delay: 0 to - divisions x Time/div supported by scope Postive delay: 0 to + division x Time/div supported by scope If a value outside these ranges is specified, the trigger time is set to the nearest limit.
WaveAce Remote Control ACQUISITION - TRIG_LEVEL, TRLV Description The TRIG_LEVEL command adjusts the trigger level of the specified trigger source. An out-ofrange value will be adjusted to the closest legal value. The TRIG_LEVEL? query returns the current trigger level.
Operator's Manual ACQUISITION - TRIG_MODE, TRMD Description The TRIG_MODE command specifies the trigger mode. The TRIG_MODE? query returns the current trigger mode.
WaveAce Remote Control ACQUISITION - TRIG_SELECT, TRSE Description The TRIG_SELECT command selects the condition that triggers the acquisition of waveforms. Only the Edge trigger is supported. Command Syntax TRig_Select EDGE,SR,
Operator's Manual ACQUISITION - TRIG_SLOPE, TRSL Description The TRIG_SLOPE command sets the trigger slope of the specified trigger source. The TRIG_SLOPE? query returns the trigger slope of the selected source.
WaveAce Remote Control ACQUISITION - VOLT_DIV, VDIV Description The VOLT_DIV command sets the vertical sensitivity in Volts/div. The probe attenuation factor is not taken into account for adjusting vertical sensitivity. The VOLT_DIV? query returns the vertical sensitivity of the specified channel. Command Syntax :Volt_DIV := {C1, C2, C3, C4} := Refer to datasheet specification for your Teledyne LeCroy oscilloscope at www.teledynelecroy.com.
Operator's Manual ACQUISITION - WAIT Description The WAIT command prevents your instrument from analyzing new commands until the current acquisition has been completed. The optional argument specifies the timeout (in seconds) after which the scope stops waiting for new acquisitions. If is not given, or if = 0.0, the scope waits indefinitely.
WaveAce Remote Control CURSOR - CURSOR_MEASURE, CRMS Description The CURSOR_MEASURE command specifies the type of cursor or parameter measurement to be displayed, and is the main command for displaying parameters and Pass/Fail. Use it to turn on/off cursors. The CURSOR_MEASURE? query indicates which cursors or parameter measurements are currently displayed. Command Syntax CuRsor_MeaSure := {HREL, VREL} Where: HREL - Horizontal relative cursors. VREL - Vertical relative cursors.
Operator's Manual CURSOR - CURSOR_SET, CRST Description The CURSOR_SET command allows you to position any one of the independent cursors at a given grid location. When you are setting a cursor position, you must specify an active trace relative to which the cursor is positioned. The CURSOR_SET? query retrieves the current position of the cursor(s). The values returned depend on the grid type selected: HREF Horizontal Cursor A VREF Vertical Cursor A. HDIF Horizontal Cursor B VDIF Vertical Cursor B.
WaveAce Remote Control CURSOR - CURSOR_VALUE?, CRVA? Description The CURSOR_VALUE? query returns the values measured by the specified cursors. The PARAMETER_VALUE? query is used to obtain measured waveform parameter values. The keyword ALL should not be used; neither should multiple keywords. If they are used, the word UNDEF is returned. For the CRVA? query to work, the specified trace must be visible, and the current cursor mode must be the same as in the query. If it is not the same, UNDEF is returned.
Operator's Manual CURSOR - PARAMETER_CUSTOM, PACU Description The PARAMETER_CUSTOM command controls the placement of custom cursors and can also be used to assign any parameter for histogramming. NOTE: Use PAVA? to read the value of parameters that were set up with PACU. When PAVA? is used to query a Custom parameter, the source for the measurement is the one configured using the PACU command.
WaveAce Remote Control Query Syntax PArameter_CUstom? Response Format PArameter_Custom ,, Example PACU 1,MAX,C1 Related Commands PARAMETER_VALUE 36 920836 Rev A
Operator's Manual CURSOR - PARAMETER_VALUE?, PAVA? Description The PARAMETER_VALUE query returns the current values of the pulse waveform parameters and mask tests for the specified trace. Traces do not need to be displayed or selected to obtain the values measured by the pulse parameters or mask tests. Query Syntax :PArameter_VAlue? [,...,] := {TA,TB,TC,TD,C1,C2,C3,C4} NOTE: When PAVA? Is used to query a Custom parameter, the prefix is returned for consistency.
WaveAce Remote Control Response Format :PArameter_VAlue ,,... := A decimal numeric value := {OK, AV, PT, IV, NP, GT, LT, OF, UF, OU} NOTE: If is not specified, or is equal to ALL, all standard voltage and time parameters are returned followed by their values and states. Example The following instruction query reads the rise time of Trace B (TB): TB:PAVA? RISE Response message: TB:PAVA RISE,3.
Operator's Manual DISPLAY - DOT_JOIN, DTJN Description The DOT_JOIN command controls the interpolation lines between data points. Setting DOT_JOIN ON selects Points in the Display dialog; DOT_JOIN OFF selects Line.
WaveAce Remote Control DISPLAY - HOR_MAGNIFY, HMAG Description The HOR_MAGNIFY command horizontally expands traces (zooms) by a specified factor. Magnification factors not within the range of permissible values will be rounded off to the nearest legal value. The HOR_MAGNIFY? query returns the current magnification factor.
Operator's Manual DISPLAY - HOR_POSITION, HPOS Description The HOR_POSITION command repositions the geometric center of a zoom to display different portions of the trace. Allowed positions range from division 0 through 10. If the source trace was acquired in sequence mode, the shift will only apply to a single segment at a time. The difference between the specified and the current horizontal position is applied to all zooms.
WaveAce Remote Control DISPLAY - INTENSITY, INTS Description The INTenSity command sets the intensity level of the grid and trace. Command Syntax INTenSity GRID,[PCT],TRACE,[PCT] Query Syntax INTenSity? Response Format INTenSity TRACE,,GRID, Example The following example sets the grid intensity to 60% and trace intensity to 90%. INTS GRID,60,TRACE,90 DISPLAY - PERSIST, PERS Description The PERSIST command enables or disables the persistence display mode.
Operator's Manual DISPLAY - PERSIST_SETUP, PESU Description The PERSIST_SETUP command sets the duration of the display, in seconds, when in persistence mode. The persistence can be set on all traces or per trace. The PERSIST_SETUP? query indicates the current status of the persistence. Command Syntax PErsist_SetUp
WaveAce Remote Control DISPLAY – SCREEN SAVE, SCSV Description The SCREEN_SAVE command controls the automatic Screen Saver, which automatically shuts down the internal color monitor after a preset time. The SCREEN_SAVE? query indicates whether the automatic screen saver feature is on or off. NOTE: When the screen save is in effect, the oscilloscope is still fully functional.
Operator's Manual DISPLAY - TRACE, TRA Description The TRACE command enables or disables the display of a trace. An environment error is set if an attempt is made to display more than four waveforms. Refer to the table in STATUS - EXR? (on page 59) for more information. The TRACE? query indicates whether or not the specified trace is displayed.
WaveAce Remote Control MISCELLANEOUS - *CAL? Description The *CAL? query causes the oscilloscope to perform an internal self-calibration and generates a response that indicates whether or not your oscilloscope completed the calibration without error. This internal calibration sequence is the same as that which occurs at power-up.
Operator's Manual MISCELLANEOUS – AUTO-CALIBRATE, ACAL Description Available only on WaveAce 2000 models, AUTO_CALIBRATE enables or disables automatic calibration of the oscilloscope. If ACAL is ON at power-up, all input channels are periodically calibrated for the current input amplifier and timebase settings, whether the instrument has been adjusted or not. This is separate from the calibration the instrument performs whenever you adjust a gain or offset. ACAL OFF disables Auto-calibration.
WaveAce Remote Control MISCELLANEOUS - COMM_HEADER, CHDR Description The COMM_HEADER command controls the way the oscilloscope formats responses to queries. There are three response formats: LONG, responses contain the long form of the header : C1:VOLT_DIV 200E-3 V SHORT, responses contain the short form of the header : C1:VDIV 200E-3 V OFF, headers and units are omitted: 200E-3 Unless you specify otherwise, the SHORT response format is used by default.
Operator's Manual MISCELLANEOUS - DEFINE, DEF Description The DEFINE command specifies a mathematical function to be performed. This command is used to control all math tools in the standard oscilloscope. Command Syntax DEFine EQN,'[]' Query Syntax DEFine? Response Format DEFine EQN,'[]' Equations Where is shown enclosed in parentheses ( ), the function is included in the equation.
WaveAce Remote Control MISCELLANEOUS - DELETE_FILE, DELF Description The DELETE_FILE command deletes a file from the currently selected directory. Command Syntax DELF '' Example The following instruction deletes a trace file: DELF 'TESTRUN.TRC' MISCELLANEOUS - DIRECTORY, DIR Description The DIRECTORY command is used to create or delete file directories on mass storage devices. It also allows selection of the current working directory and listing of files in the directory.
Operator's Manual SAVE/RECALL SETUP - *RCL Description The *RCL command sets the state of your instrument, using one of the six non-volatile panel setups (Panel 1 to Panel 6), by recalling the complete front panel setup of the oscilloscope. Entering panel setup 0 corresponds to the default panel setup. The *RCL command produces an effect the opposite of the *SAV command.
WaveAce Remote Control SAVE/RECALL SETUP - *SAV Description The *SAV command stores the current state of your instrument in non-volatile internal memory. The *SAV command stores the complete front panel setup of the oscilloscope at the time the command is issued. NOTE: Communication parameters (those modified by the commands COMM_HEADER and WAVEFORM_SETUP) are not saved when *SAV is used.
Operator's Manual STATUS - *CLS Description The *CLS command clears all status data registers. Command Syntax *CLS Related Commands ALL_STATUS, CMR, DDR, *ESR, EXR, *STB STATUS - *ESE Description The *ESE command sets the value of the ESB bit in the Event Status Enable register (ESE). The *ESE? query reads the contents of the ESE register.
WaveAce Remote Control STATUS - *ESR? 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. The following table provides an overview of the ESR register structure. Query Syntax *ESR? Response Format *ESR := 0 to 255 Response message: *ESR 0 Related Commands ALL_STATUS, *CLS, *ESE ESR? Status Register Structure Bit Value Name 15...
Operator's Manual Bit Value Name Description Note 3 8 DDE 1 - Device Dependent (specific) Error occurred. The Device specific Error (DDE) is set true (1) whenever a hardware failure has occurred at power-up or at execution time, such as a channel overload condition, or a trigger or timebase circuit defect. The origin of the failure can be localized with the DDR? query. 2 4 QYE 1 - QuerY Error occurred.
WaveAce Remote Control STATUS - ALL_STATUS?, ALST? Description The ALL_STATUS? query reads and clears the contents of all status registers: ESR, INR, DDR, CMR, and EXR. For an interpretation of the contents of each register, refer to the appropriate status register. The query is useful to obtain a complete overview of the state of your oscilloscope.
Operator's Manual STATUS - CMR? Description The CMR? query reads and clears the contents of the CoMmand error Register (refer to the following table for details) which specifies the last syntax error type detected by your oscilloscope. Query Syntax CMR? Response Format CMR := 0 to 13 Related Commands ALL_STATUS?, *CLS CMR? Status Register Structure Value Description 1 Unrecognized command/query header. 2 Illegal header path. 3 Illegal number. 4 Illegal number suffix.
WaveAce Remote Control STATUS - DDR? Description The DDR? query reads and clears the contents of the Device Dependent or device specific error Register (DDR). In the case of a hardware failure, the DDR register specifies the origin of the failure. The following table provides details. Query Syntax DDR? Response Format DDR := 0 to 65535 DDR? Status Register Structure Bit Value 15...14 Description 0 - Reserved. 13 8192 1 - Timebase hardware failure detected.
Operator's Manual STATUS - EXR? 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. Query Syntax EXR? Response Format EXR? := 21 to 64 Example The following instruction reads the contents of the EXR register: EXR? Response message (if no fault): EXR 0 Related Commands ALL_STATUS, *CLS EXR? Status Register Structure Value Description 21 Permission error.
WaveAce Remote Control Value Description 35 Waveform data error. Invalid waveform data have been detected. 36 Panel setup error. An invalid panel setup data block has been detected. 50 No mass storage present when user attempted to access it. * 51 Mass storage not formatted when user attempted to access it. * 53 Mass storage was write protected when user attempted to create a file, to delete a file, or to format the device. * 54 Bad mass storage detected during formatting.
Operator's Manual STATUS - INR? Description The INR? query reads and clears the contents of the INternal state change Register (INR). The INR register records the completion of various internal operations and state transitions. Query Syntax INR? Response Format INR := 0 to 65535 Sample Response message: INR 1026 Related Commands ALL_STATUS, *CLS INR Status Register Structure Bit Value 15 Description 0 - Reserved for future use. 14 16384 1 - Probe was changed.
WaveAce Remote Control WAVEFORM TRANSFER - STORE, STO Description The STORE command stores the contents of the selected trace.
Operator's Manual WAVEFORM TRANSFER - WAVEFORM, WF Description The WAVEFORM command transfers a waveform from the controller to the oscilloscope. The WAVEFORM? query reads a waveform from the oscilloscope to the controller. WAVEFORM stores an external waveform back into the oscilloscope's internal memory. A waveform consists of several distinct entities: DESC - The descriptor TEXT - The user text TIME - The time descriptor DAT1 - The data block and, optionally...
WaveAce Remote Control Response Format :WaveForm , TIP: It may be convenient to disable the response header if the waveform is to be restored. Refer to the COMM_HEADER, CHDR command topic for more information. Example The following instruction reads the block DAT1 from Memory 1.
Operator's Manual WAVEFORM TRANSFER – WAVEFORM SETUP, WFSU Description The WAVEFORM_SETUP command specifies the amount of data in a waveform to be transmitted to the controller. This is defined by the parameters: Sparsing, interval between data points; Number of Points, total number of points to be transmitted; First Point, the address of the first data point to be sent; Segment Number, which segment to be sent if the waveform was acquired in sequence mode.
WaveAce Remote Control Appendix: Waveform Template This section contains the Waveform Template describing the contents of the Waveform Descriptor produced by WF? DESC and WF? ALL queries. After the template, explanations detail the construction of floating point numbers from bytes in the descriptor, followed by program fragments showing a method of performing calculations.
Operator's Manual ; ;ARRAYS : ; < 48> TRIGTIME_ARRAY: long ; length in bytes of TRIGTIME array ; < 52> RIS_TIME_ARRAY: long ; length in bytes of RIS_TIME array ; < 56> RES_ARRAY1: long ; an expansion entry is reserved ; < 60> WAVE_ARRAY_1: long ; length in bytes of 1st simple ; data array. In transmitted waveform, ; represent the number of transmitted ; bytes in accordance with the NP ; parameter of the WFSU remote command ; and the used format (see COMM_TYPE).
WaveAce Remote Control ; The following variables describe the waveform and the time at ; which the waveform was generated. ; <116> WAVE_ARRAY_COUNT: long ; number of data points in the data ; array. If there are two data ; arrays (FFT or Extrema), this number ; applies to each array separately.
Operator's Manual <140> SEGMENT_INDEX: long ; for input and output, indicates the ; index of the transmitted segment. ; Value is the same as the SN parameter ; of the WFSU remote command.
WaveAce Remote Control <172> NOMINAL_BITS: word ; a measure of the intrinsic precision ; of the observation: ADC data is 8 bit ; averaged data is 10-12 bit, etc.
Operator's Manual _3 graph _4 filter_coefficient _5 complex _6 extrema _7 sequence_obsolete _8 centered_RIS _9 peak_detect endenum ; <318> PROCESSING_DONE: enum _0 no_processing _1 fir_filter _2 interpolated _3 sparsed _4 autoscaled _5 no_result _6 rolling _7 cumulative endenum ; <320> RESERVED5: word ; expansion entry ; <322> 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 ; <324> TIMEBASE:
WaveAce Remote Control _6 100_ps/div _7 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 _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 _37 2_s/div _38 5_s/div _39 10_s/div _40 20_s/div 72 920
Operator's Manual _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 ; <326> VERT_COUPLING: enum _0 DC_50_Ohms _1 ground _2 DC_1MOhm _3 ground _4 AC,_1MOhm endenum ; <328> PROBE_ATT: float ; <332> FIXED_VERT_GAIN: enum _0 1_uV/div _1 2_uV/div _2 5_uV/div _3 10_uV/div _4 20_uV/div _5 50_uV/div _6 100_uV/div _7 200_uV/div _8 500_uV/div _9 1_mV/div _10 2_mV/div _11 5_mV/div _12 10_mV/div _13 20_mV/div 920836 Rev A 73
WaveAce Remote Control _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 5_V/div _21 10_V/div _22 20_V/div _23 50_V/div _24 100_V/div _25 200_V/div _26 500_V/div _27 1_kV/div endenum ; <334> BANDWIDTH_LIMIT: enum _0 off _1 on endenum ; <336> VERTICAL_VERNIER: float ; <340> ACQ_VERT_OFFSET: float ; <344> WAVE_SOURCE: enum _0 CHANNEL_1 _1 CHANNEL_2 _2 CHANNEL_3 _3 CHANNEL_4 _9 UNKNOWN endenum ; /00 ENDBLOCK ; 74 920836 Rev A
Operator's Manual ;===================================================================== ===== ; USERTEXT: BLOCK ; ; Explanation of the descriptor block USERTEXT at most 160 bytes long. ; ; < 0> TEXT: text ; a list of ASCII characters ; /00 ENDBLOCK ; ;===================================================================== ===== ; TRIGTIME: ARRAY ; ; Explanation of the trigger time array TRIGTIME. ; This optional time array is only present with SEQNCE waveforms.
WaveAce Remote Control ; Explanation of the random-interleaved-sampling (RIS) time array RISTIME. ; This optional time array is only present with RIS waveforms. ; This data block is repeated for each sweep which makes up the RIS record ; < 0> RIS_OFFSET: double ; seconds from trigger to zeroth ; point of segment ; /00 ENDARRAY ; ;===================================================================== ===== ; DATA_ARRAY_1: ARRAY ; ; Explanation of the data array DATA_ARRAY_1.
Operator's Manual ; Complex FFT imaginary part (real part in DATA_ARRAY_1) ; Extrema floor trace (roof trace in DATA_ARRAY_1) ; Peak Detect min/max pairs (data values in DATA_ARRAY_1) ; In the first 2 cases, there is exactly one data item in DATA_ARRAY_2 for ; each data item in DATA_ARRAY_1. ; In Peak Detect waveforms, there may be fewer data values in DATA_ARRAY_2, ; as described by the variable POINTS_PER_PAIR.
WaveAce Remote Control ; Explanation of the DUAL array. ; This data array is identical to DATA_ARRAY_1, followed by DATA_ARRAY_2. ; DUAL is an accepted alias name for the combined arrays DATA_ARRAY_1 and ; DATA_ARRAY_2 (e.g. real and imaginary parts of an FFT). ; < 0> MEASUREMENT_1: data ; data in DATA_ARRAY_1. ; < 0> MEASUREMENT_2: data ; data in DATA_ARRAY_2.
Operator's Manual ; 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 ; ; In the following explanation, every element of a block is described by ; a single line in the form ; ; : ; ; ; where ; ; = position in bytes (decimal offset) of the variable, ; relative to the beginning of the block.
WaveAce Remote Control ; with the format shown below ; 63 62 .. 52 51 ... 0 bit position ; s exponent fraction ; where ; s = sign of the fraction ; exponent = 11 bit exponent e ; fraction = 52 bit fraction f ; and the final value is ; (-1)**s * 2**(e-1023) * 1.f ; enum enumerated value in the range 0 to N ; represented as a 16-bit data value. ; The list of values follows immediately. ; The integer is preceded by an _.
Operator's Manual Decoding Floating Point Numbers Single precision values are held in four bytes. If these are arranged in decreasing value order we get the following bits: bit 31, bit 30, bit 29, bit 28 . . . . . bit 3, bit 2, bit 1, bit 0 NOTE: If the byte order command CORD is set for low byte first, the bytes as received in a waveform descriptor are received in reverse order. However, within a byte the bits keep their order, highest at the left, as expected.
WaveAce Remote Control In a way not following the byte boundaries, bits are then segregated as follows: 31, 30, 29 . . . . 24, 23, 22, 21 . . . . 2, 1, 0 Sign exponent bits fractional bits bit 0.5, 0.25, 0.125 . . . The sign bit s is 1 for a negative number and 0 for a positive number, so it is easy to construct the sign from this: S = (-1)^s The 8 exponent bits have the following values: bit 2 - 1, which is 255. 127 is then subtracted from this value e creating a range from -127 to +128.
Operator's Manual Index CURSOR_SET, CRST, 33 * CURSOR_VALUE?, CRVA?, 34 *CAL?, 46 D *CLS, 53 *ESE, 53 Data, 5 *ESR?, 54 DATE, 49 *IDN?, 46 DDR?, 58 *OPC, 55 Decoding Floating Point Numbers, 81 *RCL, 51 DEFINE, DEF, 49 *RST, 51 DELETE_FILE, DELF, 50 *SAV, 52 Device Dependent Error Status Register (DDR), 9 *TRG, 26 DIRECTORY, DIR, 50 A ALL_STATUS?, ALST?, 56 DISPLAY, DISP, 39 DOT_JOIN, DTJN, 39 ARM_ACQUISITION, ARM, 16 ATTENUATION, ATTN, 17 AUTO_SETUP, ASET, 17 E Execution Error Status
WaveAce Remote Control Internal State Change Status Register (INR), 9 STORE, STO, 62 String, 6 N T Numeric, 6 O Table of Commands and Queries by Subsystem, 10 Terminator, 7 OFFSET, OFST, 21 Oscilloscope's TMPL? Query Response, 78 TIME_DIV, TDIV, 23 TRACE, TRA, 45 P PANEL_SETUP, PNSU, 52 PARAMETER_CUSTOM, PACU, 35 PARAMETER_VALUE?, PAVA?, 37 PERSIST, PERS, 42 PERSIST_SETUP, PESU, 43 TRIG_COUPLING, TRCP, 24 TRIG_DELAY, TRDL, 25 TRIG_LEVEL, TRLV, 26 TRIG_MODE, TRMD, 27 TRIG_SELECT, TRSE, 28 TRIG_SLOPE,
Operator's Manual 920836 Rev A 85