                            RELEASE NOTES

                Digi International IRIX 6.5 Driver for
        the Digi ClassicBoard PCI and Central Data legacy PCI
                           Serial Adapters

                  Version 1.1.0 (November 24, 1999)

                             P/N 40002006


INTRODUCTION
============

Software support for the Digi International ClassicBoard PCI family of
serial-port adapters is provided by the CDP package.  (The CDP package
also supports the legacy Central Data PCI-4 and PCI-8 Serial Port
Adapters.)  The CDP package is in the IRIX-standard inst(1M) format.

The CDP package consists of these subsystems:

  cdp.sw.base       base software required to use PCI products
  cdp.man.relnotes  these release notes

At present, support is provided for IRIX 6.5 only on IP27 (Origin2000
and Origin200), IP30 (OCTANE), and IP32 (O2) platforms.


HOW TO INSTALL THE DRIVER
=========================

Digi recommends the latest kernel patches from SGI be installed.

After all recommended patches have been installed, the CDP package may
be installed by doing the following as root (superuser) from the
current directory:

1. inst -a -u all -f .          to install the CDP package
2. autoconfig                   to rebuild the IRIX kernel
3. sync; reboot                 to reboot the system


DEVICE NODES
============

The device nodes created by the driver are of the form

                     /hw/ttys/tty[dmf]p[0-7][0-7]

Links to these device nodes are created in the /dev directory and have
the same names as the device nodes themselves, i.e.,

                       /dev/tty[dmf]p[0-7][0-7]

By opening either the ttyd*, ttym*, or ttyf* ports, different hardware
signals are supported.  Use of these ports is similar to use of SGI
internal serial ports as documented in serial(7).

-- TTYD is used for direct connect devices such as terminals.  The
only modem signals used are transmit (TD), receive (RD), and ground
(GND); all others are ignored.  (mnemonic: direct)

-- TTYM is used for devices that use modem-control signals (DTR, DCD)
such as modems.  (mnemonic: modem)

-- TTYF is used for devices that use hardware (CTS/RTS) flow control
such as printers and high speed modems.  (mnemonic: flow control)

The digit immediately after the p in the device name designates the
adapter.  Adapters are enumerated during boot and lines similar to the
following are printed to the console (and logged in /var/adm/SYSLOG):

          Digi ClassicBoard PCI driver 1.1.0 configured
          0: Digi ClassicBoard 8 PCI in PCI slot 3
          1: Digi ClassicBoard 4 PCI in PCI slot 4

The second digit in the device name designates the port.  Note that
the first port is numbered 0 even though on the "octopus" cable and
breakout box, the first port is numbered 1.

For the configuration given above, the device nodes that would be
created are the following:

                 CLASSICBOARD 8 PCI  CLASSICBOARD 4 PCI
                   IN PCI SLOT 3       IN PCI SLOT 4
                 ------------------  ------------------

        DIRECT |      ttydp00            ttydp10
      (3-WIRE) |      ttydp01            ttydp11
         LINES |      ttydp02            ttydp12
          --NO |      ttydp03            ttydp13
         MODEM |      ttydp04                   
       SIGNALS |      ttydp05                   
               |      ttydp06                   
               |      ttydp07                   

         MODEM |      ttymp00            ttymp10
         LINES |      ttymp01            ttymp11
          --NO |      ttymp02            ttymp12
       CTS/RTS |      ttymp03            ttymp13
          FLOW |      ttymp04                   
       CONTROL |      ttymp05                   
               |      ttymp06                   
               |      ttymp07                   

         MODEM |      ttyfp00            ttyfp10
         LINES |      ttyfp01            ttyfp11
          WITH |      ttyfp02            ttyfp12
       CTS/RTS |      ttyfp03            ttyfp13
          FLOW |      ttyfp04                   
       CONTROL |      ttyfp05                   
               |      ttyfp06                   
               |      ttyfp07                   


GETTING HELP
============

These release notes are installed in the IRIX-standard manner and can
be reviewed using relnotes(1) after driver installation by issuing the
following command:

                            relnotes cdp 1

If you have Internet access, additional information on setup and use
can be found at Digi's home on the World Web Web at

                         http://www.digi.com/

As of this writing there is some good information about the legacy
Central Data card, but relevant to the ClassicBoard PCI, at

       http://support.digi.com/support/legacy/centraldata/pci/

Finally, Digi technical support is available at 612-912-3456.


Serial programming information can be found by reading the man page for
termios(3t).  Other man pages of interest may be serial(7), uugetty(1m),
getty(1m), and ppp(1m).


HOW TO REMOVE THE DRIVER
========================

To remove the CDP driver package from your system do the following as
root (superuser):

1. inst -a -R cdp               to remove the CDP package
2. autoconfig                   to rebuild the IRIX kernel
3. sync; reboot                 to reboot the system


KNOWN BUGS AND OTHER COMMENTS
=============================

-- The Digi ClassicBoard PCI and Central Data PCI Serial Port Adapters
   do not support split baud rates.  Split baud rates is the ability
   of some serial ports to send at one data rate and receive at a
   different data rate.

-- Origin and Octane systems only: Because of some peculiarities in
   SGI's implementation of interrupt hardware on the PCI bus, some
   very hardware-specific I/O locations are probed to determine if an
   interrupt is pending on PCI hardware.  SGI supplied information
   regarding the interrupt workaround to Digi and included information
   about the Octane and Origin2000; Digi, however, has tested this
   driver *only* on the Origin200 system.  On other systems, there is
   the possibility of unanticipated hardware causing the driver
   software to not process interrupts.  This will be manifested as
   ports which are completely hung, and may also result in a machine
   with very poor response time.  Please contact Digi technical
   support if you encounter this problem.

-- The CDP driver is MP-safe and may be used on multiprocessor
   platforms.

-- Digi ClassicBoard PCI and Central Data PCI serial adapters may be
   used for modems and other asynchronous serial I/O devices.  The
   ports provided by the PCI adapter are RS-232 (EIA232) devices with
   support from 50 to 115200 bits per second.

-- The hinv(1M) command will report Digi PCI adapters in a format
   similar to this:

          PCI card, bus 0, slot 3, Vendor 0x114f, Device 0x8

   The slot is the physical slot in which the adapter is installed.
   "Vendor 0x114f" is Digi's vendor ID as assigned by the PCI SIG
   (Special Interest Group).  (Central Data's vendor ID is/was
   0x1248.)  The device IDs identify the specific product and may be
   one of the following:

      0x28 -- Digi ClassicBoard 4 PCI
      0x29 -- Digi ClassicBoard 8 PCI
     0x204 -- 2nd-generation (PLX 9050-based) Central Data PCI-4
     0x208 -- 2nd-generation (PLX 9050-based) Central Data PCI-8
       0x4 -- 1st-generation (PLX 9060-based) Central Data PCI-4/8
              (For this last adapter, of which few were produced,
              device nodes for eight serial ports are created even
              on PCI-4 models, which have only four physical
              serial ports.)

   Note that before the device driver is installed, hinv does not
   report the presence of third-party PCI adapters.

-- Currently, there is no support for a "ttyc" raw interface, nor is
   there support for a midi or "tty4f" RS-422 interfaces.



Digi International
11001 Bren Road E.
Minnetonka, MN 55343

Phone:  1-612-912-3456
Fax:    1-612-912-4958
E-mail: support@digi.com
WWW:    http://www.digi.com/
FTP:    ftp.digi.com


@(#)40002006.README	1.2 12/06/99 (C) 1999 Digi International
(This file is P/N 93000356.)
