Release Notes P/N 93000159_S Digi RealPort Driver Package Version 3.0.3a for SCO OpenServer 5.0.4c, 5.0.5, 5.0.6 and 5.0.7 Software Package P/N 40001044_R November 12th, 2003 CONTENTS Section Description 1 Introduction 2 Supported Products 3 Enhancements 4 Bug Fixes 5 Known Limitations 6 History 7 Notes Introduction The Digi RealPort driver is a set of TCP network drivers that provides real tty functionality for Digi's Ethernet-based Serial Products. This driver supports SCO Openserver 5.0.4c, 5.0.5, 5.0.6 and 5.0.7 This package also contains: 1) drpadmin: Allows root the ability to add or remove RealPort products in the driver. 2) ditty: Digi's stty replacement. 3) dinc: A cu replacement. Simpler to use than cu. 4) dgipserv: Stores and saves an IP on selected Digi products. 5) dgelreset: Allows root the ability to reboot a local or remote EtherLite. This RealPort package includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/). Supported Products RealPort is supported on the following Digi products: Digi One EM Digi One IA Digi One IA RealPort Digi One RealPort Digi One SP Digi One TS Digi Flex Digi PortServer Digi PortServer II Digi PortServer II Rack Digi PortServer TS 2 Digi PortServer TS 4 Digi PortServer TS 8 Digi PortServer TS 16 Digi PortServer TS 16 Rack Digi EtherLite 2 Digi EtherLite 8 Digi EtherLite 16 Digi EtherLite 32 Digi EtherLite 80 Digi EtherLite 160 Digi EtherLite 162 Enhancements None. Bug Fixes Fixed problem under SCO OpenServer 5.0.7 with getty when Digi's "fastcook" option is turned on, which is on by default. The first login on the port through getty would work, subsequent logins on the port would fail. Known Limitations This driver has a limit of 255 RealPort products. Each RealPort product configured will use 1 major number. SCO Openserver has a fundamental limit of 255 major numbers for everything in the system. This means the actual limit of the amount of RealPort products that the driver supports will be based on how many major numbers your system has left to give the driver. Check /etc/conf/cf.d/mdevice and the man mdevice(F) page for more information. SCO Openserver requires us to declare the amount of majors we plan to use and then rebuild the kernel, and reboot. When adding new RealPort products to your system after installing the driver, you may be required to rebuild and reboot your system. SCO Merge is no longer supported. The default TCP port for RealPort units is 771. This port is officially reserved for rtip. If you are using rtip you will need to configure your units and RealPort driver to use a different TCP port. Driver support for RealPort with encryption is only supported for Digi products that also include support for RealPort with encryption. Not all Digi products support encryption. Please check your Digi product's firmware documentation for more information. History Version 3.0.2c Enhancements dgipserv - Added support to set unassigned Ethernet address, support for setting the tftp server IP address, support for setting virtual ports and virtual ports timeouts, and support for setting optimize to throughput or latency. Bug Fixes Fixed problem on tty close. The driver could have flushed tty data instead of properly draining the data due to incorrect "flag" values being passed into the tty close routine by the SCO OpenServer kernel. Fixed problem in the read routine during "raw" reads. If the driver were to get interrupted while waiting for data to be read, the driver would return 0 with an errno value of 0. The correct implementation requires the driver to return -1 with errno set to EINTR. Version 3.0.1a Enhancements Added support for SCO Openserver 5.0.7 drpadmin now allows "stacking" multiple RealPort Products off of one tty id. For tty ids that are 1 character, there can be up to 999 ports stacked on that id. For ids that are 2 characters long, there can be up to 99 ports stacked on that id. Bug Fixes Fixed locking problem while setting the line speed of remote products. Fixed mon device problem of reading data past 65K. Fixed race condition where an open to a port could come in while we are in the middle of closing the same port. This could have caused a panic. Fixed custom baud rate support. ditty was not setting it. Fixed deadlock race condition under SMP kernels that could cause a panic if the Openserver kernel called the driver in a certain order. Fixed problem with the driver causing Openserver's VHAND process spiking the CPU to 100%, when a high number (70+) of RealPort products configured. This problem can be triggered by any 3rd party driver, and even in the kernel functions themselves. Reference this URL for more information: http://www.aplawrence.com/Bofcusm/1703.html Version 3.0.0e Bug fixes: Fixed panic when calling ioctl with IOC_SELECT and other commands. Corrected unlocking. Fixed problem where "delete" in drpadmin would not kill the daemon. Problem involved "/etc/dprd". Fixed problem where the poll rate of the driver was set too high. It would cause the system cpu usage to increase dramatically when used with specific applications. Fixed problem where multiple opens to the same serial port might cause programs to fail. Enhancements: This is the first release of the completely rewritten RealPort driver. ditty printer option is now supported. Added headers in drpadmin for "show" command. Notes If you uninstall the software, you are given the option to save your configuration. If selected, the driver and utilities save all the current inittab and ttytype entries of all configured RealPort ports. This allows for easy driver upgrades without losing any configuration. The fastbaud table of substitute baud rates is now: 0 - 0 50 - 57600 75 - 76800 110 - 115200 134 - 131657 150 - 153600 200 - 230400 300 - 460800 600 - 921600 1200 - N/A 1800 - N/A 2400 - 2400 4800 - 4800 9600 - 9600 19200 - 19200 38400 - 38400 The new ioctls to get and set custom baud rates are defined here: #define DIGI_SETCUSTOMBAUD (('e'<<8) | 106) /* Set custom baud */ #define DIGI_GETCUSTOMBAUD (('e'<<8) | 107) /* Get custom baud */