GPI/O Release Document
Software Release 9.6.1
Part No. 005495
Revision 05
This document describes the GPI/O
software for Software Release 9.6.1. It
includes an overview of the product and
instructions for installing SR9.6.1
optional software.
The release notes for standard DOMAIN
software and other optional products are
documented in other sets of release notes
and are located in the system /doc
directory.
APOLLO COMPUTER INC.
330 Billerica Road
Chelmsford, Massachusetts 01824
Copyright c 1987 Apollo Computer Inc.
All rights reserved. Printed in U.S.A.
First Printing: July 1987
Latest Printing: July 1987
This document was formatted using the FMT tool distributed with the DOMAIN
computer system.
APOLLO and DOMAIN are registered trademarks of Apollo Computer Inc.
AEGIS, DGR, DOMAIN/BRIDGE, DOMAIN/DFL-100, DOMAIN/DQC-100, DOMAIN/Dialogue,
DOMAIN/IX, DOMAIN/Laser-26, DOMAIN/PCI, DOMAIN/SNA, D3M, DPSS, DSEE, GMR, and
GPR are trademarks of Apollo Computer Inc.
Apollo Computer Inc. reserves the right to make changes in specifications and
other information contained in this publication without prior notice, and the
reader should in all cases consult Apollo Computer Inc. to determine whether
any such changes have been made.
THE TERMS AND CONDITIONS GOVERNING THE SALE OF APOLLO COMPUTER INC. HARDWARE
PRODUCTS AND THE LICENSING OF APOLLO COMPUTER INC. SOFTWARE CONSIST SOLELY OF
THOSE SET FORTH IN THE WRITTEN CONTRACTS BETWEEN APOLLO COMPUTER INC. AND ITS
CUSTOMERS. NO REPRESENTATION OR OTHER AFFIRMATION OF FACT CONTAINED IN THIS
PUBLICATION, INCLUDING BUT NOT LIMITED TO STATEMENTS REGARDING CAPACITY,
RESPONSE-TIME PERFORMANCE, SUITABILITY FOR USE OR PERFORMANCE OF PRODUCTS
DESCRIBED HEREIN SHALL BE DEEMED TO BE A WARRANTY BY APOLLO COMPUTER INC. FOR
ANY PURPOSE, OR GIVE RISE TO ANY LIABILITY BY APOLLO COMPUTER INC.
WHATSOEVER.
IN NO EVENT SHALL APOLLO COMPUTER INC. BE LIABLE FOR ANY INCIDENTAL,
INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING BUT NOT
LIMITED TO LOST PROFITS) ARISING OUT OF OR RELATING TO THIS PUBLICATION OR
THE INFORMATION CONTAINED IN IT, EVEN IF APOLLO COMPUTER INC. HAS BEEN
ADVISED, KNEW OR SHOULD HAVE KNOWN OF THE POSSIBILITY OF SUCH DAMAGES.
THE SOFTWARE PROGRAMS DESCRIBED IN THIS DOCUMENT ARE CONFIDENTIAL INFORMATION
AND PROPRIETARY PRODUCTS OF APOLLO COMPUTER INC. OR ITS LICENSORS.
Reader_Notice
This document resides on line in the /doc directory. To print a copy of this
document, use the PRF command with the -npag and -pr options.
PRF <file_pathname> -PR <printer_name> -NPAG
iii
Contents
Section
CHAPTER 1 OVERVIEW OF SOFTWARE RELEASE 9.6.1 GPI/O . . . . . . . . . . . . . . . 1-1
CHAPTER 2 INSTALLING OPTIONAL SOFTWARE . . . . . . . . . . . . . . . . . . . . . 2-1
CHAPTER 3 CHANGES IN DOCUMENTATION . . . . . . . . . . . . . . . . . . . . . . . 3-1
CHAPTER 4 BUGS AND BUG FIXES . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
Contents iv
CHAPTER 1
OVERVIEW OF SOFTWARE RELEASE 9.6.1 GPI/O
SOFTWARE RELEASE 9.6.1 GPI/O now includes support for the Domain Series 4000
workstation. This support is fully documented in Update Package 1 for
Writing_Device_Drivers_with_GPI/O_Calls, Rev. 10, Order No. 000959.
1-1 GPI/O Software Release 9.6.1
CHAPTER 2
INSTALLATION INFORMATION
You can add GPI/O to a user node (one equipped with monitor and keyboard) or
a DOMAIN server processor (DSP) that is running SR9.6.1 or a more recent
version of the AEGIS or DOMAIN/IX operating system. If the user node or DSP
is not running SR9.6.1 or a more recent version, follow the appropriate
software update procedures as described in Installing_DOMAIN_Software (Order
No. 008860) or in the appropriate release notes.
For directions about how to install this product, see the manual Installing
DOMAIN_Software, (Order No. 008860).
NOTE: The user node or DSP must have a minimum of 930 blocks of available
disk space for a successful installation of this software.
2-1 GPI/O Software Release 9.6
CHAPTER 3
DOCUMENTATION
Writing_Device_Drivers_with_GPI/O_Calls, Order No. 000959, Revision 10 has
been updated to provide support for the Domain Series 4000 workstation. The
following information should be added to Update Package 1:
A new procedure, PBU_$GET_INFO, has been added to GPI/O software. Following
is a description of the procedure, its syntax, and related datatypes:
CONSTANT
PBU_$INFO_VERSION 1 Current version of PBU_$INFO_T.
DATA_TYPES
PBU_$BUS_T A 2-byte integer. Indicates the presence of the specified
bus. Returns any combination of the following values:
PBU_MULTIBUS_M16
The node supports the 16-bit MULTIBUS.
PBU_MULTIBUS_M20
The node supports the 20-bit MULTIBUS.
PBU_ATBUS
The node supports the AT-compatible bus.
PBU_VMEBUS
The node supports the VMEbus.
3-1 GPI/O Software Release 9.6.1
PBU_$INFO_T I/O bus information. The diagram below illustrates the
PBU_$INFO_T data type:
predefined byte
type offset field name
+-----------------------------+
0: | integer | version
+-----------------------------+
PBU_$BUS_T 2: | | bus_type
+-----------------------------+
PBU_$IOMAP_T 4: | | iomap_type
+-----------------------------+
PBU_$IOMAP_T A 2-byte integer. Indicates whether the node's I/O
hardware includes an I/O map for the specified bus type.
Returns any combination of the following values:
PBU_MULTIBUS_IOMAP
The node is equipped with the MULTIBUS and includes an
I/O map.
PBU_ATBUS_IOMAP
The node is equipped with the AT-compatible bus and
includes an I/O map.
PROCEDURE
PBU_$GET_INFO--Gets information concerning I/O bus type and I/O map.
FORMAT
PBU2_$GET_INFO (length, info, status)
INPUT PARAMETER
length The length of info in bytes. This is a 2-byte Pascal integer
or a C unsigned short integer.
OUTPUT PARAMETERS
info The name of the record, in PBU_$INFO_T format, in which bus
information is returned.
status Completion status in STATUS_$T format.
GPI/O Software Release 9.6.1 3-2
DESCRIPTION
This procedure returns information concerning the presence of
the I/O bus type and the I/O map. With this information, you
can design your driver to run on different node models. Thus,
for example, if you want to design a driver that could run on
either the DN3000 or the DN4000, your driver can use the
information returned by PBU_$GET_INFO to determine whether or
not to perform a DMA transfer of more than 1K bytes of data.
(The DN4000 allows DMA transfers of up to 32K; the DN3000 up
to 1K.)
3-3 GPI/O Software Release 9.6.1
CHAPTER 4
BUGS AND BUG FIXES
There are no bugs or bug fixes for this release.
4-1 GPI/O Software Release 9.6.1