apsy(7)                        DG/UX R4.11MU05                       apsy(7)


NAME
       apsy - Arnet PCI-based Synchronous Communications Controller

SYNOPSIS
       apsy(parent-bus[,pci-device-num[,pci-function-num[,line-num]]])

DESCRIPTION
       The apsy driver provides the interface to the Arnet synchronous
       controller boards.  To configure such devices, you must add to the
       DG/UX system configuration file one or more device name entries of
       the form described in the synopsis above.  The parameters in a device
       name have the following meanings:

       ·   The parent-bus parameter is itself a device name, representing
           the PCI bus device to which the controller is attached (pci(0),
           for example).  There is no default value for this parameter; it
           must always be specified explicitly.

       ·   The pci-device-num parameter is a hexadecimal number in the range
           0 through 1F which represents the PCI device number ("slot
           number") used by the device.  The default value for pci-device-
           num is 0.

       ·   The pci-function-num parameter is a hexadecimal number in the
           range 0 through 7 which represents the PCI function number used
           by the controller within pci-device-num.  The default value for
           pci-function-num is 0; non-zero values will only be used if the
           controller lies on a multi-function card.

       ·   The line-num parameter is a hexadecimal number which identifies a
           particular synchronous port on the apsy device.  The value 1
           refers to the first port and 2 refers to the second port.  If the
           parameter for line-num is absent, this identifies the apsy
           controller itself, distinct from any of the lines on it.

       The apsy driver supports the following internally generated baud
       rates: 1200, 2400, 4800, 9600, 19200, 38400, 48000, 56000 and 64000
       bps.  The driver will accept any external clock data rate up to 64000
       bps.

       On-board buffers are 4096 bytes in size.  The maximum frame size may
       exceed 4096 bytes, providing the resulting reduction in the number of
       frames held in on-board storage is acceptable.

       Depending on the controller type, and the cabling used, the apsy
       device supports the following external interfaces:

       +----------+------------+------------+
       |Interface | Electrical |  Physical  |
       +----------+------------+------------+
       |RS-232    | RS-232     | DB25       |
       |V.35      | V.35       | DB25       |
       |V.35      | V.35       | Winchester |
       |RS-530    | RS-442     | DB25       |
       |X.21      | RS-422     | DB15       |
       +----------+------------+------------+

FILES
       When an apsy controller is configured, it creates a character-special
       device node for each serial port, using the pathname:

           /dev/sync/line/apsy(parent-bus,controller-num,function-num,line-num)


       A character-special device node for the whole controller is also
       created, using the pathname:

           /dev/sync/stat/apsy(parent-bus,controller-num,function-num)

       This device node is a clonable Streams device node, which means that
       it can be opened multiple times in order to perform line management
       functions such as statistics manipulation and line configuration.


EXAMPLES
       The following entries in a DG/UX configuration file configure apsy
       controllers in "slots" 4 and 14 (= 0xE) on the standard PC PCI bus:

               apsy(pci(0),4)
               apsy(pci(0),E)

       For more information about DG/UX device configuration, refer to
       "Writing a Device Driver" in Programming in the DG/UX Kernel
       Environment.

DIAGNOSTICS
       apsy device supports internal loopback.

SEE ALSO
       pci_bus(7), wanadm(1M).


Licensed material--property of copyright holder(s)