User Manual
VX4351
40-Channel, 10 Amp, SPST Switch Module
070-9724-01
This document supports firmware version 1.3 and
above.
Warning
The servicing instructions are for use by qualified
personnel only. To avoid personal injury, do not
perform any servicing unless you are qualified to
do so. Refer to the Safety Summary prior to
performing service.
Copyright T ektronix, Inc. All rights reserved. Licensed software products are owned by Tektronix or its suppliers and
are protected by United States copyright laws and international treaty provisions.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the
Rights in T echnical Data and Computer Software clause at DFARS 252.227-7013, or subparagraphs (c)(1) and (2) of the
Commercial Computer Software – Restricted Rights clause at F AR 52.227-19, as applicable.
T ektronix products are covered by U.S. and foreign patents, issued and pending. Information in this publication supercedes
that in all previously published material. Specifications and price change privileges reserved.
Printed in the U.S.A.
T ektronix, Inc., P.O. Box 1000, Wilsonville, OR 97070–1000
TEKTRONIX and TEK are registered trademarks of T ektronix, Inc.
WARRANTY
T ektronix warrants that this product will be free from defects in materials and workmanship for a period of three (3) years
from the date of shipment. If any such product proves defective during this warranty period, T ektronix, at its option, either
will repair the defective product without charge for parts and labor, or will provide a replacement in exchange for the
defective product.
In order to obtain service under this warranty, Customer must notify Tektronix of the defect before the expiration of the
warranty period and make suitable arrangements for the performance of service. Customer shall be responsible for
packaging and shipping the defective product to the service center designated by T ektronix, with shipping charges prepaid.
T ektronix shall pay for the return of the product to Customer if the shipment is to a location within the country in which the
T ektronix service center is located. Customer shall be responsible for paying all shipping charges, duties, taxes, and any
other charges for products returned to any other locations.
This warranty shall not apply to any defect, failure or damage caused by improper use or improper or inadequate
maintenance and care. T ektronix shall not be obligated to furnish service under this warranty a) to repair damage resulting
from attempts by personnel other than T ektronix representatives to install, repair or service the product; b) to repair
damage resulting from improper use or connection to incompatible equipment; or c) to service a product that has been
modified or integrated with other products when the effect of such modification or integration increases the time or
difficulty of servicing the product.
THIS WARRANTY IS GIVEN BY TEKTRONIX WITH RESPECT TO THIS PRODUCT IN LIEU OF ANY
OTHER WARRANTIES, EXPRESSED OR IMPLIED. TEKTRONIX AND ITS VENDORS DISCLAIM ANY
IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
TEKTRONIX’ RESPONSIBILITY TO REPAIR OR REPLACE DEFECTIVE PRODUCTS IS THE SOLE AND
EXCLUSIVE REMEDY PROVIDED TO THE CUST OMER FOR BREACH OF THIS WARRANTY. TEKTRONIX
AND ITS VENDORS WILL NOT BE LIABLE FOR ANY INDIRECT , SPECIAL, INCIDENTAL, OR
CONSEQUENTIAL DAMAGES IRRESPECTIVE OF WHETHER TEKTRONIX OR THE VENDOR HAS
ADVANCE NOTICE OF THE POSSIBILITY OF SUCH DAMAGES.
Table of Contents
Getting Started
Operating Basics
General Safety Summary iii. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Service Safety Summary i. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Getting Started 1–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Module Description 1–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VXIplug&play Software Description 1–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Accessories 1–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controls and Indicators 1–6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuration 1–8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Module Installation 1–9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
VXIplug&play Software Installation 1–12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installation Checklist 1–16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functional Check 1–17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Operating Basics 2–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functional Overview 2–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Power-on 2–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Instrument I/O: VXIbus Basics 2–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Configuration Registers 2–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Syntax and Commands
Status and Events
Command Syntax 3–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Functional Command Groups 3–11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Commands 3–11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Module Commands 3–12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Descriptions 3–15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
IEEE-488.2 Common Commands 3–37. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Events 4–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Event Reporting System 4–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status Byte Register 4–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Service Request Enable Register 4–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Standard Event Status Register 4–3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Event Status Enable Register 4–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Output Queue 4–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The System Error and Event Queue 4–4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Status and Event Reporting Process 4–5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Messages 4–6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
i
Table of Contents
Appendices
Glossary
Appendix A: Specifications A–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix B: Input/Output Connections B–1. . . . . . . . . . . . . . . . . . . . . . . .
Appendix C: Examples C–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix D: Performance Verification D–1. . . . . . . . . . . . . . . . . . . . . . . . .
Appendix E: User Service E–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix F: Replaceable Parts F–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parts Ordering Information F–1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using the Replaceable Parts List F–2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Company Confidential [12/5/96]
ii
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
General Safety Summary
Review the following safety precautions to avoid injury and prevent damage to
this product or any products connected to it. To avoid potential hazards, use this
product only as specified.
Only qualified personnel should perform service procedures.
While using this product, you may need to access other parts of the system. Read
the General Safety Summary in other system manuals for warnings and cautions
related to operating the system.
To Avoid Fire or
Personal Injury
Connect and Disconnect Properly . Do not connect or disconnect probes or test
leads while they are connected to a voltage source.
Ground the Product. This product is indirectly grounded through the grounding
conductor of the mainframe power cord. To avoid electric shock, the grounding
conductor must be connected to earth ground and the screws in the front of the
module must be secure. Before making connections to the input or output
terminals of the product, ensure that the product is properly grounded.
Observe All Terminal Ratings. To avoid fire or shock hazard, observe all ratings
and markings on the product. Consult the product manual for further ratings
information before making connections to the product.
The common terminal is at ground potential. Do not connect the common
terminal to elevated voltages.
Do not apply a potential to any terminal, including the common terminal, that
exceeds the maximum rating of that terminal.
Do Not Operate Without Covers. Do not operate this product with covers or panels
removed.
Use Proper Fuse. Use only the fuse type and rating specified for this product.
Avoid Exposed Circuitry. Do not touch exposed connections and components
when power is present.
Do Not Operate With Suspected Failures. If you suspect there is damage to this
product, have it inspected by qualified service personnel.
Do Not Operate in Wet/Damp Conditions.
Do Not Operate in an Explosive Atmosphere.
Keep Product Surfaces Clean and Dry .
Provide Proper Ventilation. Refer to the manual’s installation instructions for
details on installing the product so it has proper ventilation.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
iii
General Safety Summary
Symbols and Terms
T erms in this Manual. These terms may appear in this manual:
WARNING. Warning statements identify conditions or practices that could result
in injury or loss of life.
CAUTION. Caution statements identify conditions or practices that could result in
damage to this product or other property.
T erms on the Product. These terms may appear on the product:
DANGER indicates an injury hazard immediately accessible as you read the
marking.
WARNING indicates an injury hazard not immediately accessible as you read the
marking.
CAUTION indicates a hazard to property including the product.
Symbols on the Product. The following symbols may appear on the product:
WARNING
High Voltage
Protective Ground
(Earth) T erminal
CAUTION
Refer to Manual
Double
Insulated
Company Confidential [12/5/96]
iv
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Service Safety Summary
Only qualified personnel should perform service procedures. Read this Service
Safety Summary and the General Safety Summary before performing any service
procedures.
Do Not Service Alone. Do not perform internal service or adjustments of this
product unless another person capable of rendering first aid and resuscitation is
present.
Disconnect Power. To avoid electric shock, disconnect the main power by means
of the power cord or, if provided, the power switch.
Use Care When Servicing With Power On. Dangerous voltages or currents may
exist in this product. Disconnect power, remove battery (if applicable), and
disconnect test leads before removing protective panels, soldering, or replacing
components.
To avoid electric shock, do not touch exposed connections.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
v
Service Safety Summary
Company Confidential [12/5/96]
vi
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Preface
This manual assumes you are familiar with VXIbus instruments and operation
and with the purpose and function of this instrument.
Please read and follow all instructions for installation and configuration. Use the
Installation Checklist to ensure proper installation and to record your initial
settings.
The Operating Basics section gives a summary of VXIbus operation and
presents an overview of the operation of this instrument.
The Syntax and Commands section provides a summary of all the commands
followed by detailed descriptions of each command.
The Status and Events section contains an explanation of the Status and Event
Reporting System and lists the system messages.
Appendix C: Examples contains example programs that demonstrate the
programmable features of this instrument.
Conventions
The names of all switches, controls, and indicators appear in this manual exactly
as they appear on the instrument.
Specific conventions for programming are given in the sections Syntax and
Commands and Appendix C: Examples.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
vii
Preface
viii
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
Getting Started
This section begins with a brief description of the VX4351 40-Channel, 10 Amp,
SPST Switch Module and its supporting VXIplug&play software. The topics
discussed in this section include the following:
An explanation of how to configure and install the module in a VXIbus
mainframe
A quick functional check to assure that the instrument operates properly
A review and explanation of the VXIplug&play software, including the Soft
Front Panels (SFPs) and the plug&play instrument driver function calls
An explanation of the controls and indicators on the module
A description of the module configuration
Module installation procedures
VXIplug&play software installation procedure
Module Description
The VX4351 40-Channel, 10 Amp, SPST Switch Module is a printed circuit
board assembly for use in a mainframe conforming to the VXIbus Specification,
such as the VX1410 Intelliframe. The VX4351 contains 40 SPST (form A)
relays. Each relay may be controlled independently. The contacts of each relay
are connected to one of three 30-pin high current connectors which are mounted
on the module’s front panel. Circuitry is included on the VX4351 to verify the
control signals that are applied to each relay coil driver.
The VX4351 provides the following features:
10 A maximum switching current per contact
30 VDC, 250 VAC maximum switching voltage per contact
300 W, 2500 VA maximum switching power per contact
40 SPST (form A) relays
verification of the control signal applied to each relay coil driver.
three 30-pin high current front panel connectors
optional installation of the low-cost VXI local bus slave interface
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–1
Getting Started
The Option 01 Interface
The Option 01 interface enables the VX4351 to control up to 11 additional relay
modules from the Tektronix SurePatht family of relay modules. These modules
are controlled via the VXI P2 local bus. The VX4351 acts as a local bus slave
relay module when it is not equipped with option 01.
Option 01 provides a VXI word serial protocol servant interface to the
SurePatht family of VXI relay modules. The Option 01 is a circuit board
assembly measuring approximately 3I × 9I that is installed as an optional
daughter board on one of the SurePatht C-size VXI switching modules.
The daughter board accepts SCPI-compatible commands from its commander
using VXI word serial protocol. The daughter board controls the relay module on
which it is installed, and controls additional relay modules installed in adjacent
slots to its right via the VXI P2 local bus. The daughter board is capable of
controlling from one to 12 relay modules of the SurePatht family.
NOTE. For the daughter board to control additional relay modules, a firmware
upgrade may be required. In this document, these modules will be referred to as
“local bus slaves.”
VXI Interface Module Features. The VXI Interface Module includes the following
features:
H CPU:
Zilog Z88C00 Microcontroller with 20 MHz Clock
64 Kb of EPROM and 32 Kb of RAM
H VXI Interface:
VXI Rev 1.4 Message Based Device
Supports Fast Handshake word serial protocol data transfers
IEEE-488.2 device
Logical Address selectable with two rotary hexadecimal switches
Interrupter level selectable with a rotary hexadecimal switch. Selects one of
seven levels or disables interrupt generation
Command programmable control of one of eight VXI TTL triggers
Command programmable monitoring of one to eight VXI TTL triggers
As part of the self test, SurePatht modules automatically verify the control
logic every time a relay operation is performed.
1–2
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
Socketed Relays
Experience shows that high current switching can be more prone to relay failure
than low current switching applications. These failures are most often caused by
a Unit Under Test (UUT) fault resulting in excessive draw.
Socketed relays are used in the VX4351 Module for easy on-site replacement of
defective relays. This reduces the downtime that may be experienced when
switching high currents.
Figure 1–1 shows the contact arrangement (1 of 40 relays) of the VX4351.
Figure 1–2 shows a typical SurePatht configuration.
Common
Normally Open
Figure 1–1: VX4351 Contact Arrangement (1 of 40 Relays)
VXI interface &
slave controller
daughter board
Backplane
connectors
Front panel
connectors
Daughter board
connectors
Figure 1–2: Typical SurePath Configuration
Fuses
The VX4351 has one 2 A fast-acting fuse on the +5 V line, and one 2 A fast
acting fuse on the +24 V line.
Each relay module that the Option 01 Module controls has a fuse that limits the
amount of current that the module can draw from the VXI backplane +5 V power
pins. This fuse protects the module in case of an accidental shorting of the power
bus or any other situation where excessive current might be drawn.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
VXI backplane
local bus
1–3
Getting Started
The Option 01 Module monitors the state of the fuses of each of the relay
modules that it controls. If a fuse opens on one of these modules, the Option 01
Module will assert SYSFAIL* on the VXIbus.
If the +5 V fuse on the module on which the Option 01 Module is installed
opens, the VXIbus Resource Manager will be unable to assert SYSFAIL
INHIBIT on the Option 01 to disable SYSFAIL*.
If a +5 V fuse opens, remove the fault before replacing the fuse. Replacement
fuse information is given in the Specifications section of the user manual for the
appropriate relay module.
CAUTION. This instrument can cause electric shocks. Please refer all servicing to
qualified personnel.
BITE (Built-in Test
Equipment)
Built-in Test Equipment (BITE) is provided by extensive self tests that are
automatically invoked on power-on and can also be invoked on command.
Circuitry tested includes the CPU and all memory
on each relay module controlled by the Option 01.
VXIplug&play Software Description
VXIplug&play Soft Front Panels (SFPs) provide interactive control of VXI
instruments using software virtual instruments and instrument drivers that are
controller independent. SFPs are graphical user interfaces that emulate the
physical controls and displays typically found on monolithic instruments. The
instrument drivers call a common set of I/O control functions that are independent of instrument types, interface types, operating systems, programming
languages, and networking mechanisms.
The installation program installs the VXIplug&play drivers as defined by the
VXIplug&play Alliance for the framework appropriate for your processing
environment, as follows:
WIN
WinNT
, and the relay control circuitry
1–4
Win95
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
When the installation is complete, double clicking on the icon launches the Soft
Front Panel, which displays a representation of the traditional controls and
indicators for an instrument. By selecting the appropriate controls on the SFP,
you can verify that the instrument has been correctly installed and is functional,
and performs nearly all of the functions of the instrument. The soft front panel
software will:
Accessories
Control the instrument
Display data
Provide command line query and response (Talk/Listen)
Provide error and event reporting
See Installation for instructions on installing and running the SFP and using the
C driver for program control. Detailed descriptions of the VXIplug&play drivers
are given in on-line help and text files on the media shipped with the instrument.
Table 1–1 lists the standard accessories included with the VX4351:
T able 1–1: Standard Accessories
Accessory Part Number
VX4351 User Manual 070-9724-XX
VX4351 Reference 070-9726-XX
3 ea Mating Connectors 204-1 176-XX
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–5
Getting Started
T able 1–1: Standard Accessories (Cont.)
Accessory Part Number
90 ea Connector Pins 131-6194-XX
VXIplug&play media 063-2355-XX and
063-2762-XX
Table 1–2 lists the options available for the VX4351.
T able 1–2: Optional Accessories
Option Part Number
01 VXI Interface Kit 040-1510-XX
1 ea. Mating Connector 204-1 176-XX
1 ea. Crimp, Female Gold
Pins
1 ea. Hand Crimp Tool 003-1673-XX
1 ea. Turret Head 003-1674-XX
1 ea. Contact Insertion Tool 003-1671-XX
1 ea. Contact Extraction Tool 003-1672-XX
131-6194-XX
Controls
Switches
The following controls are provided to select the functions of the VX4351
operating environment. Figures 1–3 and 1–4 illustrate the physical location of
these controls.
The Logical Address switches and VMEbus Interrupt Level Select switch must
be correctly set to ensure proper operation. See Configuration for details on how
to set the switches.
1–6
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
Figure 1–3: VX4351 Fuse
F77
Option 01
F49
LOGICAL
ADDRS
LO
HI
INTRPT
Switches as viewed
from the rear of instrument
(labels are on the back shield)
HI CUR
Figure 1–4: VX4351 Front Panel
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–7
Getting Started
Configuration
The following switches must be correctly set to ensure proper operation. Refer to
Figure 1–3 for their physical locations.
Logical Address Switches
IEEE-488 Address
Each functional module in a VXIbus System must be assigned a unique logical
address, from 1 to decimal 255 (hexadecimal FF). The base VMEbus address of
the VX4351 is set to a value between 1 and hexadecimal FF (FF
) by two
16
hexadecimal rotary switches. Align the desired switch position with the arrow on
the module shield.
The physical address of the instrument is on a 64 byte boundary. If the Logical
Address switch representing the most significant digit (LA-HI) of the logical
address is set to position X and the switch representing the least significant digit
(LA-LO) of the logical address is set to position Y, then the base physical
address of the VX4351 will be [(40
LA HI LO decimal hex
A
16
15
LA is the Logical Address
0
16
1
16
16
A
16
5
16
(64 * 10) + 49152 = 49792 (4016 * A16) + C00016 = C280
(64 * 21) + 49152 = 50496 (4016 * 1516) + C00016 = C540
× XY16) + C00016]. For example:
16
Base Physical Address
16
16
In order to use and program the VX4351 Module in an IEEE-488 environment
you must know the IEEE-488 address of the module. Different manufacturers of
IEEE-488 interface devices might have different algorithms for equating a
logical address with an IEEE-488 address. Consult the operating manual of the
IEEE-488 Interface Module being used.
VMEbus Interrupt Level
Select Switch
1–8
Each function module in a VXIbus system can generate an interrupt at a
specified level on the VMEbus to request service from the interrupt handler
located on its commander. Set the interrupt level to the same level as the
interrupt handler on that commander. The VMEbus interrupt level on which the
VX4351 Module generates interrupts is set by a rotary switch. Align the desired
switch position with the arrow on the module shield.
Valid VMEbus Interrupt Level Select switch settings are one through seven, with
setting one equivalent to level one, and so on. The level chosen should be the
same as the level set on the VX4351 interrupt handler, typically the module
commander. Setting the switch to zero or eight will disable the module interrupts. Do not use switch settings nine through f.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Module Installation
Getting Started
Interrupts are used by the module to return VXIbus Protocol Events to the
module commander. Refer to the Operating Basics section for more information
on interrupts. The VXIbus Protocol Events supported by the module are listed in
Appendix A: Specifications.
This section describes how to install the VX4351 module in the mainframe.
CAUTION. Verify that the mainframe is able to provide adequate cooling and
power with this module installed. Check Thermal Considerations in this section
for cooling requirements. Refer to the mainframe Operating Manual for further
instructions. If the mainframe cannot cool the unit adequately, the unit may not
operate properly and may be damaged. Only qualified personnel should preform
service procedures.
Tools Required
Requirements and
Cautions
A slotted screwdriver set is required for proper installation.
The VX4351 Module is a C-size VXIbus instrument module and therefore may
be installed in any C- or D-size VXIbus mainframe slot other than slot 0. To
install the module in a D-size mainframe, consult the operating manual for the
mainframe. Refer to Configuration for information on selecting and setting the
Logical Address switch of the module. This switch defines the programming
address of your module. To avoid confusion, it is recommended that the slot
number and the logical address be the same.
NOTE. Note that there are two printed ejector handles on the card. To avoid
installing the card incorrectly, make sure the ejector marked “VX4351” is at the
top.
If the VX4351 is inserted in a slot with any empty slots to the left of the module,
the VME daisy-chain jumpers must be installed on the backplane in order for the
VXI Module to operate properly. Check the manual of the mainframe being used
for jumpering instructions. Jumpers are not necessary for autoconfiguring
backplane designs.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–9
Getting Started
CAUTION. Verify that the mainframe is able to provide adequate cooling and
power with this module installed. Insufficient cooling can damage the module.
Refer to the mainframe Operating Manual for instructions.
If the module is used in a Tektronix mainframe, all cooling requirements are met.
Thermal Considerations
Most VXI modules have very modest cooling requirements, and most VXI
mainframes have large airflow capacities. These circumstances combine to make
cooling considerations completely adequate in most installations. However, this
is not the case with the VX4351 40-Channel, 10 Amp, SPST Switch Module.
Although the VX4351 dissipates only 20 W of mainframe supply power, it is
possible for it to dissipate up to an additional 120 W of external power when all
40 switches are closed and loaded with 10 A of current.
If sufficient cooling air is not available from the VXI mainframe to guarantee a
20_ C rise under all circumstances, then the operation of the module must be
planned to control the power dissipation. In any case, the use of a Tektronix
VX1410 Option 1M Mainframe is recommended, both for its high cooling
capacity, and for its ability to monitor and alarm the temperature of the module
in each slot. The required airflow for a given operational condition may be
closely approximated by the following method:
1. Calculate the airflow requirements for each switch to be closed.
This is given by the equation:
(required airflow in liters/second) =~ .00216 x ((current in amperes)^2)
2. Sum the airflow requirements.
3. Add 1.44 liters/second
1–10
Examples
In the following example, all 40 channels of the VX4351 are to be closed, but
only 7 A of current are to be controlled on each channel:
Airflow per channel =~ .00216 x (7^2) = .106 liters/second
Airflow for 40 channels =~ 40 x .106 = 4.24 liters/second
Total airflow =~ 4.24 + 1.44 = 5.68 liters/second
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
The following graph illustrates the required airflow at different atmospheric
pressures and temperatures:
Liters/sec
20
15
10
5
0
13.3_ C
20_ C
Temperature Rise
40_ C
0 .10 .20 .30 .40 .50 .60 .70 .80 .90 1.00 1.10 1.20
mm H
O
2
10_ C
Figure 1–5: VX4351 Airflow Rate
By using this method, the chart of airflow rate versus pressure for the VX4351,
and the airflow data furnished with the VXI mainframe, operations may be easily
planned to ensure that the operating temperatures for the VX4351 are not
exceeded.
Installation Procedure
Follow these steps to install the VX4351. If the module has Option 01, first refer
to the Option 01 User Manual for instructions on mounting the option.
CAUTION. The VX4351 Module is a piece of electronic equipment and therefore
has some susceptibility to electrostatic damage (ESD). ESD precautions must be
taken whenever the module is handled. Only qualified personnel should preform
service procedures.
1. Record the revision level, serial number (located on the label on the shield of
the VX4351), and switch settings on the Installation Checklist.
2. Verify that the switches are set to the correct values. Refer to Configuration
for more information on setting switches.
3. Make sure that the mainframe power is off.
4. Insert the module into one of the instrument slots of the mainframe (see
Figure 1–6).
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–11
Getting Started
5. Secure the module to the mainframe using the hold-down screws, and cover
all unused slots.
6. Connector Installation: Use the correct cable to interface between the module
I/O connector and the Unit Under Test (UUT). The recommended connector
is listed in Appendix A: Specifications.
Figure 1–6: Module Installation
VXIplug&play Software Installation
Each VXIplug&play instrument includes storage media containing stand-alone,
executable Soft Front Panels (SFPs) to control the instrument. You can use the
soft front panels immediately after installing the software just as you would use
physical front panel controls. No particular application development environment (ADE) is necessary. The soft front panels and the supporting software were
developed in conformance with the guidelines of the VXIplug&play Systems
Alliance.
All VXIplug&play products are classified within a particular framework
according to guidelines of the VXIplug&play Systems Alliance to categorize
operating systems, programming languages, and I/O software libraries. The
framework supported by the driver distributed with this VXI module is printed
on the label of the media.
1–12
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
The source code, as well as the dynamic link library, are distributed so that you
have the flexibility of using either of them in the end application.
The instrument driver distributed with the Tektronix VX4351 is also VXIplug&play compliant. The driver uses VISA calls that are portable across
platforms and development environments. Tektronix uses only the ANSI C
implementation in instrument driver source code. No platform-specific libraries
are included in the driver. The driver source code will compile using MSVC,
Borland, Symantec or Watcom compilers without having to use foreign libraries
other than the VISA Dynamic Link Library.
The MSVC and Borland import libraries for visa.dll are located in the following
directory:
VXIPNP\<Framework>\LIB\MSC and VXIPNP\<Framework>\LIB\BC
respectively.
All driver .dll files are located in the following directory:
VXIPNP\<Framework>\BIN
Installation Procedure
Driver Files
Use the following procedure to install the VXIplug&play software:
1. Insert the media containing the driver files in the appropriate drive.
2. Locate the file setup.exe, as follows:
On a 3 1/2 inch floppy disk, the file is on disk 1
On a CD ROM, the file will be in the tkvx4351 directory.
3. Launch setup.exe as follows:
In Windows NT/3.xx, use the File menu and select Run. Then, browse to
find setup.exe or type the drive letter and program name.
In Windows 95, use Start and select Run. Browse to locate setup.exe and
click on OK.
4. Follow the directions of the installation program.
Following installation, driver files (see list below) will be found in locations
defined by the VXIplug&play Alliance. Where required, modifications to your
autoexec.bat and system.ini files may be automatically completed.
The instrument drivers for the VX4351 is distributed with a number of C source
code files, header files, dynamic link libraries and other supporting files. A
breakdown of the modules that the files control are as follows:
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–13
Getting Started
VX43x0. These files make up the high level “controller” portion of the driver.
This part of the driver does the actual communication with the instrument. The
tkvx43x0.c or tkvx43x0.dll have functions which perform VISA function calls.
The other modules, making up the total driver, call functions to get system
configuration information and to communicate to each specific instrument.
Device-Specific Files. Files controlling the SurePathtfamily have the prefix
tkvx43x0.
File Locations. For the VX43x0 driver, the following files will be in the
VXIPNP\<Framework>\TKVX43x0 directory:
tkvx43x0.fp
tkvx43x0.mak
tkvx43x0.def
tkvx43x0.hlp
tksf43x0.exe
Several *.uir (User Interface Resource) files will support the graphic user
interface (GUI) executables (CVI files). The following files are installed in the
VXIPNP\<Framework>\INCLUDE directory:
tkvx43x0.h
tkvx43x0.bas
The VXIPNP\<Framework>\BIN directory includes the following file:
tkvx43x0.dll
The VXIPNP\KB directory includes the following files:
tkvx4320.kb
tkvx4330.kb
tkvx4350.kb
tkvx4351.kb
tkvx4380.kb
tkvx4381.kb
The VXIPNP\<Framework>\LIB\MSC\ directory includes the following file:
tkvx43x0.lib
The .DLL files are tested in LabWindows/CVI, LabView, HPVEE, Visual Basic,
MSVC/C++ and Borland C/C++ before distribution. If you want to modify the
driver algorithms, all files are distributed to facilitate rebuilding the .DLL files
with the modifications.
1–14
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
NOTE. Tektronix recommends that you back up your original source files before
modifying the driver files
CAUTION. The Soft Front Panel (SFP) distributed with this driver is built using
the distributed .DLL files. Any modification to the .DLL files used by the SFP
could make it unusable. Re-installing the driver will write over any modified
files with the original files and restore SFP operation.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–15
Getting Started
Installation Checklist
Installation parameters will vary depending on the mainframe being used. Be
sure to consult the mainframe operating manual before installing and operating
the module.
Revision Level:
Serial No.:
Mainframe Slot Number:
Switch Settings:
VXIbus Logical Address Switch:
Interrupt Level Select Switch:
Cable Installed (if any):
VXIplug&play software installed:
1–16
Performed by: _______________________ Date: _____________
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Functional Check
Getting Started
In addition to the self tests, you can also perform an operational check of the
VX4351.
Self Test
The VX4351 Module executes a self test at power-on, on direction of a VXIbus
hard or soft reset condition or on command. The power-on self test consists of an
interface self test and an instrument self test. The self test requested by command
performs only the instrument self test. A VXIbus hard reset occurs when another
device, such as the VXIbus Resource Manager, asserts the backplane line
SYSRESET*. A VXIbus soft reset occurs when another device, such as the
VX4351 commander, sets the Reset bit in the VX4351 Control register.
During power-on, or a hard or soft reset, the following actions take place:
1. The SYSFAIL* (VME system-failure) line is set active, indicating that the
module is executing a self test, and the Failed LED is lighted. For a soft
reset, SYSFAIL* is set. All Tektronix commanders will simultaneously set
SYSFAIL INHIBIT to prevent the resource manager from prematurely
reporting the failure of a card.
2. On completion of the interface self test, SYSFAIL* is de-asserted. If the test
fails, the SYSFAIL* line remains active. If the interface self test passed, the
SYSFAIL* line is released, and the module enters the VXIbus PASSED state
(ready for normal operation). If it failed, the module enters the VXIbus
FAILED state.
3. The instrument self test, as described in the *TST? command description, is
then executed. This tests the Option 01 VXI Interface daughter board and
any relay modules under its control. If the self test fails, the module makes
an internal record of the failure(s) that occur.
The default condition of the Option 01 Module after the completion of power-on
self test is as follows:
All relays on modules controlled by the Option 01 (except VX4320
Modules) are set to the normally open position.
You can run the self test at any time during normal operation by using the *TST?
command. At the end of a self test initiated by this command, the module is
restored to its pre-test state.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–17
Getting Started
During a commanded self test:
1. SYSFAIL* is not asserted.
2. The module executes the same instrument self test as is executed upon
power on.
Operational Check
3. When the self test is completed,
restored to their pre-test state.
Perform an operational check of the VX4351 by using a low-impedance
(50 kW/volt) ohmmeter or a test light to check the continuity of the relay
closures. The operational check includes the following procedures:
Opening the relays
Closing the relays
Opening the Relays. Perform the following steps to open the relays of the
VX4351.
1. When the Option 01 Module is installed, issue the following command to
open all relays on the VX4351:
2. Verify that there is no continuity between the contacts, using a test light or
and ohmmeter, by measuring the resistance of each path.
As an example, for relay 1, test between pins 1 and 2 of J1. For relay 2, test
between pins 3 and 4 of J1.
the modules controlled by the Option 01 are
1–18
3. Using the connector pin-out table in Appendix B: Input/Output Connections,
continue this procedure for relays 3 through 40.
Closing the Relays. Perform the following steps to close the relays of the
VX4351.
1. Issue the following command to close all 40 relays of the VX4351:
2. Using the ohmmeter or test light, verify that there is continuity between the
contacts.
As an example for relay 1, test between pins 1 and 2 of J1. For relay 2, test
between pins 3 and 4 of J1.
3. Using the connector pin-out table in Appendix B: Input/Output Connections,
continue this procedure for relays 3 through 40.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Getting Started
SYSFAIL* Operation
SYSFAIL* becomes active during power-on, hard or soft reset, self test, or if the
module loses any of its power voltages. When the mainframe Resource Manager
detects SYSFAIL* set, it will attempt to inhibit the line. This causes the VX4351
40-Channel, 10 Amp, SPST Switch Module to deactivate SYSFAIL* except
when +5 V power is lost on the relay module on which it is installed.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
1–19
Getting Started
1–20
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Operating Basics
Operating Basics
Functional Overview
The VX4351 40-Channel, 10 Amp, SPST Switch Module is a VXIbus messagebased instrument and communicates using the VXIbus Word Serial Protocol. The
module is programmed by issuing ASCII characters from the system controller
to the VX4351 via the module VXIbus commander and the VXIbus mainframe
backplane. Refer to the manual for the VXIbus device that will be the VX4351
Module commander for details on the operation of that device.
If the module commander is a Tektronix IEEE-488 Interface Module, refer to the
operating manual for the module and Appendix C: Examples in this manual for
information on how the system controller communicates with the commander
being used.
The VX4351 provides 40 independent single-pole single-throw relays. These
may also be operated under program control in pairs as 20 double-pole singlethrow relays. These relays are capable of switching very high power levels, and
are easily replaceable.
Power-on
The instrument runs its self test and is ready for programming five seconds after
power-on. The VXIbus Resource Manager can add an additional delay. The
default condition of the module after power-on is listed in the *RST command
description. Self-test failures are described in the SYSTem:ERRor command
description.
The format and syntax for the command strings are described in the Command
Syntax section. A complete description of each command in alphabetical order is
in the Command Descriptions section.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
2–1
Operating Basics
Instrument I/O: VXIbus Basics
This section discusses the basic architecture and functionality of the VX4351
Module.
CAUTION. If the user’s mainframe has other manufacturers’ computer boards
operating in the role of VXIbus foreign devices, the assertion of BERR* (as
defined by the VXIbus Specification) may cause operating problems on these
boards.
About the Option 01
Interface Module
The Option 01 is a circuit board assembly measuring approximately 3I × 9I that
is installed as an optional daughter board on one of the SurePatht C-size VXI
switching modules. The Option 01 interface enables the VX4351 to control up to
11 additional relay modules from the Tektronix family of relay modules. These
modules are controlled via the VXI P2 local bus. The VX4351 acts as a local bus
slave relay module when it is not equipped with Option 01.
The Option 01 interface module is neither a VXIbus commander nor a VMEbus
master; therefore it does not have a VXIbus Signal register. The Option 01
interface is a VXIbus message-based servant. It is possible to install the VX4351
with or without the Option 01 Module.
Installation without the Option 01 interface. When the Option 01 interface is not
installed, the VX4351 Interface Module becomes a slave to another Option
01-equipped master module. As many as 11 slave modules not equipped with
Option 01 may be installed to the right of a single Option 01-equipped master
module. Slave modules are operated by the master module using the
SurePathtlocal bus protocol.
NOTE. You must install slave modules to the right of the module equipped with
Option 01, with no intervening empty slots, and with no intervening modules of
the SurePathtfamily.
2–2
Installation with the Option 01 interface. When the Option 01 interface is installed
on the VX4351 Module it becomes a VXIbus Message-Based Word Serial
instrument. It uses the A16, D16 VME interface available on the backplane P1
connector and does not require any A24 or A32 address space. The module is a
D16 interrupter.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Operating Basics
NOTE. It is possible for all modules in the mainframe to have an Option 01
interface. In that case, the modules all operate independently of one another.
The module supports the Normal Transfer Mode of the VXIbus using the Write
Ready, Read Ready, Data In Ready (DIR), and Data Out Ready (DOR) bits of
the module Response register.
A Normal Transfer Mode read of the Option 01 proceeds as follows:
1. The commander reads the Option 01 Response register and checks if the
Write Ready and DOR bits are true. If they are, the commander proceeds to
the next step. If not, the commander continues to poll these bits until they
become true.
2. The commander writes the Byte Request command (hexadecimal 0DEFF) to
the Data Low register of the Option 01.
3. The commander reads the Option 01 Response register and checks if the
Read Ready and DOR bits are true. If they are, the commander proceeds to
the next step. If not, the commander continues to poll these bits until they
become true.
About Fast Handshake
Mode
4. The commander reads the Option 01 Data Low register.
A Normal Transfer Mode write to the Option 01 proceeds as follows:
1. The commander reads the Option 01 Response register and checks if the
Write Ready and DIR bits are true. If they are, the commander proceeds to
the next step. If not, the commander continues to poll the Write Ready and
DIR bits until they are true.
2. The commander writes the Byte Available command which contains the data
(hexadecimal 0BCXX or 0BDXX, depending on the End bit) to the Data
Low register of the Option 01.
The module also supports the Fast Handshake Mode during readback. In this
mode, the module is capable of transferring data at optimal backplane speed
without needing the commander to test any of the handshake bits. The Option 01
asserts BERR* to switch from Fast Handshake Mode to Normal Transfer Mode,
per VXI Specification. The Option 01 Read Ready, Write Ready, DIR and DOR
bits react properly, in case the commander does not support the Fast Handshake
Mode.
A Fast Handshake Transfer Mode read of the Option 01 proceeds as follows:
1. The commander writes the Byte Request command (hexadecimal 0DEFF) to
the Option 01 Data Low register.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
2–3
Operating Basics
2. The commander reads the Option 01 Data Low register.
A Fast Handshake Transfer Mode write of the Option 01 proceeds as follows:
The commander writes the Byte Available command which contains the data
(hexadecimal 0BCXX or 0BDXX, depending on the End bit) to the Data
Low register of the Option 01. The commander may immediately write
another Byte Available command without having to check the Response
register.
The module has no registers beyond those defined for VXIbus message based
devices. All communications with the module are through the Data Low register,
the Response register, or the VXIbus interrupt cycle. Any attempt by another
module to read or write to any undefined location of the Option 01 address space
may cause incorrect operation of the module.
As with all VXIbus devices, the Option 01 has registers located within a 64 byte
block in the A16 address space. The base address of the Option 01 device
registers is determined by the device unique logical address and can be calculated as follows:
Configuration Registers
Base Address = V
* 4016 + C000
16
16
where V is the device logical address as set by the Logical Address switches.
Table 1–3 contains a list of the Configuration registers and a complete description of each register. The offset is relative to the module base address.
T able 1–3: Register Definitions
Address
Register
ID Register 0000 RO 101 1 1111 1111 1101 (hexadecimal BFFD)
Device Type 0002 RO See Device Type definition below
Status 0004 R Defined by state of interface
Control 0004 W Defined by state of interface
Offset 0006 WO Not used
Protocol 0008 RO 1111 0111 1111 1111 (hexadecimal F7FF)
Response 000A RO Defined by state of the interface
(hexadecimal)
Type Value (Bits 15-0)
2–4
Data High 000C Not used
Data Low 000E W Not fixed; command-dependent
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
T able 1–3: Register Definitions (Cont.)
Address
Register Value (Bits 15-0)Type
Data Low 000E R Not fixed; command-dependent
RO is Read Only
WO is Write Only
R is Read
W is Write
(hexadecimal)
The Register Bit definitions are listed in Tables 1–4 and 1–5:
T able 1–4: Register Bit Definitions
Register Bit Definition
ID hexadecimal BFFD
Protocol hexadecimal F7FF
Operating Basics
The contents of the Device register of the Option 01 Module depend on the
model number of the relay module on which it is installed.
T able 1–5: Device Register Bit Definitions
Relay Model No. Device Register Contents
VX4320 hexadecimal F6BF
VX4330 hexadecimal F6B5
VX4350 hexadecimal F6A1
VX4351 hexadecimal F682
VX4380 hexadecimal F683
VX4381 hexadecimal F6A0
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
2–5
Operating Basics
2–6
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Syntax and Commands
Command Syntax
Command protocol and syntax for the VX4351 Module are as follows:
A command string consists of a string of ASCII-encoded characters
In addition to terminating a command, the semi-colon character directs the
terminated by a <program message terminator>. The <program message
terminator> is optional white space, followed by any one of the following
command terminations:
a line feed <LF> or new line <NL> character (hexadecimal 0A,
decimal 10)
the END bit set
the END bit with a line feed <LF> or new line <NL>
The command string is buffered until the terminator is encountered, at which
time the entire string is processed.
SCPI command parser to interpret the next command with the assumption
that all characters up to and including the last colon in the previous
command have just been parsed. In the following example, the Option 01 is
installed on a VX4351 Module. Two additional VX4351 Modules are
installed in consecutive slots to the right of the first VX4351. Under these
conditions, the commands
route:open:all m1<LF>
route:open:all m2<LF>
route:open:all m3<LF>
cause all relays on all three modules to open. Note that each command is
terminated by a line feed. An equivalent method of sending these commands
using the semi-colon character as a terminator is
route:open:all m1; all m2; all m3<LF>
After a line feed or END bit is used to terminate a command, the parser no
longer makes the assumption described above. Thus, after the command
route:open:all m1; all m2<LF>
is parsed, the command
all m2<LF>
is no longer valid.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–1
Command Syntax
In the next example, the Option 01 is installed on a VX4330 Module. Two
additional VX4330 Modules are installed in consecutive slots to the right of
the first VX4330. The commands
connect the commons of sections 1 through 6 on the first VX4330, sections 1
and 2 on the second VX4330 and sections 1 through 4 on the third VX4330.
An equivalent way to send these commands using the semi-colon as a
terminator is
Note that <LF> in these examples represents a single line feed character.
White space characters can be used to make a command string more
readable. These characters are ASCII-encoded bytes in the range hexadeci-
mal 00-09 and 0B-20 (decimal 0-9 and 11-32). This range includes the
ASCII control characters and the space, but excludes the line feed <NL>.
White space characters are ignored when legally encountered in a command
string. White space is allowed anywhere in a command string, except for the
following:
Within a program mnemonic ( for example RO UTE )
Around a colon (:) mnemonic separator (for example ROUTE: CLOSE
or ROUTE :CLOSE)
Between a mnemonic and a (?) (for example CLOSE ?)
Following an asterisk (*) (for example * STB?)
Within a number (for example 12 34)
Within a module name specified in a [ROUTe:]MODule[:DEFine]
command (for example ROUTE:MODULE:DEFINE RFM UX, 1).
At least one white space character is required between a command/query
header and its associated arguments. For example in the command
the command header is the string “route:configure:join.” The arguments
associated with this command are the module name “m1” and the section list
“(1:6).” At least one white space character must be sent before the first
argument.
3–2
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Syntax
In the query
)',+ $'* %
the query header is the string “route:close?.” The argument associated with
this query is the channel list “(@m1(1:64)).” At least one white space
character must be sent before the channel list argument.
All characters in a command can be sent in either upper or lower case form.
Multiple data parameters passed by a command are separated by a comma
(,).
A question mark (?) following a command indicates that a response will be
returned. All responses from the module are terminated with a carriage return
<CR> and a line feed <LF> (hexadecimal 0A) character.
In the command descriptions, the following special characters are used.
These characters are not part of the command and should not be sent. If an
optional field is omitted, the default for the command is applied.
Syntax Example
[ ] Brackets indicate an optional field
| A bar indicates a logical OR choice
< > Field indicator
Capital letters indicate the minimum required characters which need to be sent.
Lower case letters are optional. For example, the syntax of the trigger source
command is given as
! ), & - - #+ - )!&
Each of the following is a valid form of this command:
+)#!! )* (, & *',) ,*
+)#!* (*',) "'$
)#!
)#!',)
)#!',)
)#!! )',) %% #+
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–3
Command Syntax
SCPI/IEEE 488.2
Command Elements
The definition of elements used in SCPI/IEEE 488.2 commands and command
descriptions is as follows:
<NR1> ASCII integer representation of a decimal number.
<NRf> ASCII integer, fixed point or floating point representation of a decimal
number.
<module_name> A user-defined ASCII string to be associated with the local bus
address of a relay module. <module_name> strings must start with a letter and
may consist of alphanumeric characters, underscores, and digits. The maximum
length of a <module_name> is 12 characters.
<channel_spec> One or more <NR1> ASCII strings separated by “!” characters
that specify a relay on a relay module. The format of a <channel_spec> field for
each of the SurePatht relay modules is:
H VX4320 RF Multiplexer: <NR1> ! <NR1>
The range of the first <NRf> field is 1 to 4. This field specifies a relay
within one of the sections of the VX4320. The range of the second <NRf>
field is 1 to 8. This field specifies a section of the VX4320. A one-dimen-
sional <channel_spec> may also be used to specify a channel on a VX4320
Module. The one-dimensional <channel_spec> is given by the formula:
3–4
( (section – 1 ) × 4 ) + relay.
where variables “section” and “relay” are section and relay numbers
specified in a two-dimensional <channel_spec>.
H VX4330 Scanner/Multiplexer: <NR1> ! <NR1>
The first <NR1> field specifies a relay within the specified section. The
range of this <NR1> field depends on the current configuration of the section
of the VX4330 specified in the second <NR1> field. The range of the second
<NR1> field is 1 to 6. This field specifies a section of the VX4330.
1 - 10 4-wire
1 - 20 4-wire independent
1 - 20 2-wire
1 - 40 1-wire
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Syntax
VX4350 General Purpose Switching module: <NR1>
The range of this field is 1 to 64. It specifies one of 64 relays on the
VX4350.
VX4351 High Current Switching Module: <NRI>
The range of this field is 1 to 40, specifying one of the 40 relays on the
module. If the module is placed in two-wire mode, then the range of the field
becomes 1 to 20, specifying one of the twenty relay pairs available on the
module.
VX4380 Matrix: <NR1> ! <NR1> ! <NR1>
The range of the first <NR1> field is 1 to 4. It specifies the row of a relay in
one of the sections of the VX4380. The range of the second <NR1> field is 1
to 16. It specifies the column of a relay in one of the sections of the VX4380.
The range of the third <NR1> field is 1 to 4. It specifies a section of the
VX4380. A one dimensional <channel_spec> may also be used to specify a
channel on a VX4380 Module. The one dimensional <channel_spec> is
given by the formula:
( (section – 1 ) × 64 ) + ( ( row – 1 ) × 16 ) + column
where variables “section” and “row” and “column” are section, row, and
column numbers specified in a three-dimensional <channel_spec>.
VX4381 High Current Matrix: <NR1> ! <NR1> ! <NR1> or <NR1> !
<NR1>
By default, the VX4381 is configured as two 4 × 4 matrices. In this case, the
first <NR1> field has a range of 1 to 4 and specifies the row of a relay in one
of the two sections. The second <NR1> also has a range of 1 to 4, but
specifies the column of a relay in one of the two sections. The third <NR1>
field of a three-dimensional <channel_spec> can have the value of 1 or of 2,
referring to the first or second matrix.
If the module is placed in two-wire mode, the second matrix is operated
parallel with the first matrix. Therefore, a two-dimensional <channel spec>
is required. The first <NR1> field in this case has a range of 1 to 4, and
specifies relays on the numbered row of both matrices. The second <NR1>
field also has a range of 1 to 4, and specifies relays on the numbered column
of both matrices.
In either mode, a one-dimensional <channel_spec> may also be used to
specify a channel on a VX4381 module. In one-wire mode, this is given by
the formula:
((section – 1) * 16) + ((row – 1) * 4) + column
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–5
Command Syntax
In two-wire mode, the one-dimensional <channel_spec> is given by the
formula:
((row–1) * 4) + column
<channel_list> A list of channel numbers on one or more relay modules.
The limits on the channel numbers in a <channel_list> depend on the model
number of the relay module(s) specified in the <channel_list>. The syntax of a
<channel_list> is shown in the following diagram:
A module_name is an ASCII string that has been associated with a relay module
in a ROUTe:MODule:DEFine command. A channel_range may consist of a
single <channel_spec> or a range of <channel_spec>s. A range of <channel_spec>s is indicated by two <channel_spec>s separated by a colon (:)
character. A <channel_spec> may have one, two or three dimensions depending
on the architecture of the relay module it applies to.
The following are examples of valid <channel_list>s for Tektronix VX4320,
VX4330, VX4350, VX4351, VX4380, and VX4381 relay modules. In these
examples it is assumed that the Option 01 is installed on a VX4320 Module. A
VX4330, VX4350, VX4351, VX4380, and VX4381 are installed in consecutive
slots to the right of the VX4320. The default module names for the VX4320,
VX4330, VX4350, VX4351, VX4380 and VX4381 in this example are m1, m2,
m3, m4, m5, and m6 respectively. These module names may be overridden by
specifying new module names with the [ROUTe:]MODule[DEFine] command. It
is also assumed in these examples that all sections on the VX4330 Module have
been configured as 10-to-1 4-wire scanners.
3–6
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Syntax
<channel_list> Channels Specified
(@m1(1!2)) Channel number 1 of section 2 on the VX4320 Module.
(@m1(4!1,3!8)) Channel number 4 in section 1 and relay number 3 in section 8
of the VX4320 Module.
(@m1(4!1:4!8)) Channel number 4 in sections 1 through 8 on the VX4320
Module.
(@m1(4!1,4!2,4!3,4!4,
4!5,4!6,4!7,4!8))
(@m2(1!6)) Channel 1 in section 6 of the VX4330 Module.
(@m2(1!1:10!6)) All channels on the VX4330 Module in the following order: 1!1,
(@m2(1!3:10!3)) All 10 channels in section 3 of the VX4330.
(@m3(1:64)) All 64 channels on the VX4350
(@m4(1,2,3,10,11,
20:13))
(@m4(1:5)) Channels 1 through 5 of the VX4351.
(@m5(2!3!1)) Row 2, column 3, section 1 of the VX4380
(@m6(1!2!2)) The channel that connects row 1 to column 2 in section 2 of
(@m6(17)) The channel that connects row 1 to column 1 in section 2 of
(@m6(1!1!2)) Same as the previous example.
(@m6(1:16)) All relays in section 1 of the VX4381.
(@m6(1!1!1:4!4!1)) Same as the previous example.
Channel number 4 in sections 1 through 8 on the VX4320
Module.
1!2, 1!3, 1!4, 1!5, 1!6, 2!1, 2!2, 2!3, 2!4, 2!5, 2!6, ... , 10!1,
10!2, 10!3, 10!4, 10!5, 10!6.
Channels 1, 2, 3, 10, 11, and 20 through 13 on the VX4351.
the VX4381.
the VX4381.
As the <channel_list> syntax diagram shows, channels on more than one relay
module may be specified in a <channel_list>. The next example specifies
channels on three different relay modules.
<channel_list> Channels Specified
(@m1(1!1), m2(4!6),
m6(3!3!2))
Channel 1 of section 1 on the VX4320, Channel 4 of section 6
of the VX4330, and the channel on the VX4380 that connects
row 3 to column 3 in section 2.
As mentioned above, the module names used in <channel_list>s may be
specified with a [ROUTe:]MODule[:DEFine] command. The command
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–7
Command Syntax
changes the module name assigned to the VX4320 to “rfmux”. The following
<channel_list> can then be used to specify channels on the VX4320.
(@rfmux(3!1,2!2))
specifies channel 3 in section 1 and channel 2 in section 2 of the VX4320.
The order in which channels are specified is important in the [ROUTe:] CLOSE?
<channel_list> and [ROUTe:]OPEN? <channel_list> queries. The states of the
channels are returned in the same order that the channels are specified in the
<channel_list>.
The order in which channels are specified is also important in the
[ROUTe:]SCAN <channel_list> command. This determines the order in which
the relays will be closed each time a trigger event is detected.
The order in which channels are specified in a <channel_list> is important in the
[ROUTe:]CLOSe <channel_list> command when channels in the same section of
a VX4320 or a VX4330 are specified. A VX4320 can close only one channel in a
section. If a [ROUTe:]CLOSE <channel_list> command specifies more than one
relay in a section of a VX4320, the last channel in the <channel_list> will be
closed.
For example, the command
close (@m1(1!1,2!1))
will close channel 2 of section 1 of the VX4320.
A VX4330 can close only one channel in a group of joined sections that have
been specified in a [ROUTe:]CLOSe:MODe SCAN,<module_name>,<section_list> command. If more than one channel in such a group of sections is
specified in a [ROUTe:]CLOSe <channel_list> command, the last channel
specified will be closed. For example, the commands
route:configure:join m2,(1:6)
route:close:mode scan,m2,(1:6)
join the commons of all six sections of the VX4330 Module and set the mode of
the [ROUTe]:CLOSE <channel_list> to scan mode for all six sections of the
VX4330.
The command
route:close (@m2(1!1,1!6))
will then result in channel 1 of section 6 being closed and all other channels on
the module being opened.
3–8
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Syntax
output queue The Output queue of the Option 01 VXI Interface is used to return
replies to queries received by the interface. Bit 4 (the MAV bit) of the Status
Byte register is set to indicate that this queue is not empty. The DOR bit in the
VXI Response register is also set to indicate that this queue is not empty. The
commander of the Option 01 VXI Interface monitors the DOR bit to determine
when it may read a message from the Output queue.
<section_list> One or more <nr1> fields separated by comma (,) or colon (:)
characters and enclosed in left and right parentheses. A <section_list> is used to
specify the sections of a relay module to be acted upon by a [ROUTe:]CONFigure or [ROUTe:]CLOSe:MODE command. The following are examples of valid
<section list>s:
For commands directed to a VX4330 which has six scanner sections:
<section_list> Sections Specified
(1:6) Sections 1 through 6
(1,2,3) Sections 1, 2 and 3
(1:3,5:6) Sections 1 through 3 and 5 and 6
(1:3,5,6) Same as previous example
(3) Section 3
error/event queue When the command parser detects a syntax error or data range
error, it places an error message describing the error in the Error/Event queue.
Bit 2 of the Status Byte Register is set to indicate that this queue is not empty.
Bit 5 of the Standard Event Status Register (the Command Error bit) is set if the
parser detects a syntax error. Bit 4 of the Standard Event Status register (the
Execution Error bit) is set if the parser detects a numeric argument that is out of
range. When a SYSTem:ERRor? query is received, an error message is removed
from the Error/Event queue and placed in the Output queue.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–9
Command Syntax
3–10
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Functional Command Groups
This section lists the VX4351 system and module commands.
System Commands
The following low-level commands are typically sent by the module’s commander, and are transparent to the user of the module. (An exception is the Read STB
command, which is sent whenever a Serial Poll on an IEEE-488 system is
performed.) Most commanders or Slot 0 devices have specific ASCII commands
that cause the commander to send one of these low-level commands to a
specified instrument. Refer to the operating manual of the commander or Slot 0
device for information on these commands.
Command Effect
Begin Normal Operation The module begins operation if it has not already done so.
Byte Available Transfers module commands to this module.
Byte Request Requests the module to return a byte of data from the output
queue.
Clear The module clears its VXIbus interface and any pending
commands. Current module operations are unaffected.
Clear Lock Clears the Lock bit of the Response register.
Read Protocol The module returns its protocol to its commander.
Read STB The module returns its VXI status byte to its commander.
Set Lock Set the Lock bit of the Response register.
Trigger Close the next relay in a scan list that has been defined
by a ROUTe:SCAN <channel_list> command. A VXI Trigger
command is enabled as a trigger source by a
ROUTe:SEQuence:SOURce BUS command.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–11
Functional Command Groups
Module Commands
A summary of the VX4351-specific and IEEE-488.2 Common Commands is
listed in Tables 1–6 and 1–7 below. The next section, Command Descriptions,
includes detailed descriptions of each command. Appendix C: Examples shows
examples of command usage.
T able 1–6: Summary of VX4351-Specific SCPI Commands
Subsystem Command Functions Controlled
CLOSe Close specified relays; DWELl
ID? Return model numbers of modules controlled by the Option 01
MODule Module name functions: DEFine, CATalog?, DELete
OPEN Open specified relays: ALL, DWELl
ST ATus Status register functions: OPERation, QUEStionable
SYSTem System-level functions: ERRor?, PRESet, VERSion?
CONFigure Configure for two- or one-wire operation
T able 1–7: Summary of IEEE-488.2 Common Commands
Command/Syntax Description
Clear Status
*CLS
Standard Event Status Enable
*ESE <NRf>
Standard Event Status Enable Query
*ESE?
Standard Event Status Register Query
*ESR?
Identification Query
*IDN?
Operation Complete
*OPC
Operation Complete Query
*OPC?
Reset*
*RST
Clears the SCPI and IEEE 488.2 event registers and
the SCPI error/event queue, and the output queue.
Sets the contents of the Standard Event Status Enable
register.
Returns the current value of the Standard Event
Status Enable register in <nr1> format.
Returns the current value of the Standard Event
Status register in <nr1> format, then sets the contents
of this register to 0.
Returns an ASCII string in the output queue which
identifies the board.
Sets bit 0 (the Operation Complete bit) of the
Standard Event Status register when all pending
device operations have been completed.
Places the ASCII character 1 in the output queue
when all pending device operations have been
completed.
The Option 01 VXI interface is placed in its power-up
state with some exceptions.
3–12
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Functional Command Groups
T able 1–7: Summary of IEEE-488.2 Common Commands (Cont.)
Command/Syntax Description
Service Request Enable
*SRE <NRf>
Sets the contents of the Service Request Enable
register.
Service Request Enable Query
*SRE?
Read Status Byte Query
*STB?
Trigger
*TRG
Self-Test Query
*TST?
Wait-to-Continue
*WAI
Returns the current value of the Service Request
Enable register in <nr1> format.
Returns the current value of the Status Byte register in
<nr1> format.
Equivalent to a VXI Trigger command.
Performs a self test of the Option 01 VXI Interface
daughter board and any relay modules under its
control. Place a “0” or “1” into the output queue to
indicate whether the self test passed or failed.
Does not execute any further commands or queries
until all pending operations have been completed.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–13
Functional Command Groups
3–14
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Descriptions
This section lists the VX4351-specific SCPI commands and queries in alphabetic
order. The IEEE-488.2 Common Commands are listed in the next section. A
summary listing of the SCPI command set for the VX4351 is as follows:
[ROUTe:]CLOSe <channel_list>
[ROUTe:]CLOSe:DWELl <module_name>,<nrf>
[ROUTe:]CONFig OWIRE | TWIRE
[ROUTe:]ID?
[ROUTe:]MODule[:DEFine] <module_name>,<nrf>
[ROUTe:]MODule:CATalog?
[ROUTe:]MODule:DELete[:NAME] <module_name>
[ROUTe:]MODule:DELete:ALL
[ROUTe:]OPEN <channel_list>
[ROUTe:]OPEN:ALL [module_name]
[ROUTe:]OPEN:DWELl <module_name>,<nrf>
OUTPut:TTLTrg<n>[:STATe] ON | OFF | <nrf>
STATus:OPERation:CONDition?
STATus:OPERation:ENABle
STATus:OPERation[:EVENt?]
STATus:QUEStionable:CONDition?
STATus:QUEStionable:ENABle
STATus:QUEStionable[:EVENt?]
SYSTem:ERRor?
SYSTem:PRESet
SYSTem:VERSion?
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–15
Command Descriptions
CLOSe
Command Syntax
Query Syntax
Query Response
*RST Value
Limits
"#
"#
Indicates which relays are closed.
All relays on all modules are set to the open position.
The syntax of a <channel_list> is described by the following diagram:
!
"#
Related Commands
Description
!
$
A module_name is an ASCII string that has been associated with a relay module
in a [ROUTe:]MODule[:DEFine] command. A channel_range may consist of a
single <channel_spec> or a range of <channel_spec>s. A range of <channel_spec>s consists of two <channel_specs> separated by a colon (:) character.
For the VX4351, a <channel_spec> is defined as an ASCII-encoded integer in
the range of 1 to 40.
[ROUTe:]OPEN <channel_list>
[ROUTE:]CLOSe:DWELl
[ROUTe:]MODule:DEFine
This command closes the relays specified in the <channel_list> portion of this
command. After these relays are closed, a delay specified in a previously issued
[ROUTe:]CLOSe:DWELl command is generated. The DWELl command is used
3–16
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Descriptions
to assign a close delay to each module controlled by an Option 01 daughter
board module. If more than one module is specified in the <channel_list>
argument of the [ROUTe:]CLOSe command, the longest dwell time assigned to
any of the specified modules is used.
Examples
Command Syntax
In this example, the Option 01 is installed on a VX4351 Module. Two additional
VX4351 Modules are installed in consecutive slots to the right of the first
VX4351. The default module names for these three modules are m1, m2, and
m3. These module names may be altered with the [ROUTe:]MODule[:DEFine]
command.
Command Response
route:close:dwell m1,.1 Assign a close dwell time of 0.1 seconds to the first VX4351.
route:close:dwell m2,.2 Assign a close dwell time of 0.2 seconds to the second
VX4351.
route:close:dwell m3,.5 Assign a close dwell time of 0.5 seconds to the third VX4351.
route:close (@m1(1:10)) Close channels 1 through 10 on the first VX4351, then wait 0.1
seconds.
route:close (@m2(15)) Close channel 15 on the second VX4351, then wait 0.2
seconds.
close (@m1(20),m2(30),
m3(40))
Close channel 20 on the first VX4351, channel 30 on the
second VX4351, and channel 40 on the third VX4351. Wait 0.5
seconds.
[ROUTe:]CLOSe
:DWELl<module_name>,<nrf>
Query Syntax
*RST Value
Limits
N/A
The close dwell time of all modules is set to 0 seconds.
The value of the time specified in this command must be between 0 and 6.5535
seconds.
Related Commands
[ROUTE:]CLOSe
[ROUTe:]OPEN
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–17
Command Descriptions
Description
Examples
Set the time to wait after closing a relay before proceeding. The dwell time is
applied to the command rather than to individual relays in the <channel_list>.
Relays in the <channel_list>. Relays in the channel_list are operated simultaneously.
In this example the Option 01 is installed on a VX4351 Module.
Command Response
route:close:dwell m1,.25 Set the close dwell time for the VX4351 to 0.25 seconds.
route:open:dwell m1,0.5 Set the open dwell time for the VX4351 to 0.5 seconds.
route:close (@m1 (1;10)) Close relays 1 through 10 and wait .25 seconds.
route:open (@m1 (6)) Open relay 6 and wait .5 seconds
3–18
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
CONFig
Command Descriptions
Command Syntax
Query Syntax
*RST Value
Limits
Related Commands
Description
[ROUTe:]CONFig [OWIRE | TWIRE], <module name>, 1
N/A
The configuration of the module is set to OWIRE.
Subsequent <channel list>s are limited to a maximum value of 20 in TWIRE.
[ROUTe]:CLOSE
[ROUTe]:OPEN
This command causes relays numbered 21 through 40 to be operated in parallel
with relays number 1 through 20, when TWIRE configuration is selected. The
range of <channel_lists>s in subsequent commands are limited to 1 through 20.
All relays are opened when this command is issued.
NOTE. The trailing “1” of the command is a dummy argument, but is required by
SCPI syntax.
Examples
In this example, the Option 01 is installed on a VX4351 module. The default
module name is “m1.”
Command Response
route:close (@m1(23:25)) Relays 23, 24, and 25 are closed.
route:conf twire, m1,1 All relays opened, VX4351 placed in two-wire mode.
route:close (@m1(3:5)) Relays 3, 4, 5, 23, 24, and 25 are closed.
route:close (@m1(1:20)) Close query returns
001 11000000000000000
route:conf owire, m1, 1 All relays opened, VX4351 returned to single-wire mode.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–19
Command Descriptions
ID?
Command Syntax
*RST Value
Limits
Related Commands
Description
Examples
N/A
N/A
[ROUTe:]MODule:CATalog?
This query returns a list of the model numbers of the modules controlled by the
Option 01. The first model number returned is that of the module that the Option
01 is installed on. Subsequent model numbers are those of modules in consecutive slots to the right of the first module.
In these examples the Option 01 is installed on a VX4351 Module. A VX4381,
VX4330, and VX4320 are installed in consecutive slots to the right of the slot
containing the VX4351. The default module names for the VX4351, VX4381,
VX4330 and VX4320 in this configuration are m1, m2, m3, and m4 respectively.
These module names may be altered with the [ROUTe:]MODule:DEFine
command.
3–20
Command Response
route:id? VX4351, VX4381, VX4330, VX4320
route:module:Catalog? “M1”, “M2”, “M3”, “M4”
route:close (@m1(1)) Close relay number 1 on the VX4351.
route:open:all m2 Open all relays on the VX4381.
route:close (@m3(1!6)) Close relay number 1 in section 6 of the VX4330
route:close (@m4(3!1:3!8)) Close relay number 3 in all eight sections of the VX4320.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
MODule
Command Descriptions
Command Syntax
Query Syntax
Query Response
*RST Value
Limits
[ROUTe:]MODule
[:DEFine] <module_name>,<nrf>
[ROUTe:]MODule
[:DEFine]? <module_name>
See examples.
Default module names are assigned as follows:
The module that has an Option 01 VXI Interface daughter board installed is
assigned module name “M1”.
Modules without the Option 01 VXI Interface daughter board in consecutive
slots to the right of module “M1” are assigned module names “M2”, “M3”, ...,
“M11”.
A module name may consist of up to 12 characters. The name must start with a
letter and may consist of alphanumeric characters, underscores, and digits.
Related Commands
Description
Examples
[ROUTe]:MODule:DELete[:NAME]
[ROUTe]:MODule:DELete[:ALL]
[ROUTe:]MODule:CATalog?
This command assigns a module name to a relay switching module. This name is
used to identify the module in channel lists in [ROUTe:]OPEN,
[ROUTe:]CLOSe, and [ROUTe:]SCAN commands.
In these examples the Option 01 is installed on a VX4351 Module.
Command Response
route:module:define hi_current,1
route:close (@hi_current(1:40))
route:module:define? hi_current
Assign module name “hi_current” to the VX4351.
Close all 40 relays on the VX4351.
1
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–21
Command Descriptions
Command Syntax
*RST Value
Limits
Related Commands
Description
Examples
N/A
N/A
[ROUTe]:MODule:DEFine[:NAME]
[ROUTe]:MODule:DELete[:NAME],
[ROUTe]:MODule:DELete[:ALL]
This command returns a list of defined module names.
In these examples the Option 01 is installed on a VX4351 Module. Two
additional VX4351 Modules are installed in consecutive slots to the right of the
slot containing the first VX4351.
Command Response
route:module:catalog? “M1”, “M2”, “M3”
route:module:define hi_cur-
rent,2
route:module:catalog? “M1”, “hi_current”, “M3”
route:module:define?
hi_current
route:module:delete hi_current Delete module name “hi_current”
route:module:catalog? “M1”, “M3”
Assign module name “hi_current” to the second VX4351.
2
3–22
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Descriptions
Command Syntax
Query Syntax
*RST Value
Limits
Related Commands
Description
[ROUTe:]MODule
:DELete
[:NAME] <module_name>
N/A
N/A
N/A
[ROUTe]:MODule:DEFine[:NAME]
[ROUTe]:MODule:CATalog?
[ROUTe:]MODule:DELete[:ALL]
This command deletes a module name definition. After this command is
executed, the specified module name is no longer associated with a relay
module.
Examples
Command Syntax
Query Syntax
*RST Value
Limits
Command Response
route:module:catalog? “M1”, “M2”, “M3”
route:module:delete m1 Delete module name “M1”
route:module:catalog? “M2”, “M3”
[ROUTe:]MODule
:DELete
:ALL
N/A
N/A
N/A
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–23
Command Descriptions
Related Commands
Description
Examples
[ROUTe]:MODule:DEFine[:NAME]
[ROUTe]:MODule:CATalog?
[ROUTe:]MODule:DELete[:NAME]
This command will delete all module name definitions.
Command Response
route:module:catalog? “M1”, “M2”, “M3”
route:module:delete:all Delete all module names
route:module:catalog? “ ”
3–24
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
OPEN
Command Descriptions
Command Syntax
Query Syntax
Query Response
*RST Value
Limits
"#
"#
See examples.
All relays on all modules are set to the open position.
The syntax of a <channel_list> is described by the following diagram:
!
"#
Related Commands
Description
!
$
A module_name is an ASCII string that has been associated with a relay module
in a [ROUTe:]MODule[:DEFine] command. A channel_range may consist of a
single <channel_spec> or a range of <channel_spec>s. A range of <channel_spec>s consists of two <channel_specs> separated by a colon (:) character.
For the VX4351, a <channel_spec> is defined as an ASCII-encoded integer in
the range of 1 to 40, or 1 to 20 when in two-wire mode.
[ROUTe:]CLOSe <channel_list>
[ROUTe:]MODule:DEFine
[ROUTE:]OPEN:DWELl
This command opens the relays specified in the <channel_list> portion of this
command. After these relays are opened, a previously specified delay is
generated. The delay is applied to the command, rather than to the individual
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–25
Command Descriptions
relays in the <channel_list>. Relays in the <channel_list> are operated simultaneously.
The [ROUTe:]OPEN:DWELl command assigns an open delay to each module
controlled by an Option 01 Module. If more than one module is specified in the
<channel_list> argument of the [ROUTe:]OPEN command, the longest dwell
time assigned to any of the specified modules is used.
Examples
In the following example, the Option 01 VXI interface is installed
on a VX4351 Module. Two additional VX4351 Modules are installed in
consecutive slots to the right of this module.
Command Response
route:open:dwell m1,.1 Assign an open dwell time of 0.1 seconds to the first VX4351.
route:open:dwell m2,.2 Assign an open dwell time of 0.2 seconds to the second
VX4351.
route:open:dwell m3,.5 Assign an open dwell time of 0.5 seconds to the third VX4351.
route:open (@m1(1:10)) Open channels 1 through 10 on the first VX4351, then wait 0.1
seconds.
route:open (@m2(15)) Open channel 15 on the second VX4351, then wait 0.2
seconds.
open (@m1(20),m2(30),
m3(40))
Open channel 20 on the first VX4351, channel 30 on the
second VX4351, and channel 40 on the third VX4351, then
wait 0.5 seconds.
3–26
Command Syntax
Query Syntax
*RST Value
Limits
Related Commands
[ROUTe:]OPEN
:ALL [module_name]
N/A
All relays on all modules are set to the open position.
N/A
[ROUTe:]CLOSe
[ROUTe:]MODule:DEFine
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Descriptions
Description
Examples
Command Syntax
If a module name is not specified in this command, open all relays on all
modules controlled by the Option 01. If a module name is specified, open all
relays on the specified module only. This command is not supported for VX4320
Modules. If a [ROUTe:]OPEN:ALL command is directed to a VX4320 Module,
an error message will be placed in the Error/Event queue.
Command Response
ROUTE:OPEN:ALL Open all relays on all Modules controlled by the Option 01.
rout:open:all Same as the first example.
route:open:all hi_current Open all relays on the module that has been assigned module
name “hi_current”. See the [ROUTe:]MODule:DEFine
command.
[ROUTe:]OPEN
:DWELl <module_name>,<nrf>
Query Syntax
*RST Value
Limits
Related Commands
Description
Examples
N/A
The open dwell time of all modules is set to 0 seconds.
The value of the time specified in this command must be between 0 and 6.5535
seconds.
[ROUTE:]OPEN
This command sets the time to wait after opening a relay before proceeding.
In this example the Option 01 is installed on a VX4351 Module.
Command Response
route:close:dwell m1,.25 Set the close dwell time for the VX4351 to 0.25 seconds.
route:open:dwell m1,0.5 Set the open dwell time for the VX4351 to 0.5 seconds.
ROUTE:close (@m1(8)) Close channel 8 of the VX4351, then wait .25 seconds.
route:open (@m1(8)) Open channel 8 then wait .5 seconds.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–27
Command Descriptions
OUTPut
Command Syntax
Query Syntax
Query Response
*RST Value
Related Commands
Description
OUTPut
:TTLTrg<n>
[:STATe] ON | OFF | <nrf>
OUTPut
:TTLTrg<n>
[:STATe]?
Indicates whether a VXI TTL trigger is enabled.
ROUTe:CLOSe
One or more VXI TTL triggers may be enabled. Triggers that are enabled are
pulsed low for 3 msec after a relay is closed by the Option 01 after a time
specified by the ROUTe:CLOSe:DWELl command.
3–28
Examples
Command Response
output:ttltrg1:state on Enable driving VXI TTL trigger 1.
outp:ttlt2 off Disable driving VXI TTL trigger 2.
outp:ttlt7:stat 1 Enable driving VXI TTL trigger 7.
output:ttltrg4:state? 1
This response indicates that VXI TTL trigger 4 is enabled.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
STATus
Command Descriptions
Command Syntax
*RST Value
Limits
Related Commands
Description
Examples
STATus
:OPERation
:CONDition?
0
N/A
N/A
This query returns the contents of the SCPI Status Operation Condition register.
For the Option 01, the value of this register is always equal to 0.
Command Response
status:operation: condition? 00000
Command Syntax
Query Syntax
*RST Value
Limits
Related Commands
STATus
:OPERation
:ENABle
STATus:
OPERation
:ENABle?
0
N/A
N/A
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–29
Command Descriptions
Description
Examples
Command Syntax
*RST Value
Limits
This command sets the contents of the SCPI Status Operation Event Enable
register.
Command Response
status:operation:
enable 1
stat:oper:enab? 00001
STATus
:OPERation
[:EVENt?]
0
N/A
No response
Related Commands
Description
Examples
Command Syntax
*RST Value
N/A
This query returns the contents of the SCPI Status Operation Event register. For
the Option 01, the value of this register is always equal to 0.
Command Response
status:operation: event? 00000
STATus
:QUEStionable
:CONDition?
0
3–30
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Descriptions
Limits
Related Commands
Description
Examples
Command Syntax
N/A
N/A
This query returns the contents of the SCPI Status Questionable Condition
register. For the Option 01, the value of this register is always equal to 0.
Command Response
status:questionable: condition?
STATus
:QUEStionable
:ENABle
00000
Query Syntax
Query Response
*RST Value
Limits
Related Commands
Description
STATus
:QUEStionable
:ENABle?
Indicates whether the Status Operation Event is enabled.
0
N/A
N/A
This command sets the contents of the SCPI Status Operation Event Enable
register.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–31
Command Descriptions
Examples
Command Syntax
*RST Value
Limits
Related Commands
Description
Command Response
status:questionable: enable 1 No response
stat:ques:enab? 00001
STATus
:QUEStionable
[:EVENt?]
0
N/A
N/A
This query returns the contents of the SCPI Status Questionable Event register.
For the Option 01, the value of this register is always equal to 0.
3–32
Examples
Command Response
status:questionable: event? 00000
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
SYSTem
Command Descriptions
Command Syntax
Query Response
Parameter “y” in these error messages represents the local bus address of the
module that the error message applies to. A value of 1 indicates the module
containing the Option 01 daughter board, a value of 2 indicates the module in the
next slot to the right, and so on.
0,“No error”
-102, “Syntax error; 1 dimensional <channel_spec> invalid for VX4330
module”
-102, “Syntax error; 2 dimensional <channel_spec> invalid for VX4351
module”
-102, “Syntax error; 3 dimensional <channel_spec> invalid for VX43xx
module”
-102, “Syntax error; channel dimension mismatch”
-102, “Syntax error; integer field greater than 10 characters”
-102, “Syntax error; Missing module name”
-102, “Syntax error; Module address not specified”
-102, “Syntax error; Module name already defined”
-102, “Syntax error; Module name length greater than 12 characters”
-102, “Syntax error; Non-contiguous section numbers”
-102, “Syntax error; ROUTe:CONFigure command invalid for VX43xx module”
-102, “Syntax error; ROUTe:DISJoin command invalid for VX43xx module”
-102, “Syntax error; ROUTe:JOIN command invalid for VX43xx module”
-102, “Syntax error; ROUTe:MODE command invalid for VX43xx module”
-102, “Syntax error; Undefined module name”
-102, “Syntax error; Unexpected x detected while ...”
-121, “Invalid character in number”
-123, “Exponent too large”
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–33
Command Descriptions
-200, “Execution error; Reserved”
-200, “Execution error; Scan list undefined”
-211, “Trigger ignored”
-213, “Init ignored”
-222, “Data out of range; Channel number x on module y”
-222, “Data out of range; Channel number x!x on module y”
-222, “Data out of range; Channel number x!x!x on module y”
-222, “Data out of range; Invalid module address specified”
-222, “Data out of range; Invalid section number”
-222, “Data out of range; Invalid sequence count”
-222, “Data out of range; Invalid trigger delay”
*RST Value
-222, “Data out of range; Invalid VXI TTL Trigger level”
-222, “Data out of range; Maximum value for ESE command is 255”
-222, “Data out of range; Maximum value for SRE command is 255”
-222, “Data out of range; Invalid dwell time specified.”
-223, “Too much data; Channel list array overflow”
-223, “Too much data; Input buffer overflow”
-223, “Too much data; Output buffer full”
-223, “Too much data; Scan list array overflow”
-240, “Hardware error; Shift register verification error - module y”
-240, “Hardware error; Unrecognized module x, y”
-350, “Queue overflow; Error/event queue”
-350, “Queue overflow; Output queue”
The error/event queue is empty.
3–34
Limits
Related Commands
N/A
*ESR?,
*STB?
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Command Descriptions
Description
Examples
Command Syntax
Query Syntax
*RST Value
If an error condition is detected by the Option 01, it places an error message
describing the condition in the error/event queue. The SYSTem:ERRor? query
requests the Option 01 to remove the oldest message in the error/event queue and
place it into the output queue. If the error/event queue is empty, a “No error”
message is placed in the output queue.
Command Response
SYSTEM:ERROR? 0, “No error”
syst:err? –222,“Data out of range; Invalid section number”
N/A
N/A
Limits
Related Commands
Description
N/A
*RST
This command places the Option 01 daughter board and the switching modules
that it controls in the power-on state. This command has the same effect as the
*RST command, with the following exceptions: the SYSTem:PRESet command
clears
the Output queue,
the Error/Event queue,
the Standard Event Status Enable register,
the SCPI Status Operational Enable register, and
the SCPI Status Questionable Enable register.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–35
Command Descriptions
Examples
Command Syntax
*RST Value
Limits
Related Commands
Description
Command Response
system:preset No response
syst:pres No response
N/A
N/A
None
This query returns the following ASCII string in the output queue:
“1994.0”
Examples
Command Response
system:version? “1994.0”
syst:vers? “1994.0”
3–36
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
IEEE-488.2 Common Commands
This section lists the IEEE-488.2 common commands and queries recognized by
the VX4351.
*CLS
Clear Status. This commands clears the following:
Event Status register (ESR)
Error/Event queue
Output queue
*ESE <NRf>
Event Status Enable (ESE) command. This command defines the mask for
setting the Event Status Summary bit (bit 5) in the Status Byte register (*STB?).
The mask is logically ANDed with the Event Status register (*ESR?) to
determine whether or not to set the Event Status Summary bit. The mask can be
any numeric value from 0 to 255, corresponding to the encoded bits of the ESR
register. A “1” in a bit position enables reporting of the function. A “0” disables
it. The *ESE register is cleared at power-on, or by writing an *ESE 0 command
only. If <mask> is not specified, it defaults to 0.
For example, the command *ESE 37 (hexadecimal 25, binary 00100101) enables
setting the Event Status Summary bit whenever an operation is complete, a query
error is detected, or an execution error is detected.
*ESE?
Event Status Enable (ESE) query. This command returns the value of the Event
Status Enable register as a numeric value from 0 to 255. For example, a value of
32 (hexadecimal 20, binary 00100000) indicates that command error reporting is
enabled.
*ESR?
Event Status Register (ESR) query. This command returns the value of the Event
Status register. The *ESR command is destructively read (that is, read and
cleared). The Event Status Summary bit in the Status Byte (*STB?) is also
cleared by a read of the ESR. The ESR is set to 128 on power-on (bit 7) set. It is
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–37
IEEE 488.2 Common Commands
cleared by an *ESR? or *CLS command only. When converted to a binary
number, the bits of the ESR correspond to:
bit 0 (LSB) Operation Complete
1 Request Control
2 Query error
3 Device Dependent error
4 Execution error
5 Command error
6 User Request
7 (MSB) Power On
The Error bits are set whenever the module detects an error. The error values
from -100 to -199 are Command errors. Error values from -200 to -299 are
Execution errors. Error values from -300 to -399 are Device Dependent errors.
Error values from -400 to -499 are Query errors (see the SYSTem:ERRor
command description).
The Request Control and User Request bits are unused, and are always reported
as zeroes.
*IDN?
The Operation Complete bit is set in response to an *OPC command. A “1”
indicates that the module has completed all pending commands and queries.
Identification query. This returns a 4-field response. Field 1 is the manufacturer,
field 2 the model, field 3 the serial number, and field 4 contains both the SCPI
and the firmware version levels. For the VX4351, the serial number field is
always a 0. The response syntax is:
where X.X indicates the firmware revision level and where xx indicates the model
number of the relay module on which the Option 01 is installed:
Value of xx Model Number
20 VX4320
30 VX4330
50 VX4350
51 VX4351
80 VX4380
81 VX4381
3–38
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
*OPC
*OPC?
*RST
IEEE 488.2 Common Commands
Operation Complete. This command causes the module to set the Operation
Complete bit in the Event Status register (ESR) when all pending commands and
queries are complete.
Operation Complete query. This command causes the module to place a “1” in
the Output queue when all pending commands and queries are complete. All
commands following *OPC are suspended until the pending operations are
complete. The *OPC? command does not affect the OPC bit in the Event Status
register.
Reset. This command causes the Option 01 to open all relays on all modules
under its control. This command sets the Option 01 Module to its power-on state
with the following exceptions: the Error/Event queue, Output queue, Standard
Event Status Enable register, SCPI Status Operation Event Enable register and
SCPI Status Questionable Event Enable register are not cleared.
The condition of the Option 01 daughter board and the switching modules that it
controls after receipt of a *RST command is as follows:
Contents of the SCPI Status Operation Event register = 0
Contents of the SCPI Status Operation Condition register = 0
Contents of the SCPI Status Questionable Event register = 0
Contents of the SCPI Status Questionable Condition register = 0
All VXI TTL triggers are disabled
Trigger subsystem is in the idle state
Trigger source = IMMediate
Number of times to sequence through an entire scan list = 1
Time in seconds to wait after a trigger event is detected before sequencing to
the Next relay in a scan list = 0
All relays on all modules are set to the open position
No scan list is defined
Default module names are assigned as follows:
The module that has a Option 01 VXI Interface daughter board installed
is assigned module name “M1.”
Modules without the Option 01 VXI Interface daughter board in
consecutive slots to the right of module “M1” are assigned module
names “M2”, “M3”, ..., “M11.”
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–39
IEEE 488.2 Common Commands
*SRE <mask>
All sections on all scanner modules are disjoined
All sections of all VX4330 Modules are set to operate in the mux mode
Close dwell time of all modules is set to 0 seconds
Open dwell time of all modules is set to 0 seconds
All relays on all modules are opened when power is removed from the VXI
chassis
Service Request Enable (SRE) register. This command defines a mask that is
ANDed with the contents of the Status Byte register. If the result of this
operation is non-zero, the Option 01 generates a VXI Request True interrupt.
Bits 0, 1, 3, 6, and 7 of the SRE register are not used. Bits 2, 4, and 5 are set to
enable VXI Request True interrupts to be generated under the conditions listed in
the following table.
Bit No. Meaning
bit0 (LSB) Not used
*SRE?
1 Not used
2 The Error/Event queue contains one or more error messages.
3 Not used
4 The Output queue contains one or more query responses.
5 The contents of the Standard Event Status register ANDed with the
contents of the Standard Event Status Enable register produces a
non-zero result.
6 Not used
7 Not used
Service Request Enable (SRE) query. This command returns the value of the
Service Request Enable register as a numeric value from 0 to 255. Bit 6 is
unused, and is reported as zero.
3–40
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
*STB?
IEEE 488.2 Common Commands
Status Byte Query. This query returns the value of the Status Byte register as a
numeric value between 0 and 255. The Status Byte register contents (with the
exception of bit 6) are also returned in response to a VXI Read STB command.
Bit 6 is read destructively in response to a VXI Read STB command. Bit 6 is not
read destructively in response to a *STB? query. The Status Byte register is
encoded as follows:
Bit No. Meaning
bit 0 (lsb) Not used
bit 1 Not used
bit 2 Set when the Error/Event queue contains one or more error messages.
bit 3 Not used
bit 4 Set when the Output buffer contains one or more query responses.
bit 5 Set when the contents of the Standard Event Status register ANDed
with the contents of the Standard Event Status Enable register
produces a non-zero result.
bit 6 Set when the contents of bits 0 through 5 and bit 7 of the Status Byte
register ANDed with the contents of the Service Request Enable
register produce a non-zero result.
If bit 6 becomes set, the Option 01 will generate a VXI Request True
interrupt on the VME interrupt level selected by its interrupt level select
switch. If bit 6 becomes set and the Status Byte register is read using a
VXI Read STB command, bit 6 will be reported as being set. In
response to subsequent VXI Read STB commands, bit 6 will be
reported as being cleared.
If bit 6 becomes set and the Status Byte register is read using a *STB?
query , bit 6 will be reported as being set. Bit 6 will continue to be
reported as set in response to *STB queries until the contents of bits 0
through 5 and bit 7 of the Status Byte register ANDed with the contents
of the Service Request Enable register is equal to 0.
bit 7 Not used.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–41
IEEE 488.2 Common Commands
*TRG
Trigger Command. This command is equivalent to a VXI Trigger command.
This command is valid only after the following commands have been received
by the Option 01:
Command Description
[ROUTe:]SCAN
<channel_list>
Define a scan list
TRIGger
[:SEQuence]
:SOURce BUS
INITiate[:IMMediate] Initiate the scan list. This command places the trigger
Select a VXI Trigger command as a trigger source.
subsystem in the “ARM” state. The trigger subsystem remains
in this state until the Option 01 has sequenced through the
entire scan list “n” times, where “n” has been previously
specified in a TRIGger[:SEQuence]:COUNT command. The
trigger subsystem then returns to the IDLE state. The trigger
subsystem also returns to the IDLE state if an ABORt
command is received by the Option 01.
After these commands have been issued, a *TRG command will cause the
Option 01 to take the following actions:
Generate a trigger delay that has previously been specified in a
TRIGger [:SEQuence]:DELay command.
Open the currently closed channel.
Generate the open delay that has previously been specified in a
[ROUTe:]OPEN:DWELl command.
Close the next channel in the scan list.
3–42
Generate the close delay that has previously been specified in a
[ROUTe:]CLOSe:DWELl command.
Pulse one or more VXI TTL trigger signals that have been enabled by a
previously issued OUTPut:TTLTRG<n>[:STATe] ON command.
If the module containing the channel is a scanner module, pulse the
appropriate front panel encode signal.
If another *TRG command is received before this sequence is complete, a SCPI
-211,“Trigger ignored” error message will be placed in the Error/Event queue.
The *TRG command will continue to have this effect until the trigger subsystem
is placed in the IDLE state. If additional *TRG commands are received after the
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
*TST?
IEEE 488.2 Common Commands
trigger system is placed in the IDLE state, the Option 01 will place a SCPI
-211,“Trigger Ignored” error message in the Error/Event queue.
The IEEE-488.2 Specification equates the *TRG command with an IEEE-488.1
Group Execute Trigger (GET) command. IEEE-488-to-VXI interface modules
typically convert IEEE-488.1 GET commands to VXI Trigger commands. For
this reason, the Option 01 equates the *TRG command with a VXI Trigger
command.
Self Test query. In response to this query, the Option 01 performs a self test of
each of the switching modules under its control. During self test, the Option 01
verifies that it can properly control the relay drive circuitry of each switching
module under its control. After the self test is complete, each module is restored
to its pretest state. If all modules pass self test, an ASCII “0” is placed in the
Output buffer. If one or more modules fail the self test, an ASCII “1” is placed in
the Output buffer and error message(s) describing the failure are queued in the
Error/Event queue. Issue a SYSTem:ERRor? query to read these error messages.
*WAI
Wait to Continue. This command causes the module to wait until all pending
commands and queries are complete. All commands following *WAI are
suspended until the pending operations are complete.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
3–43
IEEE 488.2 Common Commands
3–44
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Status and Events
Status and Events
The Status and Event Reporting System reports asynchronous events and errors
that occur in the VX4351 40-Channel, 10 Amp, SPST Switch Module. This
system consists of four 8-bit registers and two queues that you access through
the command language. You can use these registers and queues to query the
instrument status and control the interrupts that report events.
In general, after an interrupt occurs, first conduct a serial poll, query the registers
to see why the interrupt occurred, and then send the SYSTem:ERRor? query to
see a descriptive error message.
This section describes the four registers and two queues of the Status and Event
Reporting system. For each register, you are given a description, a table
describing all of the bits, and an example of how to use the register.
The Status and Event Reporting process, synchronizing programming commands, and the system messages are also described in this section.
Status and Event Reporting System
Status Byte Register
The Status and Event Reporting system monitors and reports such events as an
error occurring or the availability of a response to a query. This system includes
descriptions of the following registers and queues:
Status Byte register
Service Request Enable register
Standard Event Status register
Event Status Enable register
Output queue
System Error and Event queue
The Status Byte register, shown in Table 2–1, summarizes information from
other registers. Use a serial poll or a *STB? query to read the contents of the
Status Byte register. The response is the sum of the decimal values for all bits
set. When you use a serial poll, bit 6 shows Request Service information. When
you use the *STB? query, bit 6, the Master Status Summary bit, indicates that
bits 5, 4, or 2 may be set.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
4–1
Status and Events
T able 2–1: The Status Byte Register
Decimal
Bit
0-1 – Not used.
2 4 Error/Event queue Not Empty indicates that information is
3 – Not used.
4 16 Message Available shows that output is available in the Output
5 32 Event Status Bit indicates that one or more events have occurred
6 64 Request Service (obtained from a serial poll) shows that the
7 – Not used.
Value
Function
contained in the Error/Event queue and is waiting to be read.
queue.
and the corresponding bits in the Standard Event Status register
have been set.
VX4351 has requested service from the GPIB controller.
Master Status Summary (obtained from *STB? query) summarizes
the Event Status bit, Message Available bits, and Error/Event
queue Not Empty bits in the Status Byte register.
Service Request Enable
Register
A common example of using the Status Byte register is to enable the Message
Available bit. This is done by sending an *SRE 16 command to the Option 01
VXI Interface Module. If the *STB? query returns a value of 80, bit 4 (decimal
value of 16) and bit 6 (decimal value of 64) have been set (giving a decimal sum
of 80). Bit 4 indicates that a message is available in the output queue. Bit 6
indicates that a bit in the Status Byte register that has been enabled by setting the
corresponding bit in the Service Request Enable register (in this case bit 4) has
been set.
The Service Request Enable register, shown in Table 2–2, controls which bits in
the Status Byte register will generate a service request. Use the *SRE command
to set bits in the Service Request Enable register. Use the *SRE? query to see
which bits in this register are enabled. The response from this query is the sum
of the decimal values for all bits set.
T able 2–2: The Service Request Enable Register
Decimal
Bit
0-1 – Not used
2 4 Error/Event queue Bit indicates that a service request will be
Value
Function
generated when a message is placed in the Error/Event queue.
4–2
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Status and Events
T able 2–2: The Service Request Enable Register (Cont.)
Decimal
Bit Function
3 8 Not used
4 16 Message Available Bit indicates that a service request will be
5 32 Event Status Bit indicates that events summarized in bit 5 of the
6-7 – Not used
Value
generated when a message is placed in the Output queue.
Status Byte register will generate a service request.
If, for example, the *SRE? query returns a value of 48, bits 4 and 5 are set in the
Service Request Enable register. Any event that causes the Message Available bit
(bit 4) or Event Status bit (bit 5) to be set in the Status Byte register now
generates an interrupt. If you want an interrupt to be generated only when the
Event Status bit (bit 5) is set, use the *SRE 32 command.
Standard Event Status
Register
The Standard Event Status register, shown in Table 2–3, records many types of
events that can occur in the VX4351. Use the *ESR? query to read the contents
of this register. The response is the sum of the decimal values for all bits set.
Reading this register clears all bits so the register can accumulate information
about new events.
T able 2–3: The Standard Event Status Register
Decimal
Bit
0 1 Operation Complete shows that the operation is complete. This bit
1 – Not used
2 4 Query Error shows that data in the Output queue was lost.
3 8 Not used
4 16 Execution Error shows that an error occurred while the VX4351
5 32 Command Error shows that an error occurred while the VX4351
6 – Not used
Value
Function
is set when all pending operations complete following a *OPC
command.
was executing a command or query. Table 2–6 on page 4–7 lists
the execution error messages.
was parsing a command or query. Table 2–5 on page 4–6 lists the
command error messages.
7 128 Power On shows that the VX4351 was powered on.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
4–3
Status and Events
The following example assumes that all bits have been enabled using the Event
Status Enable register (see the next section for information about this register). If
a *ESR? query returns a value of 128, bit 7 (decimal value of 128) is set
indicating that the instrument is in the initial power-on state.
Event Status Enable
Register
The Event Status Enable register, shown in Table 2–4, controls which events are
summarized in the Event Status bit (bit 5) of the Status Byte register. Use the
*ESE command to set bits in the Event Status Enable register. Use the *ESE?
query to see what bits in the Event Status Enable register are set. The response
from this query is the sum of the decimal values for all bits summarized in the
event status bit of the Status Byte register.
T able 2–4: The Event Status Enable Register
Decimal
Bit
0 1 Set bit 5 of the Status Byte register when bit 1 (the Operation
1 2 Not used
2 4 Set bit 5 of the Status Byte register when bit 2 (the Query Error bit )
3 8 Not used
4 16 Set bit 5 of the Status Byte register when bit 4 (the Execution Error
5 32 Set bit 5 of the Status Byte register when bit 5 (the Command Error
Value
Function
Complete bit) of the Standard Event Status register is set.
of the Standard Event Status register is set.
bit) of the Standard Event Status register is set.
bit) of the Standard Event Status register is set.
The Output Queue
The System Error and
Event Queue
4–4
6 64 Not used
7 128 Set bit 5 of the Status Byte register when bit 7 (the Power On bit) of
the Standard Event Status register is set.
If, for example, the *ESE? query returns a value of 255, all bits are set,
indicating that all events will set the event status bit (bit 5) of the Status Byte
register.
The VX4351 stores query responses in the Output queue.
The VX4351 error and event messages are stored in the System Error and Event
queue. Use the SYSTem:ERRor? query to get the event number and a text
description of the event. Reading an event removes it from the queue. The Event
queue stores detailed information for up to 10 events; the events are stored in
first-in first-out order.
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Status and Event Reporting Process
Figure 2–1 shows how to use the Status and Event Reporting system. In the
explanation that follows, numbers in parentheses refer to the circled numbers in
Figure 2–1.
1
11
Status and Events
Standard Event Status
register
Read using *ESR?
Event Status Enable
register
Read using *ESE?
Write using *ESE
Status Byte
register
Read using *STB?
Service Request Enable
register
Read using *SRE?
Write using *SRE
765 4 3 210
PowerOn— Command
Error
765 4 3 210
PowerOn— Command
Error
6
Request
7543210
Service
—
6
Master
Status
6
7543210
6
— Event
Status Bit
——
Status Bit
3
Event
Execution
Error
Execution
Error
Message
Available
Message
Available
Query
—
Error
2
Query
—
5
Error
4
Queue Not
——
Empty
——
—
—
—
Operation
Complete
Operation
Complete
111
—
Event
Event
Event
Byte
Byte
Byte
Event
queue
Output
queue
Figure 2–1: Status and Event Reporting Process
When an event occurs, the appropriate bit in the Standard Event Status register is
set to one and the event is recorded in the Event queue (1). If the corresponding
bit in the Event Status Enable register is also enabled (2), then the event status
bit in the Status Byte register is set to one (3).
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
4–5
Status and Events
Messages
When output from an event is sent to the Output queue (for example, a response
to a query), the message available bit in the Status Byte register is set to one (4).
When a bit in the Status Byte register is set to one and the corresponding bit in
the Service Request Enable register is enabled (5), the master status summary bit
in the Status Byte register is set to one and a service request is generated (6).
The VX4351 generates error messages in response to events caused by commands or queries. Each type of event sets a specific bit in the Standard Event
Status register. Thus, each message is associated with a specific Standard Event
Status register bit. In the message tables that follow, the associated Standard
Event Status register bit is specified in the table title. Not shown in the tables are
secondary messages giving more detail about the cause of the error or the
meaning of the message. These secondary messages are shown for each
command and query in Syntax and Commands.
Table 2–5 shows the error messages generated by improper command syntax.
Check to see that the command is properly formatted and that it follows the rules
in Syntax and Commands.
T able 2–5: Command Error Messages
(Bit 5 in Standard Event Status register)
Code Message
-102 Syntax error; 1 dimensional <channel_spec> invalid for VX4330 module
-102 Syntax error; 2 dimensional <channel_spec> invalid for VX4351 module
-102 Syntax error; 3 dimensional <channel_spec> invalid for VX43xx module
-102 Syntax error; channel dimension mismatch
-102 Syntax error; integer field greater than 10 characters
-102 Syntax error; Missing module name
Syntax error; Module name already defined
-102 Syntax error; Module name already defined
-102 Syntax error; Module name length greater than 12 characters
-102 Syntax error; Non-contiguous section numbers
-102 Syntax error; ROUTe:CONFigure command invalid for VX43xx module
-102 Syntax error; ROUTe:DISJoin command invalid for VX43xx module
-102 Syntax error; ROUTe:JOIN command invalid for VX43xx module
-102 Syntax error; ROUTe:MODE command invalid for VX43xx module
-102 Syntax error; Undefined module name
-102 Syntax error; Unexpected x detected while ...
4–6
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Status and Events
T able 2–5: Command Error Messages
(Bit 5 in Standard Event Status register) (Cont.)
Code Message
-121 Invalid character in number
-123 Exponent too large
Table 2–6 lists the execution error messages that can occur during execution of a
command. Parameter “y” in these error messages represents the local bus address
of the module that the error message applies to. A value of “1” indicates the
module containing the Option 01 daughter board, a value of “2” the module in
the next slot to the right, and so on.
T able 2–6: Execution Error Messages
(Bit 4 in Standard Event Status register)
Code Message
-200 Execution error; Reserved
-200 Execution error; scan list undefined
-21 1 Trigger ignored
-213 Init ignored
-222 Data out of range; Channel number x on module y
-222 Data out of range; Channel number x!x on module y
-222 Data out of range; Channel number x!x!x on module y
-222 Data out of range; Invalid module address specified
-222 Data out of range; Invalid section number
-222 Data out of range; invalid sequence count
-222 Data out of range; invalid trigger delay
-222 Data out of range; Invalid VXI TTL Trigger level
-222 Data out of range; Maximum value for ESE command is 255
-222 Data out of range; Maximum value for SRE command is 255
-222 Data out of range; invalid dwell time specified.
-223 Too much data; channel list array overflow
-223 Too much data; Input buffer overflow
-223 Too much data; Output buffer full
-223 Too much data; scan list array overflow
-240 Hardware error; shift register verification error - module m
-241 Hardware error; Unrecognized module d, d
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
4–7
Status and Events
Table 2–7 lists the device dependent error messages that can occur during
VX4351 operation.
T able 2–7: Device Dependent Error Messages
(Bit 3 in Standard Event Status register)
Code Message
-350 Queue overflow; error/event queue
-350 Queue overflow; output queue
4–8
Company Confidential [12/5/96]
VX4351 40-Channel, 10 Amp, SPST Switch Module User Manual
Appendices
Loading...