Digi RealPort Device Driver Version 2.6.0 Solaris 2.6, 2.7, 2.8, and 2.9 for SPARC and Intel Release Notes P/N 93000184_M Diskette P/N (3.5) 40001174_L 07/12/02 CONTENTS Section Description 1 Introduction 2 Supported Products 3 Enhancements 4 Bug Fixes 5 Known Limitations 6 RealPort Setup 7 Upgrade Notes 8 History 1. INTRODUCTION The Digi Solaris RealPort driver makes the serial ports on a Digi RealPort enabled product appear as though they are local tty devices directly attached to the computer. When the system boots, one ncxd daemon is spawned for each RealPort enabled unit. Each daemon makes a single TCP/IP connection to its associated RealPort enabled unit and sends all asynchronous serial data on this single connection. Digi RealPort enabled ports can be accessed any time they are configured for RealPort operations and are not otherwise in use. The RealPort service requires the TCP/IP driver to be installed and properly configured. 2. SUPPORTED PRODUCTS RealPort is supported on the following Digi products: Digi One RealPort Device Server EtherLite 2 EtherLite 80 EtherLite 160 EtherLite 162 PortServer 8 PortServer 16 PortServer II 16 PortServer TS 2 PortServer TS 4 PortServer TS 8 PortServer TS 16 3. ENHANCEMENTS Added official support for Solaris 9 (2.9) 4. BUG FIXES Fixed bug "off by one" for setting baud rates with cfset[io]speed above 115200 was fixed. Fixed bug that would not permit baud rates to be set to 57600. If 57600 was attempted to be set, it would send a HANGUP to the port instead. Fixed bug during a transparent ioctl - TIOCMGET. This would cause incorrect modem signals returned to the user. Problem involved COPYOUT. Fixed bug in the ncxd daemon. If the rc script would be used by the user to stop- then start the daemons, the daemon would not be inherited by init correctly. 5. KNOWN LIMITATIONS If a Digi RealPort enabled unit loses power it may be necessary to wait for up to 2 minutes before communication is re-established with the device. If a port is interrupted in the middle of data transfer it will not die until the data has completely drained. This behavior occurs because of a bug in the Solaris kernel. There is a kernel function called by the Solaris ldterm module that does not respond to a KILL signal when it should. 6. REALPORT SETUP The RealPort package can be installed by the following command: pkgadd -d 40001174_X.bin The RealPort devices can be setup using the drpadmin tool. To run the tool you must be root. Run the tool with the following command: drpadmin The drpadmin tool is simple to use. You can add a RealPort device, remove a RealPort device, or view the RealPort devices currently setup. The drpadmin tool will ask for an IP address, number of ports, and the tty device id. The IP address should be the IP address or domain name associated with the IP address that was assigned to the RealPort enabled unit when the unit itself was configured. The number of ports are simply the number of serial ports on the device. The tty device id is the id that will be incorported into the tty device names. The tty devices will be created in the following directories: Directory for actual serial devices: /dev/dty Directory for print devices: /dev/dpr Directory for links to tty devices: /dev/term Directory for links to cu devices: /dev/cua The Digi RealPort software package can be removed by the following command. It is recommended that all devices related to the software and supporting utilities are closed before removing the software package. pkgrm realport See the install_notes.txt located in the /opt/realport directory for more details on RealPort tty device operation. 7. UPGRADE NOTES When upgrading from a driver version 2.x and later the information used to create RealPort devices can saved and restored with the following steps: 1) Copy the file "/opt/realport/drp.conf" to a location that will not get destroyed when the old driver is removed. 2) Remove the old driver from the system. 3) Add the new driver to the system. 4) Copy the "drp.conf" file saved in step 1 to the "/opt/realport" directory. 5) Run the utility "/opt/realport/utils/ncx_verify_conf" to create the devices and startup the network daemons. 8. HISTORY Version 2.5.0 Enhancements The ditty tool has been enhanced. Support for setting custom Baud rates has been added. Support for setting multiple devices on the same ditty command line has been added. RealPort is now supported by the EtherLite family. RealPort enabled firmware must be loaded on the EtherLite unit for RealPort to function properly. Added the ability to reset the RealPort network daemon with the drpadmin tool. Added a man page for this driver named realport. Bug Fixes A bug where a structure was not initialized properly was fixed. The drpadmin tool was modified to prevent simultaneous instances of this tool from modifying the drpadmin database at the same time. The behavior of the driver was modified to recover from hangup conditions. This was done to be consistent with the Solaris serial driver and allow terminal logins using Solaris's ttymon to recover properly after a hangup without using the soft carrier option. Version 2.4.3 - August 16, 2001 Enhancements: The internals of the driver have been rewritten. The driver was rewritten to make the driver more robust and efficient. This driver has all of the functionality of the previous driver. One exception is that this driver now supports extended baud rates. Extended baud rates are baud rates supported by Solaris that allow serial devices to exceed 38400 baud. Previously these higher baud rates could only be accessed using the "ditty fastbaud" option. The method for installing new RealPort devices has been modified. RealPort devices can now be added and deleted using a tool called drpadmin. The method for adding RealPort devices as part of the installation time has been removed. The option of selecting where the RealPort devices are placed has been removed. The RealPort devices are placed in the following directories: /dev/dty <- tty and cu devices /dev/dpr <- transparent print devices /dev/cua <- links to cu devices /dev/term <- links to tty devices Bug Fixes: A bug that caused data loss has been resolved. Version 1.8.0 - June 6, 2001 Enhancements: Added support for the PortServer III terminal server. Added support for the PortServer Lite terminal server. Added support for the EtherLite terminal server. Version 1.7.1 - January 25, 2001 Enhancements: Updated Release Notes to include support for Solaris 2.8. Bug Fixes: Fixed a system panic that resulted from an invalid putctl. Fixed a problem sending break through to console. Version 1.7.0 - October 19, 2000 Enhancements: Added support for Solaris 2.8 to Release Notes. Version 1.7.0 - January 10, 2000 Bug Fixes: A problem with the driver holding a lock while removing the service routines from the service queue has been resolved. The symptom of this error was a random system crash that was seen on multi-processor systems. Enhancements: Changed format of release notes. Version 1.6.0 - November 23, 1998 Enhancements: Added support for Solaris 2.7. Added 64 bit support for SPARC 2.7 portion of driver. Version 1.5.0 - May 15, 1998 Bug Fixes: Fixed a failing connectivity issue, seen with more than 4 PortServers. Version 1.4.0 - December 23, 1997 Bug Fixes: Fixed a daemon reattach problem seen over frame relay connection. Fixed problem with EBI modules not functioning properly.