EtherLite(R)/SCSI Terminal Server(TM) Driver v4.04 Compaq Tru64 Versions 5.1, 5.0 & 4.0 (formerly Digital Unix) Software Driver P/N 40002065_C Source Code P/N 81000129_C Release Notes P/N 93000355_C August 16, 2001 INTRODUCTION These are the release notes for the software driver for using EtherLite(R)/SCSI Terminal Server(TM) serial and parallel port units for Compaq Tru64 (formerly DEC or OSF) Unix. SUPPORTED PRODUCTS This is the list of units the driver will work with. Some of these units may be legacy units. EL-2, EL-8+, EL-16, EL-160, EL-162, EL-160-VP, EL-32, EM-8, EM-16, X1800, X/SM-5008, SM-5016, SP-1003, ST-1002, ST-1008/X, ST-1016G, ST-1032, ST-1400, ST-1400X, ST-1600, ST-1610, ST-1620,ST-1622, ST1800*, ST-1800X+, ST-2000/X, SX4032. ENHANCEMENTS Added cdelsreset, cdipserv and cdflush utility programs and their man pages. The MKEDEV.sts node builder script now builds the /dev/stsdiag node, which is needed by the new utilities. Added support for Tru64 V5.1. The cdetherd daemon now outputs warning messages when Etherlites are not available for 60 seconds. The cdipserv utility used with V7.9 firmware can now can store the gateway and netmask fields into Etherlite units. Note that the gateway and netmask are not used in normal Etherlite operation, but only when updating firmware. BUG FIXES Fixed a memory leak that occurs several hours later if cdetherd stops running. KNOWN LIMITATIONS None. INSTALL HINTS The driver package must be unpacked by executing the .sis file as if it were a shell script: sh 40002065_C.sis. You then run ./Install, which installs the driver kit, which is named CDSTS300. Etherlite units need an IP address before you install them. You can use bootp to assign them, or see the man pages for cdipserv. Etherlite nodes are named /dev/ttynYX where Y is the unit number, and X is the port number 0-9 or a-v. For SCSI units, as the driver is installed, the unused targets on your available SCSI buses are displayed. You can attach the SCSI units after you power down. HISTORY V4.03 Fixed a bug that would cause a system panic on multiprocessor platforms were a significant volume of data sent through an EtherLite module. V4.02 Added support for Compaq Tru64 UNIX 5.0. Fixed a bug that would cause a system panic were a significant volume of data sent through an EtherLite module. Corrected the manner in which the driver allocates kernel memory for its use. Corrected driver behavior on multiprocessor platforms. Fixed the "disappearing SCSI Terminal Server" problem wherein an STS module would disappear from the SCSI bus after first access. This problem manifested itself only on buses controlled by certain host bus adapters, among them the KZPBA-CA. Added a workaround for a rarely occurring firmware bug which could cause dropped data. Added support for the EtherLite 2 EIA485 and the forthcoming EtherLite 16 Virtual Ports. Changed references to Digital UNIX to reflect the new name of the operating system (Tru64 UNIX). Upped the number of Digi ports which may be in use on a single system from 256 to 2,048. Fixed a number of documentation errors. Support for version 3.x of the operating system has been dropped. V4.02 (an unreleased beta) Upped the number of supported EtherLite units from 8 to 64. V4.00 Changed copyright and device names according to Digi International's requirement as CEntral Data was aquired by Digi. The directory /usr/lib/cendata is changed to /usr/lib/DigiIntl. V3.01 Added support for ST-1400B, ST-1800B, ST-1800B+, EL-2, EL-2.1 and EL-2.2. Fixed the bug that corrupts /etc/inetd.conf file on Digital UNIX 4.0 when Install script enables bootp service. Fixed MAKEDEV.sts script that failed to build device nodes for ST-1610. Dropped man page for MAKEDEV.sts, updated man page for cdconfig, and added man page for cdetherd. Fixed a few minor problems in Install script that handles EtherLite device installation. V3.00 Added support for Central Data EtherLite(R) products. Fixed the bug that could cause system crash when an invalid port is accessed. V2.07 Increased the number of SCSI buses supported to 10. Suppressed the bogus error message displayed when switching the serial ports on ST-8008 units using 'cdab' utility. V2.06 The STS driver is made MP-safe. Fixed cdupdate display problem under Digital UNIX V4.0. Modified MAKEDEV.sts so that the tty ports have permission 0666. V2.05 Ported the STS driver to Digital UNIX V4.0. Discontinued support for Digital UNIX V2.x. Added dinc utility and its man page. Added setup text. V2.04 Fixed the bug that causes ST-2001/2008 to hang during system boot on OSF 3.2c V2.03 Added cdab utility and its man page. Corrected cdstty man page. Fixed a bug in cdstty which could cause core dump when command line options are not set properly. Fixed a bug in driver which causes close() to return error. Fixed a bug in driver which could cuase "FAS_DISABLE interrupted" message pop up at console sometimes. Made hi-water mark for input buffer same as that of internal port, so that STS driver will not fail before the internal port when PARMRK is set, and large number of 0xff's are received. Added Install and Remove scripts for automated installation and removal of STS driver. Changed the way driver handles some ioctl() calls, so that a flurry of ioctl() calls will not cause driver to run out of its internal packets. Made tcsendbreak() blocking. Corrected the way parity error and break condition are handled. Fixed the problem that the driver hangs when close() is called and output is stuck. Modified MAKEDEV.sts so that the tty ports are named according to the naming convention used in most other OS's. V 2.1 Added support for unlimited number of SCSI buses. Added full support for 76800 and 115200 baud rates. Multiple Central Data drivers can now be distributed on a single setld formated tape. Modified the cdupdate utility to support the 'x' wild character in the image product ID. Fixed several bugs in the driver which could cause hangs when a line was closed. Fixed a bug in the driver which would prevent multiple lines from running at 115200. Enhanced input throughput when running at greater than 57600. V 2.0 Modified driver package to work on OSF 3.0. This package is NOT backward compatable and will not work on OSF 2.0 or earlier versions. Added new utility cdmodconf which will modify the /sys/io/common/conf file to add or remove a driver described by a stanza file. Added some additional error checking on opens to prevent the use of a NULL unit pointer. Fixed the MAKEDEV.sts script which became broken due to OSF utilities changing in OSF 3.0. V1.3 & V1.4 Made modifications to allow driver to work under both OSF 1.3 and 2.0. Added baud-op support. Added boot-time probe of STS units. Added the STSGETID ioctl to the driver to allow cdstty to determing the version of the driver. Added the cdprobe script. This is located in /sbin/init.d and is executed at boot time. V1.2 Changed some include lines for OSF 1.3. Fixed a bug in select which would cause a panic. The wrong index was being used with a tty array by the line discipline. Added support for > 57600 baud rates including use of circle queues. Added debug support throughout the driver including FAS command history. Added support to cdstty for debug and driver stats. Fixed a bug in cdconfig which prevented multiple buses from being configured. Changed cdconfig to NOT be run at system boot.