Software Product Description ________________________________________________________________ PRODUCT NAME: IEX-VMS-DRIVER, Version 4.2 SPD 26.30.06 DESCRIPTION IEX-VMS-DRIVER allows programs written in MACRO -32 and higher level languages (such as VAX FORTRAN, VAX BASIC and VAX PASCAL) to communicate through the IEU11-A or IEQ11-A with devices containing an IEC 625-1 or IEEE Std. 488 interface. This communication is implemented through a choice of direct QIO calls or a set of subroutines callable from high level languages. Note: In the following description the term IEX11 stands for the IEU11-A and/or IEQ11-A interface. The IEU11-A supports the VMS UNIBUS machines, and the IEQ11-A supports the MicroVMS Q-bus machines. The IEX11-A interface is a bit-parallel byte-serial device which can perform transfers in either program interrupt or DMA (direct memory access) mode. Program interrupt is used for transferring commands and addresses, while DMA is used for transferring data. DMA significantly reduces processor loading during the transfer of long data buffers. The IEX11-A interface contains two independent IEC/ IEEE bus controllers, also known as General Purpose Interface Buses (GPIBs). These two controllers may be connected to the same or to different IEC/IEEE buses. Up to 15 devices may be attached to each IEC/IEEE bus. DIGITAL August 1990 AE-BW75H-TE IEX-VMS-DRIVER, Version 4.2 SPD 26.30.06 The IEX11 is most commonly used as Controller-in-Charge, but can also be used when another device is Controller-in-Charge. The Controller-in-Charge directs the sequence of information on the bus. When the IEX11 acts as Controller-in-Charge, it may request sta- tus information from other devices through serial and parallel polling. When the IEX11 is not Controller-in-Charge, it can be polled in either fashion to provide status information. Features The IEX-VMS-DRIVER supports the following IEC/IEEE hardware capabilities: o Controller (C1, C2, C3, C4, C5) o Talker and Extended Talker (T5, TE5) o Listener and Extended Listener (L3, LE3) o Automatic Source Handshake (SH1) o Automatic Acceptor Handshake (AH1) o Service Request (SR1) o Remote/Local (RL1) o Parallel Poll (PP1, PP2) o Device Clear (DC1) o Device Trigger (DT1) The IEX-VMS-DRIVER supports QIO requests to perform the follow- ing software functions: o Initialize Unit o Write Data o Read Data o Send one IEC/IEEE bus command* 2 IEX-VMS-DRIVER, Version 4.2 SPD 26.30.06 o Send a string of IEC/IEEE bus commands* o Request Service** o Issue a Serial Poll* o Configure devices for Parallel Polls* o Load Parallel Poll Register** o Perform a Parallel Poll* o Go to Controller-Active-State (CACS)* o Go to Controller-Standby-State (CSBS)* o Pass Control* o Sense Mode o Set Mode o Enable Event Recognition o Recognize Events The event recognition facility allows the user's process to specify the events on the IEC/IEEE instrument bus which the interface should detect. The interface is capable of detecting the occurrence of the following events: o Service Request* o Addressed as Listener** o Addressed as Talker** o Deaddressed** o Addressed as Extended Listener** o Addressed as Extended Talker** o Device Clear** o Device Trigger** o Remote/Local Change** 3 IEX-VMS-DRIVER, Version 4.2 SPD 26.30.06 o Parallel Poll Configure** o Parallel Poll Unconfigure** o Interface Clear * Functions that can only be used by the Controller-in-Charge ** Functions used only by a device that is not Controller-in- Charge All IEC/IEEE bus commands are issued through a process request and all data is transferred through the DMA mechanism. When the IEX-VMS-DRIVER is processing a read data request, the three ways to detect the end of the data transfer are: Byte Count Overflow - Transfer terminates after the specified number of bytes have been read. EOI Termination - Transfer terminates if, during the recep- tion of a byte, the EOI line is true. Match Character - Transfer terminates after the Termination specified match character has been consecutively received the specified number of times. A device exerciser is provided to verify that the IEX-VMS- DRIVER is correctly installed and to aid the user in testing his application. When the two bus controllers are connected with a loop back cable (refer to the IEU11-A/IEQ11-A User's Guide), the device exerciser can be run with command files delivered with the exerciser. These command files demonstrate all features of the driver and the IEC/IEEE bus interface functions. The device exerciser can also be used by the user in a dialogue mode to test his devices. The commands to the exerciser are directly converted into QIOs to the driver. Using the exerciser in the dialogue mode, the user can quickly determine the set of QIOs required for his application. The IEX-VMS-DRIVER may be programmed in the following two ways: 4 IEX-VMS-DRIVER, Version 4.2 SPD 26.30.06 VMS and MicroVMS QIO System Service - The VMS QIO requests allow direct access to the driver. These requests can be issued in higher level languages (such as VAX FORTRAN, VAX BASIC, VAX PAS- CAL and MACRO-32). This is the most flexible way of programming the IEX11 device, but requires the user to be familiar with the QIO calling procedures. Simplified User Interface - This is a package of subroutines which can be called from higher level languages (such as VAX FORTRAN and VAX BASIC) to perform the following functions: IESTRT - Initialize an interface IEPOLL - Setup for Serial polling IESEND - Send data IERECV - Receive data IERQSV - Request service IECMD - Perform a bus control function IEWFE - Wait for IEC/IEEE bus event HARDWARE REQUIREMENTS VAX, MicroVAX or VAXstation configuration as specified in the System Support Addendum (SSA 26.30.06-x). 5 IEX-VMS-DRIVER, Version 4.2 SPD 26.30.06 SOFTWARE REQUIREMENTS VMS Operating System or MicroVMS Operating System Refer to the System Support Addendum (SSA 26.30.06-x) for avail- ability and required versions of prerequisite software. ORDERING INFORMATION Software Licenses: QL-519A*-** Software Media: QA-519A*-** Software Documentation: QA-519AA-GZ * Denotes variant fields. For additional information on avail- able licenses, services and media, refer to the appropriate price book. SOFTWARE LICENSING This software is furnished under the licensing provisions of Digital Equipment Corporation's Standard Terms and Conditions. For more information about Digital's licensing terms and poli- cies, contact your local Digital office. LICENSE MANAGEMENT FACILITY SUPPORT This layered product supports the VMS License Management Facil- ity. License units for this product are allocated on a CPU-capacity basis. For more information on the License Management Facility, refer to the VMS Operating System Software Product Description (SPD 25.01.xx) or the License Management Manual of VMS Operating System documentation set. 6 IEX-VMS-DRIVER, Version 4.2 SPD 26.30.06 For more information about Digital's Licensing terms and poli- cies, contact your local Digital office. SOFTWARE PRODUCT SERVICES A variety of service options are available from Digital. For more information, contact your local Digital office. SOFTWARE WARRANTY Warranty for this software product is provided by Digital with the purchase of a license for the product as defined in the Software Warranty Addendum of this SPD. [TM] The DIGITAL Logo, Q-bus, UNIBUS, VAX, MicroVAX, VMS, Mi- croVMS, VAXserver and VAXstation are trademarks of Digital Equipment Corporation. 7