Digi RealPort Device Driver Version 1.1.0 Tru64 4.x, 5.0, 5.1, 5.1A, 5.1B Release Notes P/N 93000484_A Driver Package P/N 40002307_A 01/20/03 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 Tru64 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 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 3. ENHANCEMENTS None. 4. BUG FIXES Fixed problem with the ioctl TIOCMGET returning 8 bytes instead of 4 bytes. Fixed problem with the daemon not working correctly with IPs under Tru64 4.0G. Fixed race condition when loading the driver and autopushing the ldterm module onto the driver. 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. Tru64's "tip" command does not set CREAD by default. This causes the driver's ttys to discard any read data. Digi would recommend using Tru64's "cu" command, or the "dinc" command that is shipped with this package. Both commands correctly set CREAD on. 6. REALPORT SETUP The RealPort package can be installed by the following command: setld -l 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 incorporated into the tty device names. The tty devices will be created following the below specs: Directory for actual serial devices: /dev Directory for print devices: /dev Name of dialout/terminal devices: ttys Name of dialin devices: ttym Name of dialout/terminal print devices: prs Name of dialin print devices: prm Where is the tty device ID, and where is the port number, starting at "001" The Digi RealPort software package can be removed by the following command. It is recommended that all devices related to the package are closed before removing a package. setld -d DGINCXA 7. UPGRADE NOTES When removing the package from the system, you will be offered a chance to "save" your configuration. If selected, the package will leave the /etc/drp.conf file, and create a new file called /etc/drp.init which contains the tty entries of the inittab file that the Realport driver owns. When installing a new version of the driver, if the new package detects an existing /etc/drp.conf file, you will be offered a chance to use the "old" configuration. If selected, the /etc/drp.conf file will be used, and the /etc/drp.init file will be appended to the /etc/inittab file, and finally an "init q" will be run. 8. HISTORY NONE