Release Notes 93000351_C Digi dgdm Driver Package dgdm-1.02-1.src.rpm Tested Linux Distributions: RedHat 5.2, 6.0, 6.1, 6.2 Debian 2.1 TurboLinux Server 4.0 Linux Kernels supported: 2.0.36 and newer 2.2.0 and newer RPM Part Number 40002059_C 06/23/00 1. INTRODUCTION This Digi software package includes device drivers for the DataFire RAS PTE, DataFire DSP PTE cPCI, DataFire RAS B4STU, AccelePort RAS and AccelePort Xp families of adapters. It is currently supported on the following hardware platforms: * Standard i386/Pentium PC and has been tested with the following Linux distributions: * RedHat 5.2 * RedHat 6 * Debian Linux 2.1 * TurboLinux Server 4.0 This product is supported with all kernels in the 2.2 tree and continues to support kernel 2.0.36 and later in the 2.0 tree. This package requires tix. If it is not installed on the target machine prior to installing this rpm, this rpm will refuse to install. In addition, a curses development environment is also required to generate the binary RPM from the source RPM provided. 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: 40002059_C Interested parties may also wish to join the Unofficial Digi Linux User's Group by sending an e-mail to: list@remotepoint.com with subscribe digi-linux-users in the body of the message. 2. SUPPORTED PRODUCTS DataFire RAS PTE Family of Adapters - DataFire RAS 24 PT1 DataFire RAS 48 PT2 DataFire RAS 30 PE1 DataFire RAS 60 PE2 DataFire DSP PTE cPCI Family of Adapters - DataFire DSP 24 PT1 cPCI DataFire DSP 48 PT2 cPCI DataFire DSP 30 PE1 cPCI DataFire DSP 60 PE2 cPCI DataFire RAS B4STU Family of Adapters - DataFire RAS B4U DataFire RAS B4ST AccelePort RAS Family of Adapters - AccelePort RAS 4 AccelePort RAS 8 AccelePort Xp Family of Adapters - AccelePort 2p PCI AccelePort 4p PCI AccelePort 8p PCI AccelePort 16p PCI 3. ENHANCEMENTS * Uses Revision J3 firmware for RAS cards and Revision A1 firmware for AccelePort Xp. * Added full support for AccelePort Xp family including transparent print and ditty utilities. * Added PortAssist Manager Communications agent and DigiPortAuthority support for diagnostics and monitoring and debugging. * Debugging Tracebuffer is now dynamically allocated and its size can be specified at driver load time when debugging is compiled in. * Boards now exectute POST and load the FEP in parallel, thus speeding the driver load process. 3. BUG FIXES * No longer use single static buffer for receiving data from multiple boards. * Statisics reporting in /proc/.../tty fixed for more than the first board. * When the user changes the format of node names at load time, links made to those nodes by /proc/dgdm/mknod will now be correctly made. * Numerous bug fixes to DPA and PAM. 4. KNOWN LIMITATIONS * The maximum combined number of Acceleport RAS and DataFire RAS adapters in one system is currently set to 4. * Although there are numerous places within the rpm that might imply support for additional hardware platforms, this release is valid only for 32bit i386 platforms. * The ISDN adapters supported by this release of the driver package can send and receive analog calls and also 64Kbs and 56Kbs digital ISDN calls. This driver package DOES NOT support the isdn4linux interface. In the case of ISDN calls, the firmware assumes the caller begins data transfer in sync PPP mode, and received sync PPP packets are translated into async PPP packets and passed up through the standard asynchronous devices. Transmitted async PPP packets are likewise translated into sync PPP packets before being transmitted over the ISDN link. This mode is initiated by either an incoming ISDN digital call or by a dialout with the AT dial command "ATDIXXXX" where XXXX is the phone number to dial. * Transparent print devices are made for but not supported by the DataFire RAS, DataFire DSP cPCI, and AccelePort RAS families of cards. * Support for the DataFire DSP cPCI family is extremely limited and the use of this driver with those cards is largely untested as of this release. 5. ADDITIONAL INFORMATION * This driver is distributed both as a source RPM and as a compressed tar file of the source. The digirpm shell script can be used to automatically compile the source RPM provided. It will also then automatically install the resulting binary RPM created. The digirpm script is available for download at http://support.digi.com/support/drivers/linux/8006862A.sh If you install the tarred source, it should be untarred as /usr/src/dg/dgdm and "make install" should be run as root from the source directory. In order to make the driver available for use, you must cause the driver to be loaded. This can be accomplished on RedHat distributions by doing a "chkconfig --add dgdm" to enable the driver rc scripts for start and stop at system reboot and shutdown. On other distributions, you should link the /etc/rc.d/init.d/dgdm script as appropriate. To load the driver, either run run the script by hand ("/etc/rc.d/init.d/dgdm start") or reboot the system. Once the driver has been loaded, device nodes must be created before you can configure the dgdm adapters. The dgdm script will automatically do this for you at reboot, To create device nodes by hand, do a "/proc/dgdm/mknod". This will create device nodes for all of the supported dgdm adapters found on your system. However, It will not remove any device nodes that do not match your current hardware configuration. In order to remove device nodes before creating new ones, use the "-d" command line argument ("/proc/dgdm/mknod -d"). This will remove ALL dgdm device nodes before created new device nodes. NOTE: all device nodes made with /proc/dgdm/mknod are made with permissions according to the umask and group/owner unspecified. This often results in modes of 664 and group/owner equal to root. The /etc/rc.d/init.d/dgdm script can be easily edited to change the permissions and owners of the nodes as desired at driver load time. Once device nodes have been created, you can use the support utilities discussed below to configure the adapters that have been found on your system by the dgdm driver (this does not generally apply to the AccelePort Xp cards). See dm_driver(4) for additional details on the dgdm driver. * This package includes several support and configuration utilites including dm_admin, a command line utility, and dm_gui, a graphical utility. Both can be used to configure adapters as well as to display adapter configuration and status information. Refer to the man pages for these utilities for additional information. * A copy of these release notes can be found as: /usr/src/dg/dgdm/drv/linux/release.notes after the rpm has been installed. 6. HISTORY Version 1.02-1 (40002059_C) July 7, 2000 - Initial product release for AccelePort Xp product. Version 1.01-01 (40002059_B) Jan 7, 2000 - Initial product release for DataFire RAS and AccelePort RAS products.