This document applies for firmware version 1.00
and above.
Copyright T ektronix, Inc. 1995. 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.
VXIbus is a trademark of the VXI Consortium.
SurePath and Intelliframe 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 PAR TICULAR 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.
Review the following safety precautions to avoid injury and prevent damage to
this product or any products connected to it.
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.
Injury Precautions
Avoid Electric Overload
Avoid Electric Shock
Do Not Operate Without
Covers
Use Proper Fuse
Do Not Operate in
Wet/Damp Conditions
Do Not Operate in an
Explosive Atmosphere
Avoid Exposed Circuitry
To avoid electric shock or fire hazard, do not apply a voltage to a terminal that is
outside the range specified for that terminal.
To avoid injury or loss of life, do not disconnect probes or test leads from this
product while it is connected to a voltage source.
To avoid electric shock or fire hazard, do not operate this product with covers or
panels removed.
To avoid fire hazard, use only the fuse type and rating specified for this product.
To avoid electric shock, do not operate this product in wet or damp conditions.
To avoid injury or fire hazard, do not operate this product in an explosive
atmosphere.
To avoid injury, remove jewelry such as rings, watches, and other metallic
objects. Do not touch exposed connections and components when power is
present.
Product Damage Precautions
Provide Proper Ventilation
Option 01 VXI Interface Module User Manual
To prevent product overheating, provide proper ventilation.
iii
General Safety Summary
Do Not Operate With
Suspected Failures
If you suspect there is damage to this product, have it inspected by qualified
service personnel.
Safety Terms and Symbols
Terms in This Manual
Terms on the Product
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.
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:
DANGER
High Voltage
Certifications and Compliances
Safety Certification of
Plug-in or VXI Modules
For modules (plug-in or VXI) that are safety certified by Underwriters Laboratories, UL Listing applies only when the module is installed in a UL Listed
product.
For modules (plug-in or VXI) that have cUL or CSA approval, the approval
applies only when the module is installed in a cUL or CSA approved product.
Protective Ground
(Earth) T erminal
ATTENTION
Refer to Manual
Double
Insulated
iv
Option 01 VXI Interface Module User Manual
General Safety Summary
Compliances
Overvoltage Category
Consult the product specifications for Overvoltage Category, and Safety Class.
The following defines overvoltage categories:
CAT III: Distribution level mains, fixed installation.
CAT II: Local level mains, appliances, portable equipment
CAT I: Signal level, special equipment or parts of equipment, telecommunica-
tion, electronics
Option 01 VXI Interface Module User Manual
v
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 B: Examples contains
example programs that demonstrate the programmable features of this instrument.
You may also want to keep the Reference Guide by the 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 andCommands and Appendix B: Examples.
Option 01 VXI Interface Module User Manual
vii
Getting Started
Product Description
This section begins with a brief description of the Option 01 VXI Interface
Module, and explains how to configure and install the module on a relay
switching module in a VXIbus mainframe. When the Option 01 is installed on a
relay module, a quick functional check (described in this section of the User
Manual for the relay module) assures that the instrument operates properly.
The Option 01 VXI Interface Module is a printed circuit board assembly for use
in a mainframe conforming to the VXIbus Specification. The Option 01 provides
a VXI word serial protocol servant interface to the SurePatht family of VXI
relay modules. The Option 01 is a daughter 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 including members of the SurePatht family of relay switching
modules and VX4372 and VX4374 Scanner Slave modules. In this document,
these modules will be referred to as “local bus slaves.”
The VXI Interface Module includes the following features:
HCPU:
Zilog Z88C00 Microcontroller with 20 MHz Clock
64 Kbyte of EPROM and 32 Kbyte of RAM
HVXI Interface:
VXI Rev 1.4 Message Based Device. IEEE-488.2 device
Supports Fast Handshake word serial protocol data transfers
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 to eight VXI TTL triggers
Command programmable monitoring of one or more VXI TTL triggers
Option 01 VXI Interface Module User Manual
1–1
Getting Started
The Local Bus Interface function of the Option 01 provides serial I/O interface
for control of scanner slave and SurePatht relay modules, monitors the power
fuses of all local bus slave modules that it controls, and provides a serial input
interface to identify each local bus slave that it controls.
As part of the self test, SurePatht modules automatically verify the control
logic every time a relay operation is performed.
Figure 1–1 shows the Option 01.installed on a SurePatht relay module.
Figure 1–2 shows a typical SurePatht configuration.
Option 01
F1291
Figure 1–1: Option 01 Indicators and Switch Locations
LOGICAL
ADDRS
LO
HI
INTRPT
Switches as viewed
from the rear of instrument
(labels are on the back shield)
1–2
Option 01 VXI Interface Module User Manual
Front panel
connectors
Getting Started
VXI interface &
slave controller
daughter board
Backplane
connectors
VXI backplane
local bus
Daughter board
connectors
Fuses
BITE (Built-in Test
Equipment)
Figure 1–2: Typical SurePath Configuration
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.
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.
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
, and the relay control circuitry
on each relay module controlled by the Option 01.
Option 01 VXI Interface Module User Manual
1–3
Getting Started
Accessories
Controls and Indicators
Table 1–1 lists the standard accessories included with the Option 01.
T able 1–1: Standard Accessories
AccessoryPart Number
Option 01 User Manual070-9180-XX
Option 01 Reference070-9198-XX
The following controls are provided to select the functions of the Option 01
operating environment.
Switches
Configuration
Logical Address Switches
The Logical Address switches and VMEbus Interrupt Level Select switch must be
correctly set to insure proper operation. See Configuration for details on how to
set the switches.
The following switches must be correctly set to ensure proper operation. Refer to
Figure 1–1 for their physical locations.
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 Option 01 is set to a value between hexadecimal C0 (C000
mal FF (FFC0
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 Option 01 will be [(40
) by two hexadecimal rotary switches. Align the desired switch
In order to use and program the Option 01 daughter board 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 Slot 0 module being used.
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
Option 01 daughter board 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 Option 01 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.
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.
Installation
This section describes how to install the Option 01.
Tools Required
Requirements and
Cautions
Option 01 VXI Interface Module User Manual
A Torxt T-10 driver set is required for proper installation.
The Option 01 daughter board is installed on 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
1–5
Getting Started
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. Verify that the mainframe is able to provide adequate cooling and power
with this module installed. Refer to the mainframe Operating Manual for
instructions.
If the installed Option 01 is used in a Tektronix mainframe, all Option 01
cooling requirements are met.
Installation Procedure
Follow these steps to install the Option 01.
CAUTION. The Option 01 daughter board 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.
1. Record the revision levels, serial numbers (located on the label on the top
shield of the host module and on a sticker on the Option 01), 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. Install the Option 01 on the SurePatht switching module (see Figure 1–3):
a. Align the sockets on the Option 01 with the connectors on the switching
module.
b. Gently seat the Option 01 into the connectors.
c. Use the screws provided to secure the Option 01 to the switching module
on the five standoffs.
1–6
Option 01 VXI Interface Module User Manual
Connectors
Option 01
Getting Started
Switching Module
Connectors
Figure 1–3: Mounting the Option 01
Option 01 VXI Interface Module User Manual
1–7
Getting Started
4. Make sure that the mainframe power is off.
5. Insert the module with the Option 01 installed into one of the instrument
slots of the mainframe (see Figure 1–4). Refer to the User Manual for the
switching module for detailed installation instructions.
1–8
Figure 1–4: Module Installation
Option 01 VXI Interface Module User Manual
Installation Checklist
Getting Started
Installation parameters will vary depending on the mainframe being used. Be
sure to consult the mainframe operating manual before installing and operating
the module.
Performed by: _______________________ Date: _____________
Option 01 VXI Interface Module User Manual
1–9
Getting Started
Functional Check
The Option 01 VXI Interface 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 Option 01 commander, sets the Reset bit in the
Option 01 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 un-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.
The VX4320 RF Multiplexer module contains eight 4-to-1 RF multiplexers.
After a power-on self test is performed by the Option 01, it closes channel 1
of each section of each VX4320 that it controls.
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.
1–10
Option 01 VXI Interface Module User Manual
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.
SYSFAIL* Operation
3. When the self test is completed,
restored to their pre-test state.
SYSFAIL* becomes active during power-on, hard or soft reset, or self test, or if
the module loses 5 V power. When the mainframe Resource Manager detects
SYSFAIL* set, it will attempt to inhibit the line. This causes the Option 01 VXI
Interface Module to deactivate SYSFAIL* except when +5 V power is lost on
the relay module on which it is installed.
the modules controlled by the Option 01 are
Option 01 VXI Interface Module User Manual
1–11
Operating Basics
Functional Overview
The Option 01 VXI Interface Module is a VXIbus message-based instrument and
communicates using the VXIbus Word Serial Protocol. The module is programmed by issuing ASCII characters from the system controller to the Option
01 via the module VXIbus commander and the VXIbus mainframe backplane.
Refer to the manual for the VXIbus device that will be the Option 01 daughter
board’s 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 B: Examples in this manual for
information on how the system controller communicates with the commander
being used.
The Option 01 VXI Interface Module is a printed circuit board that resides on a
C-size VXI module belonging to the Tektronix “SurePath” family of relay
modules. This family of relay modules includes the VX4320 RF Mux, VX4330
Scanner/Mux, VX4350 General Purpose Switch, and VX4380 Matrix modules.
Commands conforming to the 1994 SCPI and IEEE-488.2 specifications are sent
to the Option 01. The Option 01 parses these commands and controls the module
on which it is installed and additional SurePath modules installed in contiguous
slots to its right. VX4372 and VX4374 Scanner Slave modules can also be
controlled by the Option 01.
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
Power LED of each relay module controlled by the Option 01 will be on. The
Failed LED on each of these modules will be off. The default condition of the
module after power-on is listed in the *RST command description. Self-test
failures are described in the *TST? command description.
The format and syntax for the command strings are described in the CommandSyntax section. A complete description of each command in alphabetical order is
in the Command Descriptions section.
Option 01 VXI Interface Module User Manual
2–1
Operating Basics
Instrument I/O: VXIbus Basics
NOTE. 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.
The Option 01 Module, when installed on a switching module, is a C-size single
slot 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.
The Option 01 daughter board is neither a VXIbus commander nor a VMEbus
master; therefore it does not have a VXIbus Signal register. The Option 01 is a
VXIbus message-based servant.
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 daughter board 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.
4. The commander reads the Option 01 Data Low register.
A Normal Transfer Mode write to the Option 01 daughter board 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–2
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.
Option 01 VXI Interface Module User Manual
Operating Basics
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
daughter board 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 daughter board proceeds
as follows:
1. The commander writes the Byte Request command (hexadecimal 0DEFF) to
the Option 01 Data Low register.
2. The commander reads the Option 01 Data Low register.
A Fast Handshake Transfer Mode write of the Option 01 daughter board
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’s address
space may cause incorrect operation of the module.
As with all VXIbus devices, the Option 01 daughter board 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:
Base Address = V
* 4016 + C000
16
16
where V is the logical address of the device as set by the Logical Address
switches.
Option 01 VXI Interface Module User Manual
2–3
Operating Basics
Configuration Registers
Table 2–1 contains a list of the Option 01 Configuration registers and a complete
description of each register. The offset is relative to the module base address.
T able 2–1: Register Definitions
Address
Register
ID Register0000RO101 1 1111 1111 1101 (hexadecimal BFFD)
Device Type0002ROSee Device Type definition below
Status0004RDefined by state of interface
Control0004WDefined by state of interface
Offset0006WONot used
Protocol0008RO1111 0111 1111 1111 (hexadecimal F7FF)
Response000ARODefined by state of the interface
Data High000CNot used
Data Low000EWNot fixed; command-dependent
Data Low000ERNot fixed; command-dependent
RO is Read Only
WO is Write Only
R is Read
W is Write
(hexadecimal)
TypeValue (Bits 15–0)
The Register Bit definitions are listed in Tables 2–2 and 2–3.
T able 2–2: Register Bit Definitions
RegisterBit Definition
IDhexadecimal BFFD
Protocolhexadecimal F7FF
2–4
Option 01 VXI Interface Module User Manual
Operating Basics
The contents of the Device register of the Option 01 Module depends on the
model number of the relay module that it is installed on, as shown in Table 2–3.
Command protocol and syntax for the Option 01 daughter board are as follows:
HA command string consists of a string of ASCII-encoded characters
HIn 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 VX4380 Module. Two additional VX4380 Modules are
installed in consecutive slots to the right of the first VX4380. Under these
conditions, the commands
cause all relays on all three VX4380 Modules to open. Note that each of
these commands is terminated by a line feed. An equivalent method of
sending these commands using the semi-colon character as a terminator is
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
is parsed, the command
is no longer valid.
Option 01 VXI Interface 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
route:configure:join m1,(1:6)<LF>
route:configure:join m2,(1:2)<LF>
route:configure:join m3,(1:4)<LF>
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.
HWhite space characters can be used to make a command string more
readable. These characters are ASCII-encoded bytes in the range hexadecimal 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
route:configure:join m1,(1:6)
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
Option 01 VXI Interface Module User Manual
Command Syntax
In the query
route:close? (@m1(1:64))
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.
HAll characters in a command can be sent in either upper or lower case form.
HMultiple data parameters passed by a command are separated by a comma
(,).
HA 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.
HIn the command descriptions, the following special characters are used.
Except for the colon (:), 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
:A colon is used to separate command fields
< >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
TRIGger[:SEQuence]:SOURce BUS | HOLD | IMMediate | TTLTrg<n>
Each of the following is a valid form of this command:
trigger:sequence:source bus
trig:seq:sour hold
Trig:SOUR IMM
Trig:Sour TTLTRG1
Trig:Sour TTLT1
Trigger:Source Immediate
Option 01 VXI Interface 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 SurePath relay modules is:
HVX4320 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-dimensional <channel_spec> may also be used to specify a channel on a VX4320
Module. The one-dimensional <channel_spec> is given by the formula:
( (section – 1 ) × 4 ) + relay.
where variables “section” and “relay” are section and relay numbers
specified in a two-dimensional <channel_spec>.
HVX4330 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.
The range of this field is 1 to 64. It specifies one of 64 relays on the
VX4350.
HVX4380 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:
where variables “section” and “row” and “column” are section, row, and
column numbers specified in a three-dimensional <channel_spec>.
<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.
Option 01 VXI Interface Module User Manual
3–5
Loading...
+ 92 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.