Software Product Description ________________________________________________________________ PRODUCT NAME: MicroVAX/DRQ3B Device Driver, Version 1.3 SPD 29.25.02 DESCRIPTION The MicroVAX/DRQ3B Device Driver V1.3 (HXDRIVER) supports the DRQ3B interface, which is a general purpose 16 bit parallel in- terface between the MicroVAX Q-bus and a user's peripheral. The DRQ3B, under driver control, is capable of performing double buffered direct memory access (DMA) using the block mode capa- bilities of the Q-bus to provide high bandwidth data transfers. The DRQ3B interface also has 512 word FIFO (First In, First Out) buffers on both the input and output ports to allow data to be transferred while an interrupt service routine is setting up the next buffer. Driver Features o Double buffering of I/O requests o Buffer termination via an external event (EOP) o External interrupt o Function bit setting/clearing o DMA operations directly to Q-bus memory o Error handling Double Buffering of I/O Requests As long as two or more buffers are queued to the driver it will automatically try to double buffer the I/O requests. A function modifier IO$M_HX_HOLD_DMA allows an applications to queue up multiple buffers before starting I/O, so that all of those queued buffers can be double buffered. DIGITAL July 1990 AE-KV48C-TE MicroVAX/DRQ3B Device Driver, Version 1.3 SPD 29.25.02 Buffer Termination Via an External Event (EOP) The hardware has a line on the input connector that is handled like a 17th data bit but will cause a DMA operation to terminate and a new one to start when asserted and read out of the FIFO by the DMA controller. The driver supports this condition and returns the number of words transferred including the last one transferred with the external event asserted as well as the success code SS$_WASSET rather than the conventional SS$_ NORMAL so that an application can test for the occurrence of this condition. External Interrupt A line separate from the external event line allows an inter- rupt to be generated. The driver allows the detection of this condition in an AST routine. Function Bit Setting/Clearing The driver provides SETMODE functions that will set/clear the function bits for a given port, and allows the function bits to be read with a SENSEMODE function. DMA Operations Directly to Q-bus Memory The driver supports two forms of I/O, logical and physical. o Physical I/O transfers allow the transfer of data directly to Q-bus memory and specialized I/O subsystems such as those found in some types of array processors. o The driver also allows MicroVAX memory to be used for physi- cal I/O transfers to reduce overhead. o Logical I/O supports the more traditional mechanisms for performing DMA. As a result, it is easier to program but is a little less efficient. Error Handling 2 MicroVAX/DRQ3B Device Driver, Version 1.3 SPD 29.25.02 The driver will report nonexistent memory conditions (NXMs), FIFO overruns and FIFO underruns in case the interface logic stops handshaking correctly. The DRQ3B MicroVAX Device Driver can support up to four DRQ3B Interfaces. INSTALLATION Only experienced customers should attempt installation of this product. Digital recommends that all other customers purchase Digital's Installation Services. These services provide for installation of the software product by an experienced Digital Software Specialist. 3 MicroVAX/DRQ3B Device Driver, Version 1.3 SPD 29.25.02 HARDWARE REQUIREMENTS MicroVAX, or VAXstation configuration as specified in the System Support Addendum (SSA 29.25.02-x). SOFTWARE REQUIREMENTS* VMS Operating System or MicroVMS Operating System * Refer to the System Support Addendum (SSA 29.25.02-x) for availability and required versions of Prerequisite software. ORDERING INFORMATION Software Licenses: QL-0APA*-** Software Media: QA-0APA*-** Software Documentation: QA-OAPA*-GZ Software Product Services: QT-0APA*-** * 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. 4 MicroVAX/DRQ3B Device Driver, Version 1.3 SPD 29.25.02 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 Facility manual of the VMS Operating System documentation set. 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, VAX, VAXstation, VAXserver, MicroVAX and VMS are trademarks of Digital Equipment Corporation. 5 System Support Addendum ________________________________________________________________ PRODUCT NAME: MicroVAX/DRQ3B Device Driver, Version 1.3 SSA 29.25.02-A HARDWARE REQUIREMENTS Processors Supported VAX: VAX 4000 Model 300 MicroVAX: MicroVAX II, MicroVAX 3300, MicroVAX 3400, MicroVAX 3500, MicroVAX 3600, MicroVAX 3800, MicroVAX 3900 VAXstationVAXstation II, VAXstation 3200, VAXstation 3500 Processors Not Supported VAX: VAX 6000 Model 200 Series, VAX 6000 Model 300 Series, VAX 6000 Model 400 Series VAX 8200, VAX 8250, VAX 8300, VAX 8350, VAX 8500, VAX 8530, DIGITAL July 19990 AE-MA63B-TE MicroVAX/DRQ3B Device Driver, Version 1.3 SSA 29.25.02-A VAX 8600, VAX 8650, VAX 8700, VAX 8800, VAX 8810, VAX 8820, VAX 8830, VAX 8840, VAX 8842, VAX 8974, VAX 8978 VAX-11/725, VAX-11/730, VAX-11/750 VAX-11/782, VAX-11/785 MicroVAX: MicroVAX I, MicroVAX 2000, MicroVAX 3100 VAXstationVAXstation I, VAXstation 2000, VAXstation 3100 Series, VAXstation 3520, VAXstation 3540, VAxstation 8000 VAXserver:VAXserver 3100, VAXserver 3300, VAXserver 3400, VAXserver 3500, VAXserver 3600, VAXserver 3602, 2 MicroVAX/DRQ3B Device Driver, Version 1.3 SSA 29.25.02-A VAXserver 3800, VAXserver 3900, VAXserver 6000-210, VAXserver 6000-310, VAXserver 6000-410, VAXserver 6000-420, VAXserver 4000 Model 300 Other Hardware Required DRQ3B-AA/SA/SF Parallel DMA Input/Output Module Block Space Requirements (Block Cluster Size = 1): Disk space required for 700 blocks installation: (0.3M bytes) Disk space required for 500 blocks use (permanent): (0.25M bytes) These counts refer to the disk space required on the system disk. The sizes are approximate; actual sizes may vary depending on the user's system environment, configuration, and software options. OPTIONAL HARDWARE Up to 3 additional DRQ3B Interfaces may be added to each system for a total of 4 maximum. The maximum number of interfaces that can be installed in a BA23 or BA123 system may be limited by the number ofavailable A-size I/O panel openings. CLUSTER ENVIRONMENT 3 MicroVAX/DRQ3B Device Driver, Version 1.3 SSA 29.25.02-A This layered product is fully supported when installed on any valid and licensed VAXcluster* configuration. It must be in- stalled once on each MicroVAX or VAXstation processor from which usage is planned. In order to configure some product specific attributes that must remain unique to each system, certain components of the product are stored in the system specific environment, SYS$SPECIFIC:[SYSxxx], of the MicroVAX or VAXstation processor on which the installation is performed. The remaining components of the product, including some or all of the executable images will be installed common to all accessing systems. The HARDWARE REQUIREMENTS sections of this product's Software Product Description and System Support Addendum detail any special hardware required by this product. * V5.x VAXcluster configurations are fully described in the VAXcluster Software Product Description (29.78.xx) and in- clude CI, Ethernet and Mixed Interconnect configurations. SOFTWARE REQUIREMENTS VMS Operating System V5.0 - V5.3 or MicroVMS Operating System V4.7 VMS Tailoring For VMS V5.x, the following VMS classes are required for full functionality of this layered product: o VMS Required Saveset o Programming Support o System Programming Support o Utilities 4 MicroVAX/DRQ3B Device Driver, Version 1.3 SSA 29.25.02-A For more information on VMS classes and tailoring, refer to the VMS Operating System Software Product Description (SPD 25.01.xx). OPTIONAL SOFTWARE None GROWTH CONSIDERATIONS The minimum hardware/software requirements for any future ver- sion of this product may be different from the minimum require- ments for the current version. DISTRIBUTION MEDIA Tape: TK50 Streaming Tape This product is also available as part of the VMS Consolidated Software Distribution on CDROM. ORDERING INFORMATION Software Licenses: QL-0APA*-** Software Media: QA-0APA*-** Software Documentation: QA-0APAA-GZ Software Product Services: QT-0APA*-** * Denotes variant fields. For additional information on avail- able licenses, services and media refer to the appropriate price book. The above information is valid at time of release. Please con- tact your local Digital office for the most up-to-date informa- tion. [TM] The DIGITAL Logo, VAX, MicroVAX, VAXstation, VAXserver and VMS are trademarks of Digital Equipment Corporation. 5