Release Notes PN 93000517_A Digi Neo and ClassicBoard PCI Driver Package for Linux dgnc-1.0-6.i386.rpm Tested Linux Distributions: RedHat 7.2, 7.3, 8.0, 9.0 RedHat Advanced Server 2.1, 3.0 Mandrake 8.2, 9.0, 9.1, 9.2 SuSE 8.1, 8.2 Debian 3.0.r1 Linux Kernels supported: 2.4.x (UP and SMP) 2.6.x (UP and SMP) RPM Part Number 40002369_A 10/28/2003 CONTENTS Section Description 1 Introduction 2 Supported Products 3 Enhancements 4 Bug Fixes 5 Known Limitations 6 Additional Information 7 History 1. INTRODUCTION This Digi software package includes device drivers for the PCI models of the Digi Neo and ClassicBoard series of products. It is currently supported on the following hardware platforms: o Standard i386/i486 and Pentium PC and is currently supported on the following Linux distributions: o Red Hat Linux 7.2, 7.3, 8.0, 9.0 o RedHat Advanced Server 2.1, 3.0 o Mandrake 8.2, 9.0, 9.1, 9.2 o SuSE 8.1, 8.2 o Debian 3.0.r1 NOTE: Because of the rapid rate of releases from each respective Vendor, the tested/supported list above quickly becomes out of date. This driver package has been tested and verified working for kernels up to and including version 2.4.22 and 2.6.0-test9 from kernel.org. It is anticipated that this driver will work with Vendor kernel releases of up to 2.4.22 and 2.6.0-test9, but cannot be guarenteed because each respective Vendor can, and does, add their own various changes/patches to the stock kernel.org kernel. These additional Vendor patches to the stock kernel.org linux kernel can cause unforeseen incompatibilities with this driver. Please reference the following number(s) when searching the Digi International web site (www.digi.com) or ftp site (ftp.digi.com) for the latest software package: RPM Part Number: 40002369_A 2. SUPPORTED PRODUCTS Card Model Interface Number of Ports ------------------------------------------------------------- Digi Neo 8 PCI 8 Digi Neo 4 PCI 4 Digi Neo 2 DB9 PCI 2 Digi Neo 2 DB9 PRI PCI 2 Digi Neo 2 RJ45 PCI 2 Digi Neo 2 RJ45 PRI PCI 2 Digi ClassicBoard 8 PCI 8 Digi ClassicBoard 8 422 PCI 8 Digi ClassicBoard 4 PCI 4 Digi ClassicBoard 4 422 PCI 4 3. ENHANCEMENTS o Initial Release. 4. BUG FIXES o Initial Release. 5. KNOWN LIMITATIONS o The driver currently supports a maximum of 20 adapters. o To build the dgnc driver you must have first loaded the matching kernel source tree for your target kernel. To verify that you have matching kernel source, run "/bin/uname -r" and check to make sure the /usr/src directory has the corresponding linux- directory. If you are running a prebuilt kernel from a packaged distribution, this typically involves loading the kernel sources from your distribution CD to your system, then using the following commands to do the following: 1. cd /usr/src/linux- 2. make mrproper Clean up any old version files. 3. make oldconfig Make a configuration file to match your running kernel. 4. make dep Create the dependency and version files. Now you can load and build the dgnc driver package. 6. ADDITIONAL INFORMATION o The tty naming convention for this driver has changed from the old "cpci" version of the Neo and ClassicBoard driver. The new naming convention is the following: /dev/dg/dgnc/ttyn where is the board number, starting from "1", and is the tty letter, starting from "a", and moving upwards to at most "h". There will also be hardlinks created from each /dev/dg/dgnc/ttyn entry to /dev/ttyn to ensure utmost compatibility with applications. Under Linux Distributions that ship with the /dev directory set to use "devfs", (for example, Mandrake), the hardlink described above will display an error and fail. Simply use the /dev/dg/dgnc/ttyn devices instead. o This driver is distributed both as a source RPM and as a compressed tar file of the source. o If you install the source RPM version of the source, it is usually as easy as running the following: 1. rpmbuild --rebuild 40002369_A.srpm 2. rpm -i dgnc-1.0-6.i386.rpm o If you install the compresed tar version of the source, it is usually as easy as running the following: 1. tar xvfz 40002369_A.tgz 2. cd ./dgnc-1.0 3. ./configure 4. make all 5. make install o Occasionally, a Linux Vendor will ship a kernel that simply cannot be autodetected to add the various changes that might be required for that specific kernel. Because of this, there is an option that can be used for both the srpm and tgz to tell the driver package exactly what distribution you have. Currently, the only needed and recognized option is for RedHat AS 3.0. To tell the srpm that you have RedHat AS 3.0, run this command instead: o rpmbuild --rebuild --define DISTRO=REDHAT_AS_30 40002369_A.srpm To tell the tgz that you have RedHat AS 3.0, run this during the "configure" phase: o configure --with-DISTRO=REDHAT_AS_30 o In order to make the driver available for use, users must cause the driver to be loaded. This can be accomplished on RedHat distributions by doing a "chkconfig --add dgnc" to enable the driver rc scripts for start and stop at system reboot and shutdown. On other distributions, users should link the /etc/rc.d/init.d/dgnc script as appropriate. o Once the above step is done, to load the driver either run the script manually ("/etc/rc.d/init.d/dgnc start") or reboot the system. o This package includes several support utilites: o dinc - a cu/tip replacement. o ditty - an stty replacement. o dpa.dgnc - a Curses-based port monitoring/testing utility. o /etc/dgnc/usertest.sh - Another port testing utility. o A copy of these release notes can be found in /etc/dgnc/relnotes.txt after the package is installed. o When upgrading this driver, be sure to remove the old driver package first. If using the RPM based install, "rpm -e dgnc" can be used. If using the compressed tar version of the driver, run "make uninstall" if the original source tree still exists. 7. HISTORY o Initial Release.