TABLE OF CONTENTS ................................................................................................................................................3
Limitation of Warranty .......................................................................................................................................7
Restricted Rights Legend....................................................................................................................................7
DECLARATION OF CONFORMITY ...............................................................................................................................7
GENERAL SAFETY INSTRUCTIONS .............................................................................................................................8
Terms and Symbols ............................................................................................................................................8
SUPPORT RESOURCES..............................................................................................................................................10
Data Acquisition ...............................................................................................................................................13
Programming and Data Access.........................................................................................................................13
Front Panel Connectors.....................................................................................................................................14
PREPARATION FOR USE ...........................................................................................................................................19
Calculating System Power and Cooling Requirements.....................................................................................19
Setting the Chassis Backplane Jumpers............................................................................................................20
Setting the Logical Address..............................................................................................................................20
COMMON SCPICOMMANDS ...................................................................................................................................38
APPENDIX A ..............................................................................................................................................................193
How RMS Noise is Calculated .......................................................................................................................193
INDEX ........................................................................................................................................................................195
6 VM2601/2/3 Preface
www.vxitech.com
CERTIFICATION
VXI Technology, Inc. certifies that this product met its published specifications at the time of shipment from the
factory. VTI further certifies that its calibration measurements are traceable to the United States National Institute of
Standards and Technology (formerly National Bureau of Standards), to the extent allowed by that organization’s
calibration facility and to the calibration facilities of other International Standards Organization members.
WARRANTY
The product referred to herein is warranted against defects in material and workmanship for a period of three years
from the receipt date of the product at customer’s facility. The sole and exclusive remedy for breach of any warranty
concerning these goods shall be repair or replacement of defective parts or a refund of the purchase price, to be
determined at the option of VTI.
For warranty service or repair, this product must be returned to a VXI Technology authorized service center. The
product shall be shipped prepaid to VTI and VTI shall prepay all returns of the product to the buyer. However, the
buyer shall pay all shipping charges, duties, and taxes for products returned to VTI from another country.
VTI warrants that its software and firmware designated by VTI for use with a product will execute its programming
when properly installed on that product. VTI does not however warrant that the operation of the product or software
or firmware will be uninterrupted or error free.
LIMITATION OF WARRANTY
The warranty shall not apply to defects resulting from improper or inadequate maintenance by the buyer, buyersupplied products or interfacing, unauthorized modification or misuse, operation outside the environmental
specifications for the product or improper site preparation or maintenance.
VXI Technology, Inc. shall not be liable for injury to property other than the goods themselves. Other than the
limited warranty stated above, VXI Technology, Inc. makes no other warranties, express, or implied, with respect to
the quality of product beyond the description of the goods on the face of the contract. VTI specifically disclaims the
implied warranties of merchantability and fitness for a particular purpose.
RESTRICTED RIGHTS LEGEND
Use, duplication or disclosure by the Government is subject to restrictions as set forth in subdivision (b)(3)(ii) of the
Rights in Technical Data and Computer Software clause in DFARS 252.227-7013.
VXI Technology, Inc.
2031 Main Street
Irvine, CA 92614-6509 U.S.A.
VM2601/2/3 Preface 7
www.vxitech.com
D ECLARATION OF C ONFORMITY
Declaration of Conformity According to ISO/IEC Guide 22 and EN 45014
ANUFACTURER’S NAMEVXI Technology, Inc.
M
ANUFACTURER’S ADDRESS2031 Main Street
M
Irvine, California 92614-6509
RODUCT NAME (VM2601) 80 MSa/s Digitizer & IF Receiver
P
(VM2602)(VM2603) 20 MSa/s Digitizer
ODEL NUMBER(S) VM2601/VM2602/VM2603
M
RODUCT OPTIONSAll
P
RODUCT CONFIGURATIONSAll
P
VXI Technology, Inc. declares that the aforementioned product conforms to the requirements of
the Low Voltage Directive 73/23/EEC and the EMC Directive 89/366/EEC (inclusive 93/68/EEC)
and carries the “CE” mark accordingly. The product has been designed and manufactured
according to the following specifications:
AFETYEN61010 (2001)
S
EMC EN61326 (1997 w/A1:98) Class A
CISPR 22 (1997) Class A
VCCI (April 2000) Class A
ICES-003 Class A (ANSI C63.4 1992)
AS/NZS 3548 (w/A1 & A2:97) Class A
FCC Part 15 Subpart B Class A
EN 61010-1:2001
The product was installed into a C-size VXI mainframe chassis and tested in a typical configuration.
I hereby declare that the aforementioned product has been designed to be in compliance with the relevant sections
of the specifications listed above as well as complying with all essential requirements of the Low Voltage Directive.
September 2006
40 MSa/s Digitizer
VM2601/2/3 Preface 7
Steve Mauga, QA Manager
Review the following safety precautions to avoid bodily injury and/or damage to the product.
These precautions must be observed during all phases of operation or service of this product.
Failure to comply with these precautions or with specific warnings elsewhere in this manual
violates safety standards of design, manufacture, and intended use of the product.
Service should only be performed by qualified personnel.
TERMS AND SYMBOLS
These terms may appear in this manual:
WARNING
CAUTION
These symbols may appear on the product:
VXI Technology, Inc.
GENERAL SAFETY INSTRUCTIONS
Indicates that a procedure or condition may cause bodily injury or death.
Indicates that a procedure or condition could possibly cause damage to
equipment or loss of data.
ATTENTION - Important safety instructions
WARNINGS
Frame or chassis ground
Indicates that the product was manufactured after August 13, 2005. This mark is
placed in accordance with EN 50419, Marking of electrical and electronic equipment in accordance with Article 11(2) of Directive 2002/96/EC (WEEE).
End-of-life product can be returned to VTI by obtaining an RMA number. Fees
for take-back and recycling will apply if not prohibited by national law.
Follow these precautions to avoid injury or damage to the product:
Use Proper Power Cord
Use Proper Power Source
Use Proper Fuse
To avoid hazard, only use the power cord specified for this product.
To avoid electrical overload, electric shock or fire hazard, do not
use a power source that applies other than the specified voltage.
To avoid fire hazard, only use the type and rating fuse specified for
this product.
8 VM2601/2/3 Preface
www.vxitech.com
WARNINGS (CONT.)
Avoid Electric Shock
Ground the Product
Operating Conditions
Improper Use
To avoid electric shock or fire hazard, do not operate this product
with the covers removed. Do not connect or disconnect any cable,
probes, test leads, etc. while they are connected to a voltage source.
Remove all power and unplug unit before performing any service.
Service should only be performed by qualified personnel.
This product is grounded through the grounding conductor of the
power cord. To avoid electric shock, the grounding conductor must
be connected to earth ground.
To avoid injury, electric shock or fire hazard:
- Do not operate in wet or damp conditions.
- Do not operate in an explosive atmosphere.
- Operate or store only in specified temperature range.
- Provide proper clearance for product ventilation to prevent
overheating.
- DO NOT operate if any damage to this product is suspected.
Product should be inspected or serviced only by qualified
personnel.
The operator of this instrument is advised that if the equipment is
used in a manner not specified in this manual, the protection
provided by the equipment may be impaired.
Conformity is checked by inspection.
VM2601/2/3 Preface 9
VXI Technology, Inc.
SUPPORT RESOURCES
Support resources for this product are available on the Internet and at VXI Technology customer
support centers.
VXI Technology
World Headquarters
VXI Technology, Inc.
2031 Main Street
Irvine, CA 92614-6509
Phone: (949) 955-1894
Fax: (949) 955-3041
VXI Technology
Cleveland Instrument Division
VXI Technology, Inc.
7525 Granger Road, Unit 7
Valley View, OH 44125
Phone: (216) 447-8950
Fax: (216) 447-8951
VXI Technology
Lake Stevens Instrument Division
VXI Technology, Inc.
1924 - 203 Bickford
Snohomish, WA 98290
Phone: (425) 212-2285
Fax: (425) 212-2289
Technical Support
Phone: (949) 955-1894
Fax: (949) 955-3041
E-mail:
support@vxitech.com
http://www.vxitech.com for worldwide support sites and service plan information.
Visit
10 VM2601/2/3 Preface
www.vxitech.com
A
V
V
V
SECTION 1
INTRODUCTION
OVERVIEW
The VM2601, VM2602, and VM2603 (refered to as the VM260x) modules are high-resolution,
high-speed digitizers. All three modules have Digital Storage Oscilloscope (DSO) functionality. In
addition, the VM2601 also incorporates an Intermediate Frequency Receiver (IFR) function. This
makes it ideal for applications in medical, automotive, semi-conductor, avionics, and
communication test. The VM260x modules are a message-based device with a SCPI command set
to simplify programming and configuration and register access to provide high-speed data
throughput. Each module has either an 80 MSample/s (MSa/s) (VM2601), 40 MSa/s (VM2602),
or 20 MSa/s (VM2603) ADC to support DSO applications. In addition, the DSO input can be
routed to a 10 MSa/s ADC to support DC accurate low-frequency voltage measurements. A
16 MSa memory provides ample storage for even the most demanding test program. The DSO
input features programmable impedance, ac, or dc coupling and a low-pass filter (LPF) with
programmable corner frequencies.
This module is part of the VMIP™ family of instruments and can be combined with up to two
other modules (e.g., 6.5 digit DMM, 50 MSa/s AWG, 1 ns counter/timer) to form a high-density
VXIbus instrument. Three VM2601/2/3s can be installed in a single-wide C-size module
providing three independent 80/40/20 MSa/s digitzer channels.
V
X
I
B
U
S
MIP
INTERFACE
F
IGURE 1-1:VMIP™PLATFORM
M
MIP
INSTRUMENT
MODULE #1
I
N
T
E
R
N
L
V
I
P
B
U
S
MIP
INSTRUMENT
MODULE #2
VMIP
INSTRUMENT
MODULE #3
VM2601/2/3 Introduction 11
www.vxitech.com
NOTE With the exception of sample rate and IF receiver capabilities, all three VM260x modules perform
in the same manner. The VM2601 will be referenced thoughout the manual and, when exceptions
exist, they will be noted.
DATA ACQUISITION
The input data is acquired when a conversion trigger event occurs from one of the four following
methods:
1. Trigger source from the front panel input: This input has a ±4 V input range and may be
programmed to trigger on either the rising or falling edge of this signal and at specified voltage
levels with 12-bit resolution and accurate to 1% of full scale.
2. Trigger source from the VXI TTL trigger bus: Any one of the eight TTL trigger bus lines may
be selected as the trigger source. The unit may be programmed to trigger on either the rising or
falling edge of this signal.
3. Trigger upon receipt of a word serial command: When this mode is selected, the ADC will
convert when a word-serial command is received by the instrument.
4. Trigger from the input channel: The input channel can be selected to trigger the board. It can
be programmed to trigger during a rising or falling edge and may also trigger at specified
voltage levels with 12-bit resolution and accurate to 1% of full scale.
Memory can be segmented such that sequential trigger events can be stored without forcing the
device to rearm via software or waiting for the previous samples to be offloaded. Both pre-trigger
and post-trigger samples can be acquired in up to eight segments. When the instrument is
configured for greater than eight segments, only post-trigger samples will be stored. The device
can support up to 65,536 segments. Since three VM2601 modules can be accommodated on a
single C-size VXIbus card, three differential channels can all be operating and triggering
independently. For example, one can be acquiring data while another is waiting for a trigger.
PROGRAMMING AND DATA ACCESS
As is true with most complex VXI Technology instrumentation, the VM2601give the user the
ability to access the device using the VXI message-based interface as well as utilizing direct
register access for fast data throughput. The SCPI (message based) command set is used for
instrument configuration, measurement configuration, and to query the results of the
measurements. Register access is used to transfer the raw digitizer data from the instrument to the
host. With modern host computers and interfaces, all 16 MSa can be transferred in just a few
seconds. Measurements are configured and initiated by SCPI commands from the host.
Measurement data is output in response to a query from the host. This considerably reduces test
program development and improves overall test times.
CALIBRATION
The calibration constants used to correct the data values are stored in non-volatile memory. These
constants are determined when the instrument is calibrated and can be set or queried by word
serial command. This eliminates the need for removing covers from the unit and allows for
automated calibration.
VM2601/2/3 Introduction 13
FRONT PANEL CONNECTORS
+ INPUT (J111)
Positive differential input for DSO channel (channel A+)
VXI Technology, Inc.
ACC/ERR FAIL
J105
J106
J107
J108
J109
J110
ACC/ERR FAIL
J111
J112
J113
J114
J115
J116
ACC/ERR FAIL
J117
J118
J119
J120
J121
J122
- INPUT (J112)
Negative differential input for DSO channel (channel A-)
IF INPUT (J113)
Single-ended IFR input (channel B)
NOTE This connector is covered on the VM2602 and VM2603 modules.
TRIGGER/GP0 INPUT (J114)
External Trigger Input/GP0 marker input
ARM/GP1 INPUT (J115)
External Arm Input/GP1 marker input
EXTERNAL CLOCK INPUT (J116)
External Sample Clock
Note: Front panel J designators vary with the
type(s) of module(s) installed and with the
instrument’s position in the VMIP carrier.
FIGURE 1-2:FRONT PANEL LAYOUT
14 VM2601/2/3 Introduction
www.vxitech.com
TRIG
16 bit, 10 MHz
DDR
32/64 MB
VXI BUS
SYN C T RIG
IMMED
EXT
GLUE LOGIC
14 BITS
80 MHz
ADC
FAST
TO
DIFF
+
–
SINGLE
14 BITS
ADC
1 kHz ÷ 10 MHz
SLOW
TO
DIFF
+
–
SINGLE
INPUT
SYS_ CLK
ARM
16 bit, 10 MHz
VMIP
CARRIER
VXI BUS
SYN C
EXT
IMED
REF_LVL
TRIG_LVL
OFFS ET _L VL
EXT_C LK_LVL
EXT_AR M_LVL
EXT_TRIG_LVL
SYNC_OUT
SYS_ CLK_ OUT
SYNC_ARM_O UT
SYN C_TRIG_OUT
TTL_2_LVDSLVDS TTL_2_
DC_VERTICAL
+
–
1x, 2x, 4x
LPF 1
LPF 2
+
–
DIFF T O
SINGLE
÷ 1
÷ 10
+
–
2.5X
50 Ohm
IFR (only on the VM2601)
DSO_CHnI+
150 Ω
75 Ω
50 Ω
ADJ
REFERENCE
INPUT TRIG
ADJ
DAC
OFFSET
REF_LVL
DAC
+
–
OFFSET_LVL
DAC
EXT TRIG
÷ 1
TRIG_LVL
÷ 10
+
–
150 Ω
75 Ω
50 Ω
DSO_CHnl–
EXT_TRIG
EXT_TRIG_ LVL
EXT_AR M
+
–
DAC
DAC
EXT_ARM_ IN
EXT_ARM_ LVL
SYNC_OUT
SYNC_CLK_OUT
SYNC_ARM_O UT
SYN C_TRIG_OUT
EXT_C LK
+
–
DAC
EXT_CLK_IN
EXT_CLK_LVL
SYNC_INP
SYNC_CLK_INP
SYNC_ARM_INP
SYNC_TRIG_INP
SYNC_IN
SY NC_C LK_IN
SYNC_ARM_IN
SYNC_TRIG_IN
80 MHz INT
PPL
VXI _10 MHz
VM2601/2/3 Introduction 15
F
IGURE 1-3:VM260X BLOCK DIAGRAM
VXI Technology, Inc.
GENERAL
FEATURES
• Up to 80 MHz bandwidth for DSO (no filter) and 100 MHz for IFR (VM2601 only) – ideal for HF and IF frequencies
• Up to 80 MSa/s sample rate with pre and post trigger capability
• ±0.5 V, ±1.0 V, ±2 V, ±5.0 V, ±10.0 V, and ±20 V input ranges (DSO input)
• 50 , 75 , 150 , or 1 M input impedance, with ac or dc coupling (DSO input)
• Software selectable low-pass filter (DSO input)
• Built-in pulse parameter measurements
• Up to three independent channels per C-size card
• Auto re-arm capability for storing multiple waveforms with pre-trigger data
• Sleep mode reduces power consumption when not in use
All components should be immediately inspected for damage upon receipt of the unit.
Once the VM2601 is assessed to be in good condition, it may be installed into an appropriate
C-size or D-size VXIbus chassis in any slot other than slot 0. The chassis should be checked to
ensure that it is capable of providing adequate power and cooling for the VM2601. Once the
chassis is found adequate, the VM2601’s logical address and the backplane jumpers of the chassis
should be configured before the VM2601’s installation.
CALCULATING SYSTEM POWER AND COOLING REQUIREMENTS
The power and cooling requirements of the VM2601 are given in the specification table in
Section 1 of this manual. It is imperative that the chassis provide adequate power and cooling for
this module. Referring to the chassis user manual, confirm that the power budget for the system
(the chassis and all modules installed therein) is not exceeded and that the cooling system can
provide adequate airflow at the specified backpressure.
It should be noted that if the chassis cannot provide adequate power to the module, the instrument
may not perform to specification or possibly not operate at all. In addition, if adequate cooling is
not provided, the reliability of the instrument will be jeopardized and permanent damage may
occur. Damage found to have occurred due to inadequate cooling voids the warranty on the
instrument in question.
VM2601/2/3 Preparation for Use 19
SETTING THE CHASSIS BACKPLANE JUMPERS
Please refer to the chassis user manual for further details on setting the backplane jumpers.
SETTING THE LOGICAL ADDRESS
The logical address of the VM2601 is set by a single 8-position DIP switch located near the
module’s backplane connectors (this is the only switch on the module). The switch is labeled with
positions 1 through 8 and with an ON position. A switch pushed toward the ON legend will
signify logic 1; switches pushed away from the ON legend will signify logic 0. The switch located
at position 1 is the least significant bit while the switch located at position 8 is the most significant
bit. See
Figure 2-1 for examples of setting the logical address switch.
VXI Technology, Inc.
ONON
1ON2345678
SET TO 4
ONON
12345678
SET TO 168
F
IGURE 2-1:LOGICAL ADDRESS SWITCH-SETTING EXAMPLES
1ON2345678
SET TO 8
1
2345678
SET TO 255
(Dynamic)
Switch
Position
1
2
3
4
5
6
7
8
Switch
Value
1
2
4
8
16
32
64
128
The VMIP may contain three separate instruments and will allocate logical addresses as required
by the VXIbus specification (revisions 1.3 and 1.4). The logical address of the instrument is set on
the VMIP carrier. The VMIP logical addresses must be set to an even multiple of 4 unless dynamic addressing is used. Switch positions 1 and 2 must always be set to the OFF position.
Therefore, only addresses of 4, 8, 12, 16, ... 252 are allowed. The address switch should be set for
one of these legal addresses and the address for the second instrument (the instrument in the center
position) will automatically be set to the switch set address plus one; while the third instrument
(the instrument in the lowest position) will automatically be set to the switch set address plus two.
If dynamic address configuration is desired, the address switch should be set for a value of 255 (all
switches set to ON). Upon power-up, the slot 0 resource manager will assign the first available
logical addresses to each instrument in the VMIP module.
If dynamic address configuration is desired, the address switch should be set for a value of 255.
Upon power-up, the slot 0 resource manager will assign logical addresses to each instrument in the
VMIP module.
20 VM2601/2/3 Preparation for Use
www.vxitech.com
SECTION 3
PROGRAMMING
INTRODUCTION
The VM2601 is a VXIbus message-based device whose command set is compliant with the
Standard Commands for Programmable Instruments (SCPI) programming language.
All module commands are sent over the VXIbus backplane to the module. Commands may be in
upper, lower, or mixed case. All numbers are sent in ASCII decimal unless otherwise noted.
The module recognizes SCPI commands. SCPI is a tree-structured language based on IEEE
Std 488.2 specifications. It uses the IEEE Std 488.2 Standard command and the device dependent
commands are structured to allow multiple branches off the same trunk to be used without
repeating the trunk. To use this facility, end each branch with a semicolon. For example, SLOPe
and SOURce are both branches off the TRIGger: command trunk and can be combined as
follows:
TRIGger:SLOPe <slope>;SOURce <source>
The above command is the same as these two commands:
TRIGger:SLOPe <slope>
TRIGger:SOURce <source>
See the Standard Commands for Programmable Instruments (SCPI) Manual, Volume 1: Syntax &
Style, Section 6, for more information.
The SCPI commands in this section are listed in upper and lower case. Character case is used to
indicate different forms of the same command. Keywords can have both a short form and a long
form (some commands only have one form). The short form uses just the keyword characters in
uppercase. The long form uses the keyword characters in uppercase plus the keyword characters in
lowercase. Either form is acceptable. Note that there are no intermediate forms. All characters of
the short form or all characters of the long form must be used. Short forms and long forms may be
freely intermixed. The actual commands sent can be in upper case, lower case, or mixed case (case
is only used to distinguish short and long form for the user). As an example, these commands are
all correct and all have the same effect:
The following command is not correct because it uses part of the long form of TRIGger, but not
all the characters of the long form:
:slop <slope>incorrect syntax - extra "g"
trigg
All of the SCPI commands also have a query form unless otherwise noted. Query forms contain a
question mark (?). The query form allows the system to ask what the current setting of a parameter
is. The query form of the command generally replaces the parameter with a question mark (?).
Query responses do not include the command header. This means only the parameter is returned:
no part of the command or "question" is returned.
Keywords or parameters enclosed in square brackets ([ ]) are optional. If the optional part is a
keyword, the keyword can be included or left out. Omitting an optional parameter will cause its
default to be used. If using the optional parameter, the square brackets are omitted from the
command or query.
Parameters are enclosed by angle brackets (< >). Braces ({ }) or curly brackets, are used to enclose
one or more parameters that may be included zero or more times. A vertical bar (|), read as "or," is
used to separate parameter alternatives.
22 VM2601/2/3 Programming
www.vxitech.com
APPLICATION EXAMPLES
SCPIPROGRAMMING EXAMPLE
This section contains examples of using SCPI command strings for programming the VM2601
module. The code is functional and will contain a brief description of the operation. Note, the
SCPI commands used by the VM2601 are explained in detail in
In this example, VM2601 sets the sweep points, sample clock frequency, input range, and trigger
source. It returns the average, maximum, minimum, peak-to-peak voltage, and rms voltage of the
data collected from a previous run.
SWE:POIN 32768 Sets the number of post trigger samples to
SAMP:CLOC:FREQ 1E4 Sets the sample rate to 10 kHz.
INP:RANG 20 Sets the input voltage range to ±20 V.
TRIG:SOUR IMM Sets the input trigger source to IMMediate.
INIT:IMM Puts the VM2601 into the “waiting for arm”
ARM Arms the VM2601 module immediately.
TRIG:IMM Triggers the VM2601 module immediately.
At this point, after 32,768/10,000 seconds, the samples are in the buffer and the CALCulate
commands can be executed.
CALC:VOLT:MEAN? Returns the average data value.
15.107537
CALC:VOLT:MAX? Returns the maximum data value collected.
19.234100
CALC:VOLT:MIN? Returns the minimum data value collected.
-12.693521
CALC:VOLT:PTP? Returns the peak-to-peak value starting at
13.451500 the trigger point and continuing to the end
of data collected.
CALC:VOLT:RMS? Returns the true rms value starting at the
4.653781 trigger point and continuing to the end of
the data collected.
Section 4.
32 k.
state.
VM2601/2/3 Programming 23
REGISTER ACCESS EXAMPLE
The VM2601 module provides hardware register access for fast data transfers. The register map is
shown in
In order to read the samples, execute an INITiate, ARM, TRIGger sequence as seen in the
Programming Example above. Then, use viIn16(instHndl, VI_A32_SPACE, offset, &var16bit) for
a single sample or viMoveIn16(instHndl, VI_A32_SPACE, offset, number_of_samples,
array16bit) for multiple samples.
To determine the dc voltage value of any sample:
1) Obtain the ADC gain and offset values from the instrument using the commands
2) Calculate the voltage as follows:
For example, in the 5 V range, for a sample value of 12,684, where ADC_Gain is 1.237854 and
ADC_Offset is 8183:
The VM2601 digitizer’s sample memory is mapped into the VXI A32 address space by the VISA
resource manager. When accessing the sample data through a call to viIn16() or viMoveIn16(), it
is not necessary to know the absolute address assigned to the module. VISA uses the session
handle to reference the assigned address space.
Table 3-1.
CAL:ADC:GAIN <FAST|SLOW> and CAL:ADC:OFFS? <FAST|SLOW>.
voltage
=
where ‘range’ is the current input range that has been programmed.
=
(
0.16383
()
0.16383
5.00.2237854.1818312684
×××−
=
VXI Technology, Inc.
SCPI
range2.0ADC_Gain)ADC_Offset - value ample(double)(s
×××
voltsvoltage340083.0
24 VM2601/2/3 Programming
www.vxitech.com
ABLE 3-1:A16MEMORY MAP
T
3E
3C
3A
38
36
34
32
30
2E
2C
2A
28
26
24
22
20
1E
1C
1A
18
16
14
12
10
E
C
A
8
6
4
2
0
[A32 Pointer Low]
[A32 Pointer High]
Response [/Data Extended]
Protocol [/Signal] Register
[Offset Register]
Status / Control Register
Data Low
Data High
Device Type
ID Register
VM2601/2/3 Programming 25
VXI Technology, Inc.
VXIPLUG&PLAY DRIVER EXAMPLE
This example shows how to access the instrument using the VXIplug&play driver.
iStatus = vtvm2601_initiate(instHndl); // initiate the operation
if(iStatus < VI_SUCCESS) return(iStatus);
iStatus = vtvm2601_cmdArmImme(instHndl);
if(iStatus < VI_SUCCESS) return(iStatus);
lclDelay((double)ptrgCnt / sampleRate); // WAIT at least long enough for pre-trig
iStatus = vtvm2601_cmdTrigImme(instHndl);
if(iStatus < VI_SUCCESS) return(iStatus);
lclDelay((double)sampleCount / sampleRate); // WAIT at least long enough for samples
iStatus = vtvm2601_abort(instHndl); // ready or not, abort the operation!
if(iStatus < VI_SUCCESS) return(iStatus);
if(daqState != vtvm2601_DAS_IDLE) // didn't make it to idle, data not ready!
return(vtvm2601_ERR_NOT_READY);
segNmbr = 0; // segment number = 0, use the first segment
ramOffs = 0; // ram offset = 0, first sample from the trigger point
// Now, get the samples!
iStatus = vtvm2601_a32Fetch(instHndl, segNmbr, ramOffs, sampleCount, dPointer);
return(iStatus);
}
VM2601/2/3 Programming 27
VXI Technology, Inc.
28 VM2601/2/3 Programming
www.vxitech.com
SECTION 4
COMMAND DICTIONARY
INTRODUCTION
This section presents the instrument command set. It begins with an alphabetical list of all the
commands supported by the VM2601 divided into three sections: IEEE 488.2 commands, the
instrument specific SCPI commands, and the required SCPI commands. Each command provides
a brief description of the command’s function, whether the command’s value is affected by the
*RST command, and, if applicable, its *RST value.
The remainder of this section is devoted to describing each command, one per page, in detail. The
description is presented in a regular and systematic manner, assisting the user in the use of each
command. Every command entry describes the exact command and query syntax, the use and
range of parameters, and a complete description of the command’s purpose.
ALPHABETICAL COMMAND LISTING
The following tables provide an alphabetical listing of each command supported by the VM2601
along with a brief description. If an X is found in the column titled *RST, then the value or setting
controlled by this command is possibly changed by the execution of the *RST command. If no X
is found, then *RST has no effect. The *RST column gives the value of each command’s setting
when the unit is powered up or when an *RST command is executed.
Clears the Status Register N/A
Sets the Event Status Enable Register N/A
Query the Standard Event Status Register N/A
Query the module identification string N/A
Set the OPC bit in the Event Status Register N/A
Resets the module to a known state N/A
Set the Service Request Enable Register N/A
Query the Status Byte Register N/A
Causes a trigger event to occur N/A
Starts and reports a self-test procedure N/A
Halts execution of commands and queries N/A
Disarms the VM2601 and stops data sampling. N/A
Enables or disables automatic advancing to the next
buffer and rearming.
X OFF
Sets the comparator level of the Arm Signal. X 0.0
Specifies the slope of the Arm Signal. X POS
Sets the Arm Source. X IMMediate
Query returns whether or not the VM2601 is armed.
Advances to the next buffer and arms the unit. N/A
Instructs the device to return the fall time
measurement for the acquired data.
Query that instructs the device to return the
frequency of the digitized data.
Instructs the device to calculate and return the
negative duty cycle for the acquired data.
Returns the negative pulse width measurement for
the acquired data.
Instructs the device to calculate and return the
positive duty cycle for the acquired data.
Returns the negative overshoot as percent of
amplitude
Returns the negative preshoot as percent of
amplitude
Returns the negative ringing as percent of amplitude
Returns the positive overshoot as percent of
amplitude
Returns the positive preshoot as percent of amplitude
Returns the positive ringing as percent of amplitude
Returns the period measurement for the acquired
data.
Query that returns a positive pulse width
measurement.
Returns the rise-time measurement for the acquired
data.
Returns the amplitude measurement for the data
being acquired.
Returns the high voltage value for the acquired data.
Returns the low voltage value for the acquired data.
Returns the maximum voltage value for the acquired
data.
Returns the mean voltage value for the acquired data.
Returns the minimum voltage value for the acquired
data.
Returns the negative overshoot value for the acquired
data.
Returns the negative preshoot value for the acquired
data.
Returns the negative ringing as peak-to-peak volts
Returns the positive overshoot value for the acquired
data.
Returns the positive preshoot value for the acquired
data.
Returns the positive ringing as peak-to-peak volts
Returns the peak-to-peak voltage value for the
acquired data.
Returns the root-mean-square (rms) voltage value of
the data being acquired.
To provide an ADC gain factor for measurement
compensation.
To provide an ADC offset value for measurement
compensation.
Tracks the number of times calibration memory has
been written.
To set the calibration factor that compensates for
DAC gain inaccuracies.
To set the calibration factor that compensates for
DAC offset inaccuracies.
1.000
8192
1.000 or
Cal Value
2047 or
Cal Value
Sets all calibration factors to their default values.
Resets all calibration factors to the values stored in
the non-volatile memory (EEPROM).
Sets the code required to disable calibration security.
Enable or disable calibration security. X ON
Stores calibration data into non-volatile memory.
Sets a marker for specified events allowing for easy
reference after acquisition is complete.
X GND
Selects between the fast and slow ADCs. X FAST
Defines the fall time parameters that will govern
corresponding CALCulate and MEASure commands.
Defines the frequency parameters that will govern
corresponding CALCulate and MEASure commands.
Sets the sample period for the ADC X 100.0 ns
Defines the negative duty cycle parameters that will
govern corresponding CALCulate and MEASure
commands.
Defines the negative pulse width parameters that will
govern corresponding CALCulate and MEASure
commands.
Defines the positive duty cycle parameters that will
govern corresponding CALCulate and MEASure
commands.
configure to measure negative overshoot as percent
of amplitude
configure to measure negative preshoot as percent of
amplitude
configure to measure negative ringing as percent of
amplitude
configure to measure positive overshoot as percent of
amplitude
configure to measure positive preshoot as percent of
amplitude
configure to measure positive ringing as percent of
amplitude
Defines the period parameters that will govern
corresponding CALCulate and MEASure commands.
Defines the positive pulse width parameters that will
govern corresponding CALCulate and MEASure
commands.
Defines the rise time parameters that will govern
corresponding CALCulate and MEASure commands.
configure the Signal Aberration Region size in
seconds
query the Signal Aberration Region size
Defines the amplitude parameters that will govern
corresponding CALCulate and MEASure commands.
Defines the high voltage parameters that will govern
corresponding CALCulate and MEASure commands.
Defines the low voltage parameters that will govern
corresponding CALCulate and MEASure commands.
Defines the maximum voltage parameters that will
govern corresponding CALCulate and MEASure
commands.
Defines the mean voltage parameters that will govern
corresponding CALCulate and MEASure commands.
Defines the minimum voltage parameters that will
govern corresponding CALCulate and MEASure
commands.
Defines the negative overshoot parameters that will
govern corresponding CALCulate and MEASure
commands.
Defines the negative preshoot parameters that will
govern corresponding CALCulate and MEASure
commands.
configure to measure negative ringing as peak-topeak volts
Defines the positive overshoot parameters that will
govern corresponding CALCulate and MEASure
commands.
Defines the positive preshoot parameters that will
govern corresponding CALCulate and MEASure
commands.
configure to measure positive ringing as peak-topeak volts
Defines the peak-to-peak voltage parameters that
will govern corresponding CALCulate and MEASure
commands.
Defines the root-mean-square voltage parameters
that will govern corresponding CALCulate and
MEASure commands.
Outputs the current measurement configuration.
This command applies power to or removes power
from the instrument.
Retrieves the measurements taken by the INITiate
command and places it in the output buffer.
X ON
Set the pre-trigger sample count. X 1024
Arms the VM2601 upon receipt of the command.
Selects ac or dc coupling on the specified input
channel.
Selects the low-pass filter corner frequency for the
specified channel.
For the specified input channel, turns the currently
selected low-pass filter ON or OFF.
Sets the input impedance for the selected input
channel.
This command allows the user to compensate for
input signal offset.
Sets the input range to ±0.5 V, ±1.0 V, ±2.0 V,
±5.0 V, ±10.0 V, or ±20.0 V full scale
Select the input source, single-ended IFR or
differential DSO.
Performs a sequence of commands to provide a fall
time measurement for the input.
Performs a sequence of commands to provide a
frequency measurement for the input.
Performs a sequence of commands to provide the
negative duty cycle measurement for the input.
Performs a sequence of commands to provide a
negative pulse width measurement for the input.
Performs a sequence of commands to provide a
positive duty cycle measurement for the input.
X 20e6 Hz
X OFF
X High
X 0.0
X 20.0 V
X DSO
measure negative overshoot as percent of amplitude
measure negative preshoot as percent of amplitude
measure negative ringing as percent of amplitude
measure positive overshoot as percent of amplitude
measure positive preshoot as percent of amplitude
measure positive ringing as percent of amplitude
Performs a sequence of commands to provide a
period measurement for the input.
Performs a sequence of commands to provide a
positive pulse width measurement for the input.
Performs a sequence of commands to provide a rise
time measurement for the input.
Performs a sequence of commands to provide an
amplitude measurement for the acquired data.
Performs a sequence of commands to provide the
high voltage value for the acquired data.
Performs a sequence of commands to provide the
low voltage value for the acquired data.
Performs a sequence of commands to provide the
maximum voltage value for the acquired data.
Performs a sequence of commands to provide the
mean voltage value for the acquired data.
Performs a sequence of commands to provide the
minimum volgage value for the acquired data.
Performs a sequence of commands to provide the
negative overshoot value for the acquired data.
Performs a sequence of commands to provide the
negative preshoot value for the acquired data.
measure negative ringing as peak-to-peak volts
Performs a sequence of commands to provide the
positive overshoot value for the acquired data
Performs a sequence of commands to provide the
positive preshoot value for the acquired data.
measure positive ringing as peak-to-peak volts
Performs a sequence of commands to provide the
peak-to-peak voltage value for the acquired data.
Performs a sequence of commands to provide the
root-mean-square value for the acquired data.
Initiates, arms, triggers, and fetches a previously
configured measurement.
Sets the reference oscillator frequency. X 10 MHz
Selects the reference oscillator source. X BUS
Outputs the selected sample clock frequency. X 10 MHz
Selects the sample clock source. X INTernal
Set the number of segments. X 1
Set the post-trigger sample count. X 1024
This command sets the sample rate for the ADC. X 100 ns (Fast)
Sets the instrument to function as a synchronized
master or slave.
X OFF
Enables/disables synchronization operations. X OFF
Sets the comparator level of the trigger signal. X 0.0 V
Specifies the slope of the Trigger Signal for the
VM2601.
X POS
Selects the source for triggering the VM2601. X IMMediate
Query returns whether or not the VM2601 has been
triggered.
X 0
Triggers the instrument on receipt of the command.
Queries the Operation Status Condition
Register.
Sets the Operation Status Enable
Register.
Queries the Operation Status Event
Register.
Presets the Status Register. N/A
Queries the Questionable Status
Condition Register.
Sets the Questionable Status Enable
Register.
Queries the Questionable Status Event
Register.
Queries the Error Queue. X Clears queue
Queries which version of the SCPI
standard the module complies with.
VXI Technology, Inc.
N/A
N/A
N/A
N/A
N/A
N/A
N/A
36 VM2601/2/3 Command Dictionary
www.vxitech.com
COMMAND DICTIONARY
The remainder of this section is devoted to the actual command dictionary. Each command is fully
described on its own page. In defining how each command is used, the following items are
described:
Purpose
Type
Command Syntax
Command Parameters
Reset Value
Query Syntax
Query Parameters
Query Response
Description
Examples
Related Commands
Describes the purpose of the command.
Describes the type of command such as an event or setting.
Details the exact command format.
Describes the parameters sent with the command and their legal range.
Describes the values assumed when the *RST command is sent.
Details the exact query form of the command.
Describes the parameters sent with the command and their legal range. The default
parameter values are assumed the same as in the command form unless described
otherwise.
Describes the format of the query response and the valid range of output.
Describes in detail what the command does and refers to additional sources.
Present the proper use of each command and its query (when available).
Lists commands that affect the use of this command or commands that are affected
by this command.
VM2601/2/3 Command Dictionary 37
COMMON SCPICOMMANDS
*CLS
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Clears all status and event registers.
IEEE 488.2 Common Command
*CLS
None
N/A
None
N/A
N/A
This command clears the Status Event Register, Operation Status Register, and the
Questionable Data/Signal Register. It also clears the Operation Complete flag and
clears all queues (except the output queue).
Examples Command / Query Response (Description)
Related Commands
*CLS
N/A
(Clears all status and event registers)
38 VM2601/2/3 Command Dictionary
www.vxitech.com
*ESE
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Sets the bits of the Event Status Enable Register.
IEEE 488.2 Common Command
*ESE <mask>
<mask> = numeric ASCII value
N/A, the parameter is required
*ESE?
N/A
Numeric ASCII value from 0 to 255
The Event Status Enable (ESE) command is used to set the bits of the Event Status
Enable Register. See ANSI/IEEE 488.2-1987 section 11.5.1 for a complete
description of the ESE register. A value of 1 in a bit position of the ESE register
enables generation of the Event Status Bit (ESB) in the Status Byte by the
corresponding bit in the Event Status Register (ESR). If the ESB is set in the Service
Request Enable (SRE) register, then an interrupt will be generated. See the
query for details regarding the individual bits. The ESE register layout is:
Bit 0 - Operation Complete
Bit 1 - Request Control
Bit 2 - Query Error
Bit 3 - Device Dependent Error
Bit 4 - Execution Error
Bit 5 - Command Error
Bit 6 - User Request
Bit 7 - Power On
The Event Status Enable query reports the current contents of the Event Status
Enable Register.
*ESE 36
*ESE?
*ESR?
36 (Returns the value of the event status enable register)
*ESR?
VM2601/2/3 Command Dictionary 39
*ESR?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Queries and clears the Standard Event Status Register.
IEEE 488.2 Common Command
None
N/A
N/A
*ESR?
None
Numeric ASCII value from 0 to 255
The Event Status Register (ESR) query - queries and clears the contents of the
Standard Event Status Register. This register is used in conjunction with the ESE
register to generate the Event Status Bit (ESB) in the Status Byte. The layout of the
ESR is:
Bit 0 - Operation Complete
Bit 1 - Request Control
Bit 2 - Query Error
Bit 3 - Device Dependent Error
Bit 4 - Execution Error
Bit 5 - Command Error
Bit 6 - User Request
Bit 7 - Power On
The Operation Complete bit is set when it receives an *OPC command.
The Query Error bit is set when data is over-written in the output queue. This could
occur if one query is followed by another without reading the data from the first query.
The Execution Error bit is set when an execution error is detected. Errors that range
from -200 to -299 are execution errors.
The Command Error bit is set when a command error is detected. Errors that range
from -100 to -199 are command errors.
The Power On bit is set when the module is first powered on or after it receives a reset
via the VXI Control Register. Once the bit is cleared (by executing the *ESR?
command) it will remain cleared.
*ESR?
*ESE
4
40 VM2601/2/3 Command Dictionary
www.vxitech.com
*IDN?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Queries the module for its identification string.
IEEE 488.2 Common Command
None
N/A
N/A
*IDN?
None
ASCII character string
The Identification (IDN) query returns the identification string of the module. The
response is divided into four fields separated by commas. The first field is the
manufacturer’s name, the second field is the model number, the third field is an
optional serial number, and the fourth field is the firmware revision number. If a serial
number is not supplied, the third field is set to 0 (zero).
Examples Command / Query Response (Description)
Related Commands
*IDN?
N/A
VXI Technology, Inc.,VM2601,0,1.0
(The revision listed here is for reference only;
the response will always be the current revision
of the instrument.)
VM2601/2/3 Command Dictionary 41
*OPC
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Sets the OPC bit in the Event Status Register.
IEEE 488.2 Common Command
*OPC
None
N/A
*OPC?
None
1
The Operation Complete (OPC) command sets the OPC bit in the Event Status
Register when all pending operations have completed. The OPC query will return a 1
to the output queue when all pending operations have completed.
Examples Command / Query Response (Description)
Related Commands
*OPC
*OPC?
*WAI
(Sets the OPC bit in the Event Status Register)
1 (Returns the value of the Event Status Register)
42 VM2601/2/3 Command Dictionary
www.vxitech.com
*RST
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Resets the module’s hardware and software to a known state.
IEEE 488.2 Common Command
*RST
None
N/A
None
N/A
N/A
The Reset (RST) command resets the module’s hardware and software to a known
state. See the
default parameter values used with this command.
Alphabetical Command Listing at the beginning of this chapter for the
Examples Command / Query Response (Description)
Related Commands
*RST
N/A
(Resets the module)
VM2601/2/3 Command Dictionary 43
*SRE
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Sets the service request enable register.
IEEE 488.2 Common Command
*SRE <mask>
<mask> = Numeric ASCII value from 0 to 255
TBD
*SRE?
None
Numeric ASCII value from 0 to 255
The Service Request Enable (SRE) mask is used to control which bits in the status byte
generate back plane interrupts. If a bit is set in the mask that newly enables a bit set in
the status byte and interrupts are enabled, the module will generate a REQUEST
TRUE event via an interrupt. See the
Note:
Bit 6 is always internally cleared to zero as required by IEEE 488.2 section 11.3.2.3.
The layout of the Service Request Enable Register is:
Bit 0 - Unused
Bit 1 - Unused
Bit 2 - Error Queue Has Data
Bit 3 - Questionable Status Summary (Not Used)
Bit 4 - Message Available
Bit 5 - Event Status Summary
Bit 6 - 0 (per IEEE 488.2 section 11.3.2.3)
Bit 7 - Operation Status Summary
*SRE 4
*SRE?
N/A
*STB? query for the layout of bits.
(Sets the service request enable register)
4 (Returns the value of the SRE register)
44 VM2601/2/3 Command Dictionary
www.vxitech.com
*STB?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Queries the Status Byte Register.
IEEE 488.2 Common Command
None
N/A
N/A
*STB?
None
Numeric ASCII value from 0 to 255
The Read Status Byte (STB) query fetches the current contents of the Status Byte
Register. See the IEEE 488.2 specification for additional information regarding the
Status byte Register and its use. The layout of the Status Register is:
Bit 0 - Unused
Bit 1 - Unused
Bit 2 - Error Queue Has Data
Bit 4 - Questionable Status Summary (not used)
Bit 5 - Message Available
Bit 6 - Master Summary Status
Bit 7 - Operation Status Summary
*STB?
N/A
16 (Queries the Status Byte Register)
VM2601/2/3 Command Dictionary 45
*TRG
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Causes a trigger event to occur.
IEEE 488.2 Common Command
*TRG
None
N/A
None
N/A
N/A
The Trigger command causes a trigger event to occur.
Examples Command / Query Response (Description)
Related Commands
*TRG
N/A
(Triggers an event)
46 VM2601/2/3 Command Dictionary
www.vxitech.com
*TST?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Causes a self-test procedure to occur and queries the results.
IEEE 488.2 Common Command
None
N/A
N/A
*TST?
N/A
Numeric ASCII value from 0 to 1.
Initiates the digitizer self-test operation. If the test fails, an error message is placed in
the error queue and then the error LED blinks. The self test tests the following:
0 = Passed
1 = Failed sample RAM test
Examples Command / Query Response (Description)
Related Commands
*TST?
N/A
0 (Begins the self-test procedure returns the result)
VM2601/2/3 Command Dictionary 47
*WAI
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Halts execution of additional commands and queries until the No Operation Pending
message is true.
IEEE 488.2 Common Command
*WAI
None
N/A
None
N/A
N/A
The Wait to Continue command halts the execution of commands and queries until the
No Operation Pending message is true. This command makes sure that all previous
commands have been executed before proceeding. It provides a way of synchronizing
the module with its commander.
Examples Command / Query Response (Description)
Related Commands
*WAI
*OPC
(Pauses the execution of additional commands
until the No Operation Pending message is true.)
48 VM2601/2/3 Command Dictionary
www.vxitech.com
INSTRUMENT SPECIFIC SCPICOMMANDS
ABORt
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Aborts any active measurement process.
Event
ABORt
None
N/A
None
N/A
N/A
The Abort command disarms the VM2601 and stops data sampling (if active).
Examples Command / Query Response (Description)
Related Commands
ABOR
INITiate[:IMMediate]
(Stops data sampling and disarms the module)
VM2601/2/3 Command Dictionary 49
ARM:AUTO
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Enables or disables the automatic rearm process.
Command
ARM:AUTO <boolean>
<boolean> = 0 | 1 | OFF | ON
OFF
ARM:AUTO?
None
Returns the value currently selected for the <boolean> parameter
This command enables or disables the automatic re-arm process. This applies to multiple
segment acquisitions only (see
an example, assume that the VM2601 is configured for 64 segments, auto-rearm is
enabled, the input trigger source is selected, and the input signal is a repetetive pulse
burst with a duration of [0.1 * (sample rate * number of samples)] occurring at random
intervals. If an “INIT” command is sent followed by an “ARM” command, it will set up
the instrument to acquire a “snapshot” of each burst, which is triggered by the input
signal, and each “snapshot” will be stored in separate segment. If auto-rearm were
disabled, it would be necessary to rearm the instrument between bursts with an external
signal or a software command.
ARM:AUTO 1
ARM:AUTO?
ARM
ARM:IMMediate
ARM:LEVel
ARM:SLOPe
ARM:SOURce
SWEep:COUNt
SWEep:COUNt for more information on segments). As
(Enables the automatic rearm process.)
1 (Indicates that the automatic rearm process is enabled.)
50 VM2601/2/3 Command Dictionary
www.vxitech.com
ARM[:IMMediate]
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Arms the instrument on receipt of the command.
Command
ARM[:IMMediate]
None
N/A
None
N/A
N/A
Arms the instrument on receipt of the command and puts the device into Waiting For
Trigger mode.
Examples Command / Query Response (Description)
Related Commands
ARM:IMM
ARM
ARM:LEVel
ARM:SLOPe
ARM:SOURce
(Arms VM2601)
VM2601/2/3 Command Dictionary 51
ARM:LEVel
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Sets the level at which the instrument will be armed (external input).
Command
ARM:LEVel <arm_level>
<arm_level> = -4 V to +4 V
<arm_level> = 0.0
ARM:LEVel?
None
Returns the value currently set for the <arm_level> parameter.
Sets the level at which the instrument will be armed by a signal present at the ARM/GP1
input, assuming that ARM:SOURce EXT has been selected. The range is approximately
±4 V.
Examples Command / Query Response (Description)
Related Commands
ARM:LEV 2.56
ARM
ARM:IMMediate
ARM:SLOPe
ARM:SOURce
(Sets the comparator level to 2.56 V)
52 VM2601/2/3 Command Dictionary
www.vxitech.com
ARM:SLOPe
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Specifies the slope of the arm signal.
Command
ARM:SLOPe <arm_slope>
<arm_slope> = POSitive | NEGative
<arm_slope> = POSitive
ARM:SLOPe?
None
POS | NEG
Specifies the slope of the arm signal when the arm source is set to EXTernal or TTL.
Examples Command / Query Response (Description)
Related Commands
ARM:SLOP NEG
ARM:SLOP?
ARM
ARM:IMMediate
ARM:LEVel
ARM:SOURce
(Sets the VM2601 to arm on a negative slope.)
NEG (Indicates that the VM2601 will arm on a
negative slope.)
TTLT3 (Indicates that the arm source is the
TTLT3 line.)
54 VM2601/2/3 Command Dictionary
www.vxitech.com
olta
g
)
CALCulate:FALL:TIMe
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that instructs the device to calculate and return fall time measurement.
Query
None
N/A
N/A
CALCulate:FALL:TIMe? or
CALCultate:FTIMe?
None
ASCII number representing fall-time measurement
The CALCulate:FALL:TIME query instructs the instrument to calculate and return the
amount of time it takes a signal to make a negative transition from the high reference to
the low reference. The high reference defaults to 90% of the signal amplitude, and the
low reference defaults to 10% of the signal amplitude.
1.0
0.8
90% referenc e
0.6
e (V
v
0.4
0.2
20
681012141618
4
time ( s)µ
Fall
Time
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:FTIM?
CONFigure:FALL:TIMe
(Returns the fall time measurement.)
MEASure:FALL:TIMe
10% referenc e
20
VM2601/2/3 Command Dictionary 55
CALCulate:FREQuency?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that instructs the device to calculate and return the frequency of the digitized data.
Query
None
N/A
N/A
CALCulate:FREQuency?
None
ASCII number representing frequency measurement in Hz.
The CALCulate:FREQuency query instructs the device to calculate and return the
frequency of the digitized data. Frequency (f) is a measure of how many times a signal
repeats in one second (1/s = Hz). This is also equal to 1/period (or 1/T).
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:FREQ?
CONFigure:FREQuency
MEASure:FREQuency
(Returns the frequency measurement.)
56 VM2601/2/3 Command Dictionary
www.vxitech.com
CALCulate:NDUTy?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that instructs the device to calculate and return the negative duty cycle.
Query
None
N/A
N/A
CALCulate:NDUTy?
None
ASCII number representing negative duty cycle measurement as a percentage
The CALCulateNDUTy query instructs the device to calculate and return the negative
duty cycle of the digitized data. The negative duty cycle is defined as the negative pulse
width divided by the period and is expressed as a percentage.
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:NDUT?
CONFigure:NDUTy
MEASure:NDUTy
(Returns the negative duty cycle measurement.)
VM2601/2/3 Command Dictionary 57
CALCulate:NWIDth?
o
g
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that returns a negative pulse width measurement.
Query
None
N/A
N/A
CALCulate:PWIDth?
None
ASCII number representing a negative pulse width measurement in seconds.
The CALCulate:NWIDth query instructs the devuce to calculate and return a negative
pulse width measurement. The negative pulse width is a measure of the time required to
go from the 50% reference of the falling edge of one wave to the 50% reference of the
rising edge on the next wave on a negative pulse.
1.0
0.8
0.6
e (V)
20
50% referenc e
4
Negative
Pulse
Width
681012141618
time ( s)µ
lta
v
0.4
0.2
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PWID?
(Returns the positive pulse width
measurement.)
Related Commands
CONFigure:NWIDth
MEASure:NWIDth
20
58 VM2601/2/3 Command Dictionary
www.vxitech.com
CALCulate:PDUTy?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that instructs the device to calculate and return the positive duty cycle.
Query
None
N/A
N/A
CALCulate:PDUTy?
None
ASCII number representing positive duty cycle measurement as a percentage.
The CALCulate:PDUTy query instructs the device to calculate and return the positive
duty cycle of the digitized data. The positive duty cycle is defined as the positive pulse
width divided by the period and is expressed as a percentage.
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:PDUT?
CONFigure:PDUTy
MEASure:PDUTy
(Returns the positive duty cycle measurement.)
VM2601/2/3 Command Dictionary 59
CALCulate:PERCent:NOVershoot?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the negative overshoot as a percent of the signal amplitude.
Query
None
N/A
N/A
CALCulate: PERCent:NOVershoot?
None
ASCII value representing a voltage measurement.
The CALCulate:PERCent:NOVershoot query instructs the device to calculate and return
the value corresponding to the negative overshoot as a percentage of the signal
amplitude from the selected input range. The negative overshoot is defined as the
amount of voltage by which a post-transitional aberration negatively exceeds a state
boundary.
1.0
0.8
0.6
Amplitude
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
Negative Overshoot
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PERC:NOV?
(Returns the negative overshoot voltage as a
percentage of the signal amplitude.)
Related Commands
CONFigure:PERC:NOV
MEASure:PERC:NOV
20
60 VM2601/2/3 Command Dictionary
www.vxitech.com
CALCulate:PERCent:NPReshoot?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the negative preshoot value for the acquired data as a percent of the signal
amplitude.
Query
None
N/A
N/A
CALCulate:PERCent:NPReshoot?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:PERCent:NPReshoot query instructs the device to calculate and return a
voltage value corresponding to the negative preshoot from the selected input range. The
negative preshoot is defined as the amount of voltage by which a pre-transitional
aberration negatively exceeds a state boundary.
1.0
0.8
0.6
Negative Preshoot
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
Amplitude
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PERC:NPR?
(Returns the negative pershoot value as a
percent of the signal amplitude.)
Related Commands
CONFigure:PERC:NPR
MEASure:PERC:NPR
20
VM2601/2/3 Command Dictionary 61
CALCulate:PERCent:NRINging?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the negative ringing as a percent of the signal amplitude.
Query
None
N/A
N/A
CALCulate:PERCent:NRINging?
None
ASCII value representing a voltage measurement.
The CALCulate:PERCent:NRINGing query instructs the device to calculate and return a
value corresponding to the negative ringing of an signal on the selected input range as a
percent of the signal amplitude. Negative ringing is defined as the peak-to-peak voltage
of a negative post-transitional aberration.
1.0
0.8
0.6
voltage (V)
0.4
0.2
0
Negative
Ringing
2
681012141618
4
time ( s)µ
Amplitude
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PERC:NRIN?
(Returns the negative ringing value as a
percent of the signal amplitude.)
Related Commands
CONFigure:PERC:NRIN
MEASure:PERC:NRIN
20
62 VM2601/2/3 Command Dictionary
www.vxitech.com
CALCulate:PERCent:POVershoot?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the positive overshoot value for the acquired data as a percent of the signal
amplitude.
Query
None
N/A
N/A
CALCulate:PERCent:POVershoot?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:PERCent:POVershoot query instructs the device to calculate and return
a voltage value corresponding to the positive overshoot from the selected input range as
a percent of the signal amplitude. The positive overshoot is defined as the amount of
voltage by which a post-transitional aberration positively exceeds the state boundary.
1.0
Positive Overshoot
0.8
0.6
Amplitude
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PERC:POV?
(Returns the positive overshoot as a percent of
the signal amplitude.)
Related Commands
CONFigure:PERC:POV
MEASure:PERC:POV
20
VM2601/2/3 Command Dictionary 63
CALCulate:PERCent:PPReshoot?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the positive preshoot value for the aquried data as a percent of the signal
amplitude.
Query
None
N/A
N/A
CALCulate:PERCent:PPReshoot?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:PERCent:PPReshoot query instructs the device to calculate and return a
voltage value corresponding to the positive preshoot from the selected input range as a
percent of the signal amplitude. The positive preshoot is defined as the amount of
voltage by which a pre-transitional aberration positively exceeds the state boundary.
1.0
0.8
Positive Preshoot
0.6
Amplitude
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PERC:PPR?
(Returns the positive preshoot measurement as
a percent of the signal amplitude.)
Related Commands
CONFigure:PERC:PPR
MEASure:PERC:PPR
20
64 VM2601/2/3 Command Dictionary
www.vxitech.com
CALCulate:PERCent:PRINging?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the positive ringing as a percent of the signal amplitude.
Query
None
N/A
N/A
CALCulate:PERCent:PRINging?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:PERCent:PRINGing query instructs the device to calculate and return a
value corresponding to the negative ringing of an signal on the selected input range as a
percent of the signal amplitude. The CALCulate:VOLTage:PRINGing query instructs
the device to calculate and return a value corresponding to the positive ringing of an
signal on the selected input range. Positive ringing is defined as the peak-to-peak voltage
of a positive post-transitional aberration.
1.0
Positive
0.8
Ringing
0.6
Amplitude
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PERC:PRIN?
(Returns the positive ringing value as a percent
of the signal amplitude.)
Related Commands
CONFigure:PERC:PRIN
MEASure: PERC:PRIN
20
VM2601/2/3 Command Dictionary 65
CALCulate:PERiod?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that returns a period measurement from the device.
Query
None
N/A
N/A
CALCulate:PERiod?
None
ASCII number representing a period measurement in seconds.
Query that returns a period measurement from the device. The period (T) is defined as
the amount of time required for the signal to generate one signal cycle. This is also
defined as 1/frequency (or 1/f).
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:PER?
CONFigure:PERiod
MEASure:PERiod
(Returns the period measurement.)
66 VM2601/2/3 Command Dictionary
www.vxitech.com
o
g
CALCulate:PWIDth?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that returns a positive pulse width measurement.
Query
None
N/A
N/A
CALCulate:PWIDth?
None
ASCII number representing a positive pulse width measurement in seconds.
The CALCulate:PWIDth query returns a positive pulse width measurement. The positive
pulse width is a measure of the time required to go from the 50% reference of the rising
edge of one wave to the 50% reference of the next falling edge.
1.0
0.8
0.6
e (V)
lta
v
0.4
0.2
50% referenc e
Positive
Pulse
Width
20
681012141618
4
time ( s)µ
20
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:PWID?
(Returns the positive pulse width
measurement.)
Related Commands
CONFigure:FREQuency
MEASure:PWIDth
VM2601/2/3 Command Dictionary 67
CALCulate:RISE:TIMe?
olta
g
)
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Query that returns a rise-time measurement.
Query
None
N/A
N/A
CALCulate:RISE:TIMe? or
CALCulate:RTIMe?
None
ASCII number representing a rise time measurement in seconds.
The CALCulate:RISE:TIME query instructs the instrument to calculate and return the
amount of time it takes a signal to make a positive transition from the low reference to
the high reference. The high reference defaults to 90% of the signal amplitude, and the
low reference defaults to 10% of the signal amplitude.
1.0
90% referenc e
0.8
0.6
e (V
v
0.4
0.2
10% ref erence
20
Rise
Time
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:RISE:TIM?
CONFigure:RISE:TIMe
(Returns the rise time measurement.)
MEASure:RISE:TIMe
20
68 VM2601/2/3 Command Dictionary
www.vxitech.com
o
g
CALCulate:VOLTage:AMPLitude?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the amplitude measurement for the data being acquired.
Query
None
N/A
N/A
CALCulate:VOLTage:AMPLitude?
None
ASCII value representing a voltage amplitude measurement in volts.
The CALCulate:VOLTage:AMPlitude query instructs the device to calculate and return
an amplitude measurement for the data being acquired. Amplitude is defined as the
voltage difference between the high and low states.
1.0
0.8
0.6
e (V)
lta
v
0.4
Amplitude
0.2
20
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:AMPL?
CONFigure:VOLTage:AMPLitude
(Returns the voltage amplitude measurement.)
MEASure: VOLTage:AMPLitude
20
VM2601/2/3 Command Dictionary 69
CALCulate:VOLTage:HIGH?
o
g
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the high voltage value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:HIGH?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:HIGH query instructs the device to calculate and return a
voltage value from the data representing the high state.
1.0
0.8
0.6
e (V)
lta
v
0.4
High
0.2
20
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:HIGH?
CONFigure:VOLTage:HIGH
(Returns the high input voltage value.)
MEASure:VOLTage:HIGH
20
70 VM2601/2/3 Command Dictionary
www.vxitech.com
o
g
CALCulate:VOLTage:LOW?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the low voltage value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:LOW?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:LOW query instructs the device to calculate and return a
voltage value from the data representing the low state.
1.0
0.8
0.6
e (V)
lta
v
0.4
Low
0.2
20
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:LOW?
CONFigure:VOLTage:LOW
(Returns the low input voltage value.)
MEASure: VOLTage:LOW
20
VM2601/2/3 Command Dictionary 71
CALCulate:VOLTage:MAXimum?
o
g
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the maximum voltage value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:MAXimum?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:MAXimum query instructs the device to calculate and return
a maximum voltage value from the acquired data set.
1.0
0.8
0.6
e (V)
lta
v
0.4
Maximum
0.2
20
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Returns the mean voltage value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:MEAN?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:MEAN query instructs the device to calculate and return the
mean (average) voltage value from the acquired data set.
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:MEAN?
CONFigure:VOLTage:MEAN
MEASure: VOLTage:MEAN
VM2601/2/3 Command Dictionary 73
CALCulate:VOLTage:MINimum?
o
g
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the minimum voltage value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:MINimum?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:MINimum query instructs the device to calculate and return
a minimum voltage value from the acquired data set.
1.0
0.8
0.6
e (V)
lta
v
0.4
0.2
Minimum
20
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Returns the negative overshoot value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:NOVershoot?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:NOVershoot query instructs the device to calculate and
return the voltage value corresponding to the negative overshoot from the selected input
range. The negative overshoot is defined as the amount of voltage by which a posttransitional aberration negatively exceeds a state boundary.
1.0
0.8
0.6
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
Negative Overshoot
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:NOV?
CONFigure:VOLTage:NOVershoot
(Returns the voltage of the negative overshoot.)
MEASure: VOLTage:NOVershoot
20
VM2601/2/3 Command Dictionary 75
CALCulate:VOLTage:NPReshoot?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the negative preshoot value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:NPReshoot?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:NPReshoot query instructs the device to calculate and return
a voltage value corresponding to the negative preshoot from the selected input range.
The negative preshoot is defined as the amount of voltage by which a pre-transitional
aberration negatively exceeds a state boundary.
1.0
0.8
0.6
Negative Preshoot
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:NPR?
CONFigure:VOLTage:NPReshoot
(Returns the negative preshoot voltage.)
MEASure: VOLTage:NPReshoot
20
76 VM2601/2/3 Command Dictionary
www.vxitech.com
CALCulate:VOLTage:NRINging?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the negative ringing measurement of the data being acquired.
Query
None
N/A
N/A
CALCulate:VOLTage:NRINging?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:NRINGing query instructs the device to calculate and return
a value corresponding to the negative ringing of an signal on the selected input range.
Negative ringing is defined as the peak-to-peak voltage of a negative post-transitional
aberration.
1.0
0.8
0.6
voltage (V)
0.4
0.2
0
Negative
Ringing
2
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
CALC:VOLT:NRIN?
(Returns the value of the negative ringing
voltage.)
Returns the positive overshoot value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:POVershoot?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:POVershoot query instructs the device to calculate and return
a voltage value corresponding to the positive overshoot from the selected input range.
The positive overshoot is defined as the amount of voltage by which a post-transitional
aberration positively exceeds the state boundary.
1.0
Positive Overshoot
0.8
0.6
e (V)
lta
v
0.4
0.2
20
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:POV?
CONFigure:VOLTage:POVershoot
(Returns the positive overshoot voltage.)
MEASure: VOLTage:POVershoot
20
78 VM2601/2/3 Command Dictionary
www.vxitech.com
o
g
CALCulate:VOLTage:PPReshoot?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the positive preshoot value for the aquried data.
Query
None
N/A
N/A
CALCulate:VOLTage:PPReshoot?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:PPReshoot query instructs the device to calculate and return
a voltage value corresponding to the positive preshoot from the selected input range. The
positive preshoot is defined as the amount of voltage by which a pre-transitional
aberration positively exceeds the state boundary.
1.0
0.8
Positive Preshoot
0.6
e (V)
lta
v
0.4
0.2
20
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Returns the positive ringing measurement of the data being acquired.
Query
None
N/A
N/A
CALCulate:VOLTage:PRINging?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:PRINGing query instructs the device to calculate and return
a value corresponding to the positive ringing of an signal on the selected input range.
Positive ringing is defined as the peak-to-peak voltage of a positive post-transitional
aberration.
1.0
Positive
0.8
Ringing
0.6
voltage (V)
0.4
0.2
0
2
681012141618
4
time ( s)µ
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:PRIN?
CONFigure:VOLTage:PRINging
(Returns the positive ringing voltage.)
MEASure:VOLT:PRINging
20
80 VM2601/2/3 Command Dictionary
www.vxitech.com
o
g
CALCulate:VOLTage:PTPeak?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the peak-to-peak voltage value for the acquired data.
Query
None
N/A
N/A
CALCulate:VOLTage:PTPeak?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:PTPeak query instructs the device to calculate and return a
peak-to-peak voltage measurement from the selected input range. The peak-to-peak
voltage (V
) is defined as the voltage measured between the signal’s maximum and
P-P
minimum points.
1.0
0.8
0.6
e (V)
lta
v
0.4
0.2
20
681012141618
4
time ( s)µ
Peak-to-Peak
Voltage
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:PTP?
CONFigure:VOLTage:PTPeak
MEASure: VOLTage:PTPeak
20
VM2601/2/3 Command Dictionary 81
CALCulate:VOLTage:RMS?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Returns the root-mean-square (rms) voltage value of the data being acquired.
Query
None
N/A
N/A
CALCulate:VOLTage:RMS?
None
ASCII value representing a voltage measurement in volts.
The CALCulate:VOLTage:RMS query instructs the device to calculate and return the
root-mean-square (rms) voltage from the selected input range. The root-mean-square
voltage is defined by the following formula:
n
−=1
2
v
∑
V
rms
0
, where v = voltage and n = number of samples
n
To correctly perform a CALCulate function, a data set must be acquired (INITiate,
ARM, TRIGger), and the data may be transferred to the host (register access) before the
execution CALC query. This sequence is not a prerequisite for sending a CALCulate
query, but is required for valid data to be returned.
Examples Command / Query Response (Description)
Related Commands
CALC:VOLT:RMS?
CONFigure:VOLTage:RMS
MEASure: VOLTage:RMS
82 VM2601/2/3 Command Dictionary
www.vxitech.com
(
CALibration:ADC:GAIN
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
To provide an ADC gain factor for measurement compensation.
Command
CALibration:ADC:GAIN <adc_type>, <adc_gain>
<adc_type> = FAST or SLOW
<adc_gain> = for FAST, 1.15 – 1.35; for SLOW: 1.12 – 1.32
<adc_gain> = 1.0000
CALibration:ADC:GAIN <adc_type>
<adc_type> = FAST or SLOW
Returns the value currently set for the <adc_gain> parameter for the given <adc_type>.
Sets the gain factor for the indicated ADC. CALibration:ADC:GAIN compensates for
gain errors due to component tolerances. This factor is calculated using the following
formula:
voltscal
FactorGain
=
2
This command is ‘context sensitive’, i.e. it sets the ADC gain factor for the specified
ADC in the currently selected input range.
On the VM2601, if the IFR input is selected, the only valid value for the <adc_type>
parameter is FAST and only one range (±0.5 V) is applicable for the FAST ADC. Note
that the IFR input is not installed on the VM2602 and VM2603.
The valid entries for the <adc_type> parameter are:
FAST
SLOW
×
()()
)
383,16_
−××
offsetsamplerange
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
Examples Command / Query Response (Description)
Related Commands
VM2601/2/3 Command Dictionary 83
CAL:ADC:GAIN 2,1.25
CALibration:ADC:OFFSet
()(
−
=
(
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
To provide an ADC offset value for measurement compensation.
Command
CALibration:ADC:OFFSet <adc_type>, <adc_offset>
<adc_type> = FAST or SLOW
<adc_offset> = 8092 – 8292
<adc_offset> = 8192
CALibration:ADC:OFFSet? <adc_type>
<adc_type> = FAST, SLOW
Returns the value currently set for the <adc_offset> parameter for the given
<adc_offset>.
Sets the offset value for the indicated ADC. The offset value compensates for offsets in
the signal path and converting the raw data from straight binary to signed (twos
complement) binary. The offset value is calibrated by applying 0 V to the input and
determining the offset required for the measurement to read 0 V:
)()
gaincountvoltsoffsetsamplevoltsvalueOffset/)(
where
This command is ‘context sensitive’, i.e. it sets the ADC offset factor for the specified
ADC in the currently selected input range.
On the VM2601, if the IFR input is selected, the only valid value for the <adc_type>
parameter is FAST and only one range (±0.5 V) is applicable for the FAST ADC. Note
that the IFR input is not installed on the VM2602 and VM2603.
The valid entries for the <adc_type> parameter are:
FAST
SLOW
/
countvolts=
2
)
rangevoltage
383,16
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
Examples Command / Query Response (Description)
Related Commands
84 VM2601/2/3 Command Dictionary
CAL:ADC:OFFS 8207
www.vxitech.com
CALibration:COUNt?
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Tracks the number of times calibration memory has been written.
Query
None
N/A
N/A
CALibration:COUNt?
None
Returns a numeric value from 0 to 16,777,215 (after the maximum value, it will wrap to
0)
The CALibration:COUNt query returns the number of times the CALibration:STORe
operation has been performed. This provides some indication of EEPROM wear.
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
Examples Command / Query Response (Description)
Related Commands
CAL:COUN?
24 (Returns the number of times the CAL:STOR
command has been performed.)
VM2601/2/3 Command Dictionary 85
CALibration:DAC:GAIN
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
To set the calibration factor that compensates for DAC gain inaccuracies.
Command
CALibration:DAC:GAIN <dac_chan>, <dac_gain>
<dac_chan> = 0 – 5
<dac_gain> = range depends on channel
<dac_gain> = 1.000 (or Cal Value)
CALibration:DAC:GAIN? <dac_chan>
<dac_chan> = 0 – 5
Returns the value currently set for the <dac_gain> parameter for the given <dac_chan>.
Sets the gain factor for the indicated DAC. CALibration:DAC:GAIN compensates for
deviations from the ideal slope for the DAC. Prior to calibration, the <dac_gain>
parameter will read “1” after a reset condition. After calibration has been performed, this
value changes and is stored in non-volatile memory. When a reset condition occurs after
calibration, the value stored in non-volatile memory is returned.
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
Examples Command / Query Response (Description)
Related Commands
CAL:DAC:GAIN 2,.98
86 VM2601/2/3 Command Dictionary
www.vxitech.com
CALibration:DAC:OFFSet
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
To set the calibration factor that compensates for DAC offset inaccuracies
Returns the value currently set for the <dac_offset> parameter for the given
<dac_chan>.
Sets the offset value for the indicated DAC. The offset value compensates for
conversion of data from sine binary to straight binary. Prior to calibration, the
<dac_offs> parameter will read “2047” after a reset condition. After calibration has been
performed, this value changes and is stored in non-volatile memory. When a reset
condition occurs after calibration, the value stored in non-volatile memory is returned.
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
Examples Command / Query Response (Description)
Related Commands
CAL:DAC:OFFS 2,1900
VM2601/2/3 Command Dictionary 87
CALibration:DEFault
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Sets all calibration factors to their default values.
Command
CALibration:DEFault
None
N/A
N/A
N/A
N/A
Sets all calibration factors to their default values. The values assumed are as follows:
(Resets all calibration factors to the values
stored in non-volatile memory.)
VM2601/2/3 Command Dictionary 89
CALibration:SECure:CODE
1
2#3
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Sets the code required to disable calibration security.
Instrument specific command
CALibration:SECure:CODE <string>
<string> = the code string can be from 1 to 15 ASCII characters in length entered in
IEEE 488.2 definite or indefinite length arbitrary block format.
None
CALibration:SECure:CODE?
None
Returns the security code in IEEE 488.2 definite block format.
The calibration security code command sets the code required to disable calibration
security. Calibration security must first be disabled before the code can be changed.
Definite length arbitrary block format is used to define the <string> parameter. This
format contains, essentially, four parts:
#206VM260
#1#
#1: a pound sign header.
#2: indicates how many digits are used in #3.
#3: indicates the number of characters that are used in #4 (the security code). Valid
numbers for the third section are 1 through 15.
#4: the security code. It may be up to 15 characters long and is case sensitive.
Before shipping the instrument, the default security code is the module’s model
number (i.e. VM2601, VM2602, or VM2603).
#4
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
Examples Command / Query Response (Description)
Related Commands
90 VM2601/2/3 Command Dictionary
CAL:SEC:CODE #206VM2601
CALibration:SECure:STATe
CALibration:STORe
(Sets the factory code setting of VM2601)
www.vxitech.com
CALibration:SECure[:STATe]
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Enable or disable calibration security.
Command
CALibration:SECure[:STATe] <boolean> or
CALibration:SECure[:STATe] <boolean>, <string>
<boolean> = 0 | 1 | OFF | ON
<string> = the code string can be from 1 to 15 ASCII characters in length entered in
IEEE 488.2 definite or indefinite length arbitrary block format.
<boolean> = ON
CALibration:SECure[:STATe]?
None
Returns the value currently selected for the <boolean> parameter
The CALibration:SECurity[:STATe] command enables or disables calibration security.
While security is on, the calibration factors ADC gain, ADC offset, DAC gain and DAC
offset cannot be changed. In addition, the CAL:STORe command is disabled, effectively
write protecting the non-volatile memory. In order to disable the security state, the
security code must be supplied. The factory default security code is VM2601 (see
CALibration:SECure:CODE for more information). To enable security, the code does
not need to be supplied. The security state is enabled by default.
Security can also be enabled without entering the <string> parameter by sending the
CALibration:SECure[:STATe] 1 | ON command. Security cannot, however, be disabled
using a CALibration:SECure[:STATe] 0 | OFF command. If this command is sent, a
“Missing Parameter” error will be returned.
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
1 (Indicates that calibration security is enabled.)
CALibration:STORe
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Stores calibration data into non-volatile memory.
Command
CALibration:STORe
None
N/A
None
N/A
N/A
The CALibration:STORe command stores correction data into non-volatile memory.
The correction data is calibration data that has been downloaded via the program
messages in the Calibration Data subsystem. The CALibration:STORe command should
only be performed after all the correction data has been finalized.
Note: Security must be turned off in order to use this command.
Calibration commands should only be executed by qualified
personnel. Changing these values incorrectly can cause the
instrument to perform improperly.
Returns the value currently selected for the <mark_source> for the indicated <mark>
Feeds <mark_source_1> to D14 and <mark_source_2> to D15 with each sample taken
during data acquisition. The markers are retrieved with the raw data.
Examples Command / Query Response (Description)
Related Commands
COMB:FEED GP0,GP1
None
VM2601/2/3 Command Dictionary 93
CONFigure?
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Outputs the currently configured measurement.
Query
None
N/A
PERiod
CONFigure?
None
Outputs the currently configured measurement.
Outputs the currently configured measurement. No configuration information is returned
with this query. PERiod is the default setting.
Examples Command / Query Response (Description)
Related Commands
MEAS:VOLT:RTIM? 0,1024,10,90,5.0
CONF?
None
(Takes a rise time measurement between the 10
and 90 percent reference levels)
RTIM? (Returns the currently configured
measurement.)
94 VM2601/2/3 Command Dictionary
www.vxitech.com
CONFigure:ADC
Purpose
Type
Command Syntax
Command Parameters
*RST Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Selects between the fast and slow ADCs.
Command
CONFigure:ADC <conf_adc>
<conf_adc> = FAST | SLOW | AUTO
FAST
CONFigure:ADC?
None
Returns the value currently selected for the <conf_adc> parameter
This command selects between the two converters. The fast ADC converts at up to
80 MSa/s for the VM2601, 40 MSa/s for the VM2602, and 20 MSa/s for the VM2603.
The slow ADC converts at up to 10 MSa/s for all three modules. The slow converter
provides improved dc accuracy for low-frequency measurements.
When AUTO is selected, the module selects the best converter to be used based upon the
sample rate, with the slow converter being used if possible. The following criteria is
used to determine which ADC is selected:
If the sample rate is between 4.7 Hz and 1 kHz, then the FAST ADC is selected.
If the sample rate is between 1 kHz and 10 MHz, then the SLOW ADC is selected.
If the sample rate is between 10 MHz and the maximum ADC rate, then the FAST ADC
is selected.
This command only applies to the DSO. The IFR input will always utilize the FAST
ADC (VM2601 only).
CONF:ADC SLOW
CONF:ADC?
None
(Selects the slow ADC)
SLOW (Indicates that the slow ADC is selected)
VM2601/2/3 Command Dictionary 95
CONFigure:FALL:TIMe
VXI Technology, Inc.
Purpose
Type
Command Syntax
Command Parameters
Reset Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Defines the fall time parameters that will govern corresponding CALCulate and
MEASure commands.
<start_samp> = typically 0
<#_samp> = 8 – 16,777,216
<lo_ref> = 0 to 100 (percent). The default is 10% and it must be less than <hi_ref>
<hi_ref> = 0 to 100 (percent). The default is 90% and it must be greater than <lo_ref>
<expected_val> = depends on input
This command defines the parameters used by the CALCulate:FTIMe query. Fall time is
defined as the time interval that occurs between the 90% reference and 10% reference of
the signal amplitude.
The parameters for this command are defined as follows:
•<start_samp> = indicates the number of the sample, with respect to the trigger point,
that will be the first sample used in the measurement. (0 = trigger point). If
<start_samp> is negative, pre-trigger samples will be included in the measurement.
• <#_samp> = indicates the number of samples to be used in the measurement.
• <lo_ref> = fall time ends when a negative transition of the input signal crosses this
reference point.
•<hi_ref> = fall time begins when a negative transition of the input signal crosses this
reference point.
•<expected_val> = the value that is expected to be returned by the instruement.
CONF:FTIM 0,2048,10,90,x
CALCulate:FALL:TIME?
CALCulate:FTIMe?
96 VM2601/2/3 Command Dictionary
www.vxitech.com
CONFigure:FREQuency
Purpose
Type
Command Syntax
Command Parameters
Default Value
Query Syntax
Query Parameters
Query Response
Description
Examples Command / Query Response (Description)
Related Commands
Defines the frequency parameters that will govern corresponding CALCulate and
MEASure commands.
<start_samp> = typically 0
<#_samp> = 8 to 16,777,216
<expected_val> = depends on input
<start_samp> = 0
<#_samp> = 1,024
None
N/A
N/A
This command defines the parameters used by the CALCulate:FREQuency query.
Frequency (f) is a measure of how often a signal repeats in one second (1/s = Hz). This is
also equal to 1/period (or 1/T).
The parameters for this command are defined as follows:
•<start_samp> = indicates the number of the sample, with respect to the trigger point,
that will be the first sample used in the measurement. (0 = trigger point). If
<start_samp> is negative, pre-trigger samples will be included in the measurement.
• <#_samp> = indicates the number of samples to be used in the measurement.
• <expected_val> = the value that is expected to be returned by the instruement.