Teledyne 1000, 2000 User Manual
WaveAce 1000/2000
Remote Control
Command Refere nce
700 Chestnut Ridge Road
Chestnut Ridge, NY, 10977-6499
Tel: (845) 425-2000, Fax: (845) 578 5985
teledynelecroy.com
WaveAce 1000/2000 Remote Control Operator's Manual
© 2013 Teledyne LeCroy, Inc. All rights reserved.
WaveAce is a registered trademark of Teledyne LeCroy, Inc.
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. Specifications are subject to change
without notice.
920836 Rev B
September 2013
Operator's Manual
TABLE OF CONTENTS
Part I: Introduction to Remote Control ........................................................................................................ 3
About This Manual ................................................................................................................................... 3
About Remote Control ............................................................................................................................. 3
Remote Control Through USB .................................................................................................................. 4
Remote Control Through LAN .................................................................................................................. 5
Program Messages ................................................................................................................................... 6
Response Messages.................................................................................................................................. 9
Using Status Registers ............................................................................................................................ 10
Commands and Queries by Subsystem .................................................................................................. 12
Commands and Queries by Name (Alphabetical) .................................................................................. 15
Part II: Command Reference ...................................................................................................................... 17
Command Notation ................................................................................................................................ 17
ACQUISITION - *TRG............................................................................................................................... 18
ACQUISITION - ARM_ACQUISITION, ARM .............................................................................................. 18
ACQUISITION - AUTO_SETUP, ASET........................................................................................................ 18
ACQUISITION – ACQUIRE_WAY, ACQW ................................................................................................. 19
ACQUISITION - ATTENUATION, ATTN ..................................................................................................... 20
ACQUISITION - BANDWIDTH_LIMIT, BWL .............................................................................................. 21
ACQUISITION - COUPLING, CPL .............................................................................................................. 22
ACQUISITION - FORCE_TRIGGER, FRTR .................................................................................................. 22
ACQUISITION - INTERLEAVED, ILVD ........................................................................................................ 23
ACQUISITION - OFFSET, OFST ................................................................................................................. 24
ACQUISITION – PEAK DETECT, PDET ....................................................................................................... 25
ACQUISITION - STOP ............................................................................................................................... 25
ACQUISITION - TIME_DIV, TDIV .............................................................................................................. 26
ACQUISITION - TRIG_COUPLING, TRCP .................................................................................................. 27
ACQUISITION - TRIG_DELAY, TRDL ......................................................................................................... 28
ACQUISITION - TRIG_LEVEL, TRLV .......................................................................................................... 29
ACQUISITION - TRIG_MODE, TRMD ....................................................................................................... 30
ACQUISITION - TRIG_SELECT, TRSE ........................................................................................................ 31
ACQUISITION - TRIG_SLOPE, TRSL .......................................................................................................... 32
ACQUISITION - VOLT_DIV, VDIV ............................................................................................................. 33
ACQUISITION - WAIT .............................................................................................................................. 34
CURSOR - CURSOR_MEASURE, CRMS .................................................................................................... 35
CURSOR - CURSOR_SET, CRST ................................................................................................................ 36
CURSOR - CURSOR_VALUE?, CRVA? ....................................................................................................... 37
CURSOR - PARAMETER_CUSTOM, PACU ................................................................................................ 38
CURSOR - PARAMETER_VALUE?, PAVA? ................................................................................................ 40
DISPLAY - DOT_JOIN, DTJN ..................................................................................................................... 42
920836 Rev B i
WaveAce Remote Control
DISPLAY - HOR_MAGNIFY, HMAG .......................................................................................................... 43
DISPLAY - HOR_POSITION, HPOS ............................................................................................................ 44
DISPLAY - INTENSITY, INTS ...................................................................................................................... 45
DISPLAY - PERSIST, PERS ......................................................................................................................... 45
DISPLAY - PERSIST_SETUP, PESU ............................................................................................................ 46
DISPLAY – SCREEN SAVE, SCSV ............................................................................................................... 47
DISPLAY - TRACE, TRA ............................................................................................................................. 48
MISCELLANEOUS - *CAL? ....................................................................................................................... 49
MISCELLANEOUS - *IDN? ....................................................................................................................... 49
MISCELLANEOUS – AUTO-CALIBRATE, ACAL .......................................................................................... 50
MISCELLANEOUS - BUZZER, BUZZ .......................................................................................................... 50
MISCELLANEOUS - COMM_HEADER, CHDR ........................................................................................... 51
MISCELLANEOUS - DEFINE, DEF ............................................................................................................. 52
MISCELLANEOUS - DELETE_FILE, DELF ................................................................................................... 53
MISCELLANEOUS - DIRECTORY, DIR ....................................................................................................... 53
MISCELLANEOUS – FILENAME, FLNM..................................................................................................... 54
SAVE/RECALL SETUP - *RCL .................................................................................................................... 55
SAVE/RECALL SETUP - *RST .................................................................................................................... 55
SAVE/RECALL SETUP - *SAV ................................................................................................................... 56
SAVE/RECALL SETUP - RECALL_PANEL, RCPN ......................................................................................... 56
STATUS - *CLS ......................................................................................................................................... 57
STATUS - *ESE ......................................................................................................................................... 57
STATUS - *ESR? ....................................................................................................................................... 58
STATUS - *OPC........................................................................................................................................ 59
STATUS - ALL_STATUS?, ALST? ............................................................................................................... 60
STATUS - CMR? ....................................................................................................................................... 61
STATUS - DDR? ....................................................................................................................................... 62
STATUS - EXR? ........................................................................................................................................ 63
STATUS - INR? ......................................................................................................................................... 65
WAVEFORM TRANSFER - STORE, STO .................................................................................................... 66
WAVEFORM TRANSFER - WAVEFORM, WF ............................................................................................ 66
WAVEFORM TRANSFER – WAVEFORM SETUP, WFSU ........................................................................... 68
Appendix: Waveform Template ................................................................................................................ 69
Wave Descriptor Block WAVEDESC; Explanation ................................................................................... 69
Oscilloscope's TMPL? Query Response .................................................................................................. 85
Decoding Floating Point Numbers .......................................................................................................... 88
ii 920836 Rev B
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 Con t rol
WaveAce 1000 and 2000 series oscilloscopes can be controlled remotely through a USBTMC or TCP/IP
(LAN) interface. USB control is a standard feature on all WaveAce devices; TCP/IP control is standard on
WaveAce 2000 devices only.
Remote control is accomplished through the exchange of program messages between the oscilloscope
and a controller computer using the selected interface. The USBTMC interface utilizes standard IEEE
488.1 and IEEE 488.2 (GPIB) messages. The TCP/IP interface utilizes Teledyne LeCroy's VICP protocol,
which emulates IEEE 488.2 and includes standard operation bits in a header defined by the VICP
protocol.
All program messages exchanged between the scope and the controller must be formatted according
to these protocols.
See Program Messages (on page 6) for more information about constructing commands and queries
for control programs. The supported commands are listed in Commands and Queries by Subsystem
(on page 12) and Command and Queries by Name (Alphabetical) (on page 15), and are detailed in the
Command Reference section of this manual.
920836 Rev B
3
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. You may use either the NI-VISA run-time or the full download. The run-time
download is significantly smaller.
You can send remote commands to the oscilloscope directly from the WaveStudio® terminal.
WaveStudio can be downloaded free at teledynelecroy.com/support/softwaredownload, under
Oscilloscope Downloads -> Oscilloscope Software Utilities.
4
920836 Rev B
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.
You can send remote commands to the oscilloscope directly from the WaveStudio® terminal.
WaveStudio can be downloaded free at teledynelecroy.com/support/softwaredownload, under
Oscilloscope Software Utilities.
On the Controller
For communication using the VICP (LAN) interface, no additional driver software is required when
using WaveStudio. For VICP communication with other applications that use the VISA standard, NI-VISA
must be installed, along with Teledyne LeCroy's 'VICP Passport'. The Passport extends VISA to support
Teledyne LeCroy's VICP protocol. The VICP passport may be downloaded from teledynelecroy.com.
Also see the application brief LAB_WM827 Understanding VICP and the VICP Passport on Teledyne
LeCroy's website for more information.
On the Instrument
1. Attach an Ethernet cable from the LAN port on the rear of the scope to an Ethernet port on the
controller machine or a connection device on the same network as the controller.
920836 Rev B
5
WaveAce Remote Control
2. From the WaveAce menu, choose Utility > IP Settings (on the third page of settings).
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:
<command/query>; . . . . . ;<command/query> <terminator>
Command/Query Synt ax
The general form of a command or a query is an optional header path, followed by a command header,
optionally followed by one or several
[header_path:]<header>[?] [<data>,...,<data>]
NOTE:
There is a space between the header and the first parameter.
Commas separate parameters.
The question mark [?] is optional and turns the command into a query.
The oscilloscope does not distinguish between upper- and lowercase characters. Commands/queries are shown
mixed-case in this manual to call out the short form within the long form.
parameters (shown as <data> in the following construct):
6
920836 Rev B
Operator's Manual
C1, C2
Channels 1 and 2
C3, C4
Channels 3 and 4 (on four-channel models)
M1,M2,M3,M4,M5,M6,M7,M8,M9,M10
Memory Units 1 through 10
LINE source for trigger
Header path
Commands or queries that apply to a subsection of the oscilloscope, such as a single input channel,
must have their headers prefixed with a path name indicating the channel or trace recipient of the
command. It's recommended to always use header paths to minimize the risk of error if the command
order changes.
The header path normally consists of an abbreviated path name followed by a colon ( : ) immediately
preceding the command header.
C1:OFST -300 MV
The target waveform trace is specified using the following header path names:
Header Path Name Oscilloscope Reference
TA, TB, TC, TD FFT of the corresponding Channel 1-4; in some commands
also used to refer to zooms.
EX, EX5 External trigger
LINE
NOTE: Header paths TA-TD are used only to refer to the FFT of the channel, or in some cases to expanded traces
(zooms).
Header paths need only be specified once until the path changes. Subsequent commands without
header paths are assumed to refer to the most recently defined path:
C2:VDIV?;C2:OFST? is equivalent to C2:VDIV?;OFST?
Header
The header is the mnemonic form of the operation to be performed by the oscilloscope. Most headers
have a more easily recognized long form and a short form for better transfer and decoding speed. The
two can be used interchangeably:
TRIG_MODE AUTO is equivalent to TRMD AUTO
Some command or query mnemonics are imposed by the IEEE 488.2 standard. All these mnemonics
begin with an asterisk *.
920836 Rev B
7
WaveAce Remote Control
EX
1E18
Exa-
T
1E12
Tera-
MA
1E6
Mega-
M
1E-3
milli-
N
1E-9
nano-
F
1E-15
femto-
PE
1E15
Peta-
G
1E9
Giga-
K
1E3
kilo-
U
1E-6
micro-
Data Parameters
When a command uses additional data values, they are expressed as ASCII data that can take the form
of character, numeric, string, or block data. Macro parameters are not implemented.
An exception is the transfer of waveforms with the WAVEFORM command/query, where the waveform
is expressed as a sequence of binary data values.
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.
HARDCOPY_SETUP DEST,PRINTER,PRINTER,EPSON
Here, two pairs are shown: the first specifies the DESTination is a PRINTER, while the second specifies
the PRINTER is EPSON. Any HARDCOPY_SETUP parameters that are not relevant for printers, or are left
unchanged, are omitted from the command.
Numeric Data
The numeric data type is used to enter quantitative information. Numbers can be entered as integers,
fractions, or exponents:
C1:VPOS -5
C2:OFST 3.56
TDIV 5.0E-6
Numeric values can be followed with multipliers and units modifying the value of the numeric
expression. The following table of mnemonics is recognized:
Multiplier Exponential Notation
Suffix
8
920836 Rev B
Operator's Manual
P
1E-12
pico-
A
1E-18
atto-
State
TCP/IP
USB
Recv
EOI
CR
Send
LF+EOI
LF+CR
Multiplier Exponential Notation
Suffix
String Data
This is used to send multiple characters as a single parameter. Enclose any sequence of ASCII
characters between single or double quotation marks:
DIRectory DISK,UDSK,ACTION,CREATE,'20120801Results'
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.
Terminator/Delimiter
The oscilloscope does not decode an incoming program message before receiving its terminator unless
the message is longer than the 512 byte input buffer, at which point the oscilloscope starts analyzing
the message once the buffer is full.
Terminators vary by interface:
Response Messages
The oscilloscope sends a response message to the controller in answer to a query. The format of
response messages is the same as that of program messages: commands separated by semi-colons
and ending in terminators. Suffix units are also expressed in the response. These messages can be
sent back to the oscilloscope in the form in which they were received to be accepted as valid
commands.
For example, if the controller sends the message:
TIME_DIV?;TR_MODE NORM;C1:COUPLING?
920836 Rev B
9
WaveAce Remote Control
The oscilloscope might respond with:
TIME_DIV 50 NS;C1:COUPLING D50
Note the response message refers only to the two queries that were sent in the original message.
Whenever you expect a response from the oscilloscope, add the query form of the command to the
control program following the command to specify that a read response is desired. If the controller
sends another command without reading the response to the previous one, the response message in
the output buffer of the oscilloscope will be discarded.
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.
• Program messages can contain a mix of short and long form command/query headers, but
response messages will always contain the short form unless you use the COMM_HEADER
command to specify the long form or no header at all.
Using Status Registers
Status registers allow you to quickly determine the instrument's internal processing status at any time.
These registers and the oscilloscope's status reporting system, which group related functions together,
are designed to comply with IEEE 488.2 recommendations.
Registers such as the Standard Event Status Register (ESR) are required by the IEEE 488.2 Standard.
Others are device specific. Commands associated with IEEE 488.2 mandatory status registers are
preceded with an asterisk * in the Command Reference section.
• Enable registers such as the Standard Event Status Enable Register (ESE) are used to generate a bit-wise
AND with their associated status registers.
• The ESR primarily summarizes errors, whereas INR summarizes the instrument’s internal working state.
Additional details of errors reported by ESR can be obtained with the queries CMR?, DDR?, and EXR?.
If you were to send the erroneous command TRIG_MAKE SINGLE to your instrument, the oscilloscope
would reject it and set the Command Error Register (CMR) to the value 1 (unrecognized
command/query header). The non-zero value of CMR would be reported to Bit 5 of the Standard Event
Status Register (ESR), which is then set.
You can read the value of CMR and simultaneously reset to zero at any time using the CMR? command.
The occurrence of a command error can also be detected by analyzing the response to *ESR?.
Standard Event Status Register (ESR)
ESR is a 16-bit register reflecting the occurrence of events. ESR bit assignments have been
standardized by IEEE 488.2. Only the lower eight bits are currently in use.
10
920836 Rev B
Operator's Manual
Read ESR using the *ESR? query. The response is the binary weighted sum of the register bits. The
register is cleared with *ESR? or ALST?, with *CLS, or when power is applied to the scope. For example,
the response message *ESR 160 indicates that a command error occurred and the ESR is being read for
the first time after power-on. The value 160 can be broken down into 128 (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 to read/ clear this register in order to set the CMR bit in the ESR on the next command error.
Standard Event Status Enable Register (ESE)
This register allows you to report one or more events in the ESR.
Modify ESE with *ESE and clear it with *ESE 0 (or by powering-on the oscilloscope). Read it with *ESE?.
For example, use *ESE 4 to set bit 2 (decimal 4) of the ESE Register to enable query error reporting.
Internal State Change Status Register (INR)
INR reports the completion of a number of internal operations (the events tracked by this 16-bit-wide
register are listed with the INR? description in Part II).
Read the register using INR?. The response is the binary weighted sum of the register bits. Clear the
register with INR? or ALST?, a *CLS command, or when power is applied to the oscilloscope.
Command Error Status Register (CMR)
This register contains the code of the last command error detected by the oscilloscope. List these error
codes using CMR?.
Read CMR with CMR?. The response is the error code. Clear the register with a CMR? or ALST? query, a
*CLS command, or when power is applied to the oscilloscope.
Device Dependent Error Status Register (DDR)
DDR indicates the type of hardware errors affecting your instrument. Individual bits in this register
report specific hardware failures. List them using DDR?.
Also, read this register using the DDR? query. The response is the binary weighted sum of the error
bits. Clear it with another DDR? or with ALST?, a *CLS command, or when power is applied to the
oscilloscope.
Execution Error Status Register (EXR)
EXR contains the code of the last execution error detected by the oscilloscope. List these error codes
with EXR?.
Read the register, again using the EXR? query. The response is the error code. Clear with another EXR?
or with ALST?, a *CLS command, or when power is applied to the oscilloscope.
920836 Rev B
11
WaveAce Remote Control
Short Form
Long Form
What the Command/Query Does
*TRG
*TRG
Executes an ARM command.
ACQW
ACQUIRE_WAY
Specifies the acquisition mode.
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.
CPL
COUPLING
Selects the specified input channel's coupling mode.
FRTR
FORCE_TRIGGER
Forces the instrument to make one acquisition.
ILVD
INTERLEAVED
Enables/disables Random Interleaved Sampling (RIS).
OFST
OFFSET
Allows output channel vertical offset adjustment.
PDET
PEAK_DETECT
Enables or disables built-in peak detection function.
STOP
STOP
Immediately stops signal acquisition.
TDIV
TIME_DIV
Modifies the timebase setting.
TRCP
TRIG_COUPLING
Sets the coupling mode of the specified trigger source.
TRDL
TRIG_DELAY
Sets the time at which the trigger is to occur.
TRLV
TRIG_LEVEL
Adjusts the trigger level of the specified trigger source.
TRMD
TRIG_MODE
Specifies the trigger mode.
TRSE
TRIG_SELECT
Selects the condition that will trigger acquisition.
TRSL
TRIG_SLOPE
Sets the trigger slope of the specified trigger source.
VDIV
VOLT_DIV
Sets the vertical sensitivity.
WAIT
WAIT
Prevents new analysis until current is completed.
Short Form
Long Form
What the Command/Query Does
CRMS
CURSOR_MEASURE
Specifies the type of cursor/parameter measurement.
CRST
CURSOR_SET
Allows positioning of any cursor.
CRVA?
CURSOR_VALUE?
Returns trace values measured by specified cursors.
PACU
PARAMETER_CUSTOM
Controls parameters with customizable qualifiers.
PAVA?
PARAMETER_VALUE?
Returns current parameter, mask test values.
Commands and Queries by Subsystem
Acquisition - Controlling Waveform Captures
Cursor - Performing Measuremen t s
12
920836 Rev B
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.
SCSV
SCREEN_SAVE
Enables or disables the screen saver.
TRA
TRACE
Enables or disables the display of a trace.
Short Form
Long Form
What the Command/Query Does
*CAL?
*CAL?
Performs a complete internal calibration.
*IDN?
*IDN?
Returns device identification data.
ACAL
AUTO_CALIBRATE
Performs periodic calibration of instrument. Supported only on
WaveAce 2000 series.
BUZZ
BUZZER
Controls the buzzer in the instrument.
CHDR
COMM_HEADER
Controls formatting of query responses.
DEF
DEFINE
Specifies mathematical function to perform.
DIR
DIRCTORY
Creates or deletes file directories on mass storage devices.
FLNM
FILENAME
Changes default filename of traces, setups and hard copies.
Short Form
Long Form
What the Command/Query Does
*RST
*RST
Initiates a device reset.
*SAV
*SAV
Stores current state in internal memory.
RCPN
RECALL_PANEL
Recalls a front panel setup from mass storage.
Miscellaneous
Operator's Manual
Save/Recall Setup - Making and Restoring Front Panel Settings
920836 Rev B
13
WaveAce Remote Control
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.
CMR?
CMR?
Reads, clears the CoMmand error Register (CMR).
DDR?
DDR?
Reads, clears the Device Dependent Register (DDR).
EXR?
EXR?
Reads, clears the EXecution error Register (EXR).
INR?
INR?
Reads, clears INternal state change Register (INR).
Short Form
Long Form
What the Command/Query Does
STO
STORE
Stores a trace in internal memory or mass storage.
WF
WAVEFORM
Transfers a waveform from controller to scope.
WFSU
WAVEFORM_SETUP
Specifies amount of waveform data to go to controller.
Status - Obtaining Status Information Using Status Registers
Waveform Transfer – Creating and Preserving Waveforms
14
920836 Rev B
Operator's Manual
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.
*SAV
*SAV
Stores current state in internal memory.
*TRG
*TRG
Executes an ARM command.
ACAL
AUTO_CALIBRATE
Performs periodic calibration of instrument. Supported only on
WaveAce 2000 series.
ACQW
ACQUIRE_WAY
Specifies the acquisition mode.
ALST?
ALL_STATUS?
Reads and clears the contents of all status registers.
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.
BUZZ
BUZZER
Controls the buzzer in the instrument.
BWL
BANDWIDTH_LIMIT
Enables/disables bandwidth-limiting low-pass filter.
CHDR
COMM_HEADER
Controls formatting of query responses.
CMR?
CMR?
Reads, clears the CoMmand error Register (CMR).
CPL
COUPLING
Selects the specified input channel's coupling mode.
CRMS
CURSOR_MEASURE
Specifies the type of cursor/parameter measurement.
CRST
CURSOR_SET
Allows positioning of any cursor.
CRVA?
CURSOR_VALUE?
Returns trace values measured by specified cursors.
DDR?
DDR?
Reads, clears the Device Dependent Register (DDR).
DEF
DEFINE
Specifies mathematical function to perform.
DIR
DIRCTORY
Creates or deletes file directories on mass storage devices.
DTJN
DOT_JOIN
Controls the interpolation lines between data points.
EXR?
EXR?
Reads, clears the EXecution error Register (EXR).
FLNM
FILENAME
Changes default filename of traces, setups and hard copies.
FRTR
FORCE_TRIGGER
Forces the instrument to make one acquisition.
HMAG
HOR_MAGNIFY
Horizontally expands the expanded trace.
HPOS
HOR_POSITION
Horizontally positions intensified zone's center.
ILVD
INTERLEAVED
Enables/disables Random Interleaved Sampling (RIS).
INR?
INR?
Reads, clears INternal state change Register (INR).
Commands and Queries by Name (Alphabetical)
920836 Rev B
15
WaveAce Remote Control
Short Form
Long Form
What the Command/Query Does
INTS
INTENSITY
Controls the brightness of the grid.
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.
RCPN
RECALL_PANEL
Recalls a front panel setup from mass storage.
SCSV
SCREEN_SAVE
Enables or disables the screen saver.
STO
STORE
Stores a trace in internal memory or mass storage.
STOP
STOP
Immediately stops signal acquisition.
TDIV
TIME_DIV
Modifies the timebase setting.
TRA
TRACE
Enables or disables the display of a trace.
TRCP
TRIG_COUPLING
Sets the coupling mode of the specified trigger source.
TRDL
TRIG_DELAY
Sets the time at which the trigger is to occur.
TRLV
TRIG_LEVEL
Adjusts the trigger level of the specified trigger source.
TRMD
TRIG_MODE
Specifies the trigger mode.
TRSE
TRIG_SELECT
Selects the condition that will trigger acquisition.
TRSL
TRIG_SLOPE
Sets the trigger slope of the specified trigger source.
VDIV
VOLT_DIV
Sets the vertical sensitivity.
WAIT
WAIT
Prevents new analysis until current is completed.
WF
WAVEFORM
Transfers a waveform from controller to scope.
WFSU
WAVEFORM_SETUP
Specifies amount of waveform data to go to controller.
16
920836 Rev B
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., DoT_JoiN and DTJN).
Where applicable, the syntax of the query is given with the format of its response. For each command,
a short GPIB example illustrating a typical use is also provided. The device name of the oscilloscope is
defined as SCOPE% in the examples, but you can substitute any valid device name.
Queries obtain information. They are recognized by ? following their headers. Many commands can be
used as queries simply by adding the question mark.
TIP: You can always find out the correct form of a command by manually setting up the oscilloscope in the exact
required condition, and then sending a query which corresponds to the command. The reply from the
oscilloscope can then be copied into your program as a command.
Commands make use of the following notational symbols:
• < > - Angular brackets enclose words used as placeholders of which there are two types - the header path
and the data parameter of a command.
• := - A colon followed by an equals sign separates a placeholder from the description of the type and range
of values for use in a command instead of the placeholder.
• { } - Braces enclose a list of choices, one of which must be made.
• [ ] - Square brackets enclose optional items.
• … - An ellipsis indicates the items to its left and right can be repeated any number of times.
920836 Rev B
17
WaveAce Remote Control
ACQUISITION - *TRG
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
The ARM_ACQUISITION command arms the scope or forces a single acquisition if it is already armed.
Command Syntax
ARM_acquisition
Related Commands
STOP, *TRG, TRIG_MODE, WAIT, FORCE_TRIGGER
ACQUISITION - AUTO_SETUP, ASET
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.
Command Syntax
Auto_SETup
18
920836 Rev B
ACQUISITION – ACQUIRE_WAY, ACQW
The ACQUIRE_WAY command specifies the acquisition mode.
The ACQUIRE_WAY? query returns the current acquisition mode.
Command Syntax
<channel>: ACQuire_Way <mode>[,<time>]
<channel>:= {C1,C2,C3,C4,EX,EX10}
<mode>:= {SAMPLING, PEAK_DETECT, AVERAGE}
<time>:= {4,16,32,64,128,256}
NOTE: The time parameter can only be set with the AVERAGE acquisition mode.
Query Syntax
<channel>:ACQUIRE_WAY?
Operator's Manual
Response Format
<channel>: ACQuire_Way <mode>[,<time>]
Example
The following command sets the acquisition mode to Average every 16:
C1:ATTN 100
Related Commands
AVGA, PDET
920836 Rev B
19
WaveAce Remote Control
ACQUISITION - ATTENUATION, ATTN
The ATTENUATION command selects the vertical attenuation factor of the probe. Values up to 1000
can be specified.
The ATTENUATION? query returns the attenuation factor of the specified channel.
Command Syntax
<channel>: ATTeNuation <attenuation>
<channel>:= {C1,C2,C3,C4,EX,EX10}
<attenuation>:= {1,5,10,50,100,500,1000}
Query Syntax
<channel>:ATTeNuation?
Response Format
<channel>:ATTeNuation <attenuation>
Example
The following instruction sets to 100 the attenuation factor of Channel 1:
C1:ATTN 100
20
920836 Rev B
Operator's Manual
ACQUISITION - BANDWIDTH_LIMIT, BWL
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 <channel>,<mode>[,<channel>,<mode>...]
<channel>:= {C1, C2, C3, C4}
<mode>: = {ON, OFF}
Query Syntax
BWL?
Response Format
BWL <mode>
Example
This instruction sets a low-pass filter on Channel 2:
BWL C2,ON
920836 Rev B
21
WaveAce Remote Control
ACQUISITION - COUPLING, CPL
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
<channel>:CouPLing <coupling>
<channel>:= {C1,C2,C3,C4,M1,M2,M3,M4,M5,M6,M7,M8,M9,M10}
<coupling>:= {A1M*, D1M*, GND}
* Attenuation pertains only to instruments with a probe connected.
Query Syntax
<channel>:CouPLing?
Response Format
<channel>:CouPLing <coupling>
<coupling>:= {A1M, D1M, D50, GND, OVL}
COUPLING OVL is returned in the event of signal overload while in DC 50 Ω coupling. In this condition,
the oscilloscope will disconnect the input.
Example
The following instruction sets the coupling of Channel 2 to Ground:
C2:CPL GND
ACQUISITION - FORCE_TRIGGER, FRTR
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...
22
920836 Rev B
Operator's Manual
ACQUISITION - INTERLEAVED, ILVD
The INTERLEAVED command enables or disables Equivalent Time Mode for timebase settings where
both single shot and RIS mode are available.
Equivalent Time Mode is not available for sequence mode acquisitions. If sequence mode is on, ILVD
ON turns it off.
The response to the INTERLEAVED? query indicates whether the oscilloscope is in Equivalent Time
Mode.
Command Syntax
InterLeaVeD <mode>
<mode>:= {ON, OFF}
Query Syntax
InterLeaVeD?
Response Format
InterLeaVeD <mode>
Example
The following instructs the oscilloscope to use Equivalent Time Mode:
ILVD ON
Related Commands
TIME_DIV, TRIG_MODE
920836 Rev B
23
WaveAce Remote Control
ACQUISITION - OFFSET, OFST
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.
Command Syntax
<channel>:OFfSeT <offset>
<channel>:= {C1, C2, C3, C4}
<offset>:=
Refer to datasheet specification for your Teledyne LeCroy oscilloscope at
teledynelecroy.com.
Query Syntax
<channel>:OFfSeT?
Response Format
<channel>:OFfSeT <offset>
Example
The following instruction sets the offset of Channel 2 to -3 V:
C2:OFST -3V
24
920836 Rev B
Operator's Manual
ACQUISITION – PEAK DETECT, PDET
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.
Command Syntax
Peak_DETect <state>
<state> : = {ON, OFF}
Query Syntax
Peak_DETect?
Response Format
PDET <state>
Example
The following instruction turns on the peak detector:
PDET ON
ACQUISITION - STOP
The STOP command immediately stops the acquisition of a signal. If the trigger mode is AUTO or
NORM, STOP places the oscilloscope in STOPPED trigger mode to prevent further acquisition.
Command Syntax
STOP
Related Commands
ARM_ACQUISITION, TRIG_MODE, WAIT, FORCE_TRIGGER
920836 Rev B
25
WaveAce Remote Control
ACQUISITION - TIME_DIV, TDIV
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 <value>
<value>:=
Refer to datasheet specification for your Teledyne LeCroy oscilloscope at at
teledynelecroy.com.
The default unit S (seconds) is optional.
Query Syntax
Time_DIV?
Response Format
Time_DIV <value>
Example
The following instruction sets the time base to 500 µs/div:
TDIV 500US
The following instruction sets the time base to 2 msec/div:
TDIV 0.002
Related Commands
TRIG_DELAY, TRIG_MODE
26
920836 Rev B
Loading...