Release Notes 93000351_F Digi dgdm Driver Package dgdm-1.05-1.src.rpm Tested Linux Distributions: RedHat 5.2, 6.0, 6.1, 6.2, 7.0 Debian 2.1 TurboLinux Server 6.0 SuSE 6.4, 7.1 Linux Kernels supported: 2.0.36 and newer 2.2.0 and newer 2.4.0 and newer RPM Part Number 40002059_F 04/18/2001 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, 6.0, 6.1, 6.2 * Debian Linux 2.1 * TurboLinux 6.0 * SuSE 6.4 This product is fully supported with all kernels in the 2.4 tree, is fully 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 a generated binary RPM, the binary RPM will refuse to install. In addition, a curses development environment and a TCL development environment are also required to generate a 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_F 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 K4 firmware for RAS cards and Revision B firmware for AccelePort Xp. * Added support for Linux 2.4 kernel tree. 4. BUG FIXES * Fixed problem with dm_gui. * Fixed some packaging issues. 5. KNOWN LIMITATIONS * The maximum combined number of Acceleport RAS and DataFire RAS adapters in one system is currently set to 8. Support for additional cards could easily be added by anyone familiar with the C programming language. * 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. If you care to add support for other platforms, please submit your patches to support@digi.com for inclusion in the release driver. * 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. Transparent print support for these cards is not planned at this time, but may be added at some point in the future. 6. ADDITIONAL INFORMATION * This driver is distributed both as a source RPM and as a compressed tar file of the source. For those not familiar with source RPMs, Digi has created a 'digirpm' shell script which can be used to automatically compile the provided source RPM. The digirpm script will then install the resulting binary RPM automatically. The digirpm script is available at http://support.digi.com/support/drivers/linux/ and is part number 80006862. If you install the tar file of the source, it should be untarred as /usr/src/dg/dgdm and "make install" should be run as root from within the created 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 or use the dgdm adapters. The dgdm startup script will automatically create device nodes at every driver load. 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 but 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. 7. HISTORY Version 1.05-1 (40002059_F) April 17, 2001 - Added support for Linux 2.4 kernel tree, K4 firmware Version 1.04-1 (40002059_E) Jan 16, 2001 - Locking fixes, RPM format changes Version 1.03-1 (40002059_D) August 28, 2000 - Support for cPCI and E1R2. Increased support from 4 boards per machine to 8 boards per machine. Version 1.02-1 (40002059_C) July 7, 2000 - Initial product release for AccelePort Xp product. Version 1.01-1 (40002059_B) Jan 7, 2000 - Initial product release for DataFire RAS and AccelePort RAS products.