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.)