
          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
