DigiWARE Release Notes 93000186K for Digi AccelePort Device Driver Compaq Tru64 4.X & 5.X Software Package P/N 75000186K Diskette P/N 40001180K V1.5.1 (3.5") Software Manual P/N 92000186D April 6th, 2001 INTRODUCTION: This DigiWARE software package includes device drivers for PCI, EISA, and ISA adapters in the EPC/X, C/X, Xem and Xr product families. This package includes all the necessary driver binaries, firmware images, configuration scripts, etc. SUPPORTED PRODUCTS: AccelePort C/X ISA/EISA/PCI AccelePort EPC/X ISA/EISA/PCI AccelePort Xem ISA/EISA/PCI AccelePort Xr ISA/PCI AccelePort Xr 920 ISA/PCI ENHANCEMENTS: REMOVED Digital Unix 3.2 support. Added support for the Acceleport 2r 920 PCI. Allow install on beta revisions of the OS. BUG FIXES: The device driver now allows setting baud rates of 57600 and 115200 without the use of the "fastbaud" option of the driver, since the operating system native mechanisms allow this. KNOWN LIMITATIONS: This version of the Compaq Tru64 driver does nnoott currently support the boot-linked kernel option of the operating sys- tem. Compaq Tru64 4.x & 5.x - 1 - Release Notes Compaq Tru64 4.x & 5.x - 2 - Release Notes HISTORY: Version 1.5.0: The device driver would not properly link with 5.x ker- nels. A new 5.x specific image is now shipped with the driver package. Version 1.4.2: The device driver incorrectly handled a particular set of circumstances involving software flow con- trol. The following set of conditions will demon- strate the problem in older revisions of the driver (other sets of conditions may also produce the same effect due to the bug): Both the sender and receiver are using software flow control, The sender uses an application which inserts an in-band ioctl inbetween two _b_u_r_s_t_s of data, The very last character of the first _b_u_r_s_t of data causes the receiver to transmit an XOFF character, The ioctl processing (which is allowed to continue immediately because the transmitter is empty) completes before the receiver transmits the XON character, The second _b_u_r_s_t is transmitted as soon as the ioctl returns a successful status. When all of the above conditions were met, the driver began transmitting the second _b_u_r_s_t before the XON was received from the receiver due to a bug in the driver. As a result, a chance existed for the receiver to overrun, and for data loss to occur. This hole in the handling of software flow control within the ioctl processing has been fixed in the 1.4.1.1 device driver. In the unlikely case that an installation depends on the questionable behavior of the driver forcing the resumption of transmission during the process- ing of in-band ioctls (after waiting for drain), the behavior may be re-enabled with the hidden _d_i_t_t_y switch _i_o_c_t_l_r_e_s (standing for _I_O_C_T_L _p_r_o_c_e_s_s_- _i_n_g _f_o_r_c_e_s _R_E_S_u_m_p_t_i_o_n). Compaq Tru64 4.x & 5.x - 3 - Release Notes Version 1.4.1: This version of the Compaq Tru64 driver now sup- ports the use of the following hardware: 4 and 8 port Digi AccelePort Xr 920 ISA 4 and 8 port Digi AccelePort Xr 920 PCI The driver installation and configuration pro- cedures have been modified to: Correctly name the installed package with the same three digit code as the version number of the device driver. Allow the reconfiguration of an installed device driver. Save driver configuration across driver up- dates. To determine the installed driver package, enter the following command: sseettlldd --ii || ggrreepp DDGGII The installed package has the keyword _i_n_s_t_a_l_l_e_d next to it in the listing. To reconfigure an installed device driver: sseettlldd --cc <> ccoonnffiigg Where _p_a_c_k_a_g_e is replaced by the installed package name as determined above. The new driver package will ask if you would like to save the current configuration if you remove it with the ``_s_e_t_l_d -_d'' command, and will ask if you would like to use this saved configuration if it detects one during the install process. The firmware shipped with the 1.4.0 device driver for use with the C/X product line had a bug in it which inhibited normal operation. All of the firmware images have been updated in this revision of the software to address this bug. The Digi _f_a_s_t_b_a_u_d flag used to be oonn by default, causing problems for applications trying to use slower baud rates with freshly installed packages. Compaq Tru64 4.x & 5.x - 4 - Release Notes The _f_a_s_t_b_a_u_d flag now defaults in the ooffff state. As always, the _d_i_t_t_y utility may be used to toggle this flag. Version 1.4.0: This version of the Compaq Tru64 driver now sup- ports the use of the following hardware: 4 and 8 Port Modem/Xem EBI modules The driver has been modified so that users may en- able (with a ditty option) processing in the dev- ice driver which correctly handles the CRTSCTS control flag available in the _t_e_r_m_i_o_s structure in Compaq Tru64 4.x. This flag is used by the _c_r_t_s_c_t_s option of _s_t_t_y in Compaq Tru64 4.x and provides a user mode method for setting and clearing hardware pacing, normally only available via Digi's ditty utility. The _d_i_t_t_y utility has been modified to include a new option: _o_s_r_t_s_c_t_s. This option, by default, is off, and should NOT be turned on by users of Com- paq Tru64 3.2x. Compaq Tru64 4.x users can turn this feature on to enable the _c_r_t_s_c_t_s functionali- ty of the stty utility to get and set the status of RTS/CTS hardware flow control. With this driver revision, Compaq Tru64 4.x custo- mers can use the _d_i_t_t_y utility to turn on the _o_s_r_t_s_c_t_s flag for a port. Once on, hardware flow control can be controlled by the _s_t_t_y _c_r_t_s_c_t_s com- mand. When the _o_s_r_t_s_c_t_s flag is enabled, applica- tions which do nnoott set the CRTSCTS flag in the _c_f_l_a_g_s of their termios structures will cause hardware flow control to be disabled, even for the _m_o_d_e_m _c_o_n_t_r_o_l devices (those ending in the letter `m'). The driver would sometimes fail after about 24 1/4 days of system uptime due to the incorrect han- dling of an internal counter. This problem has been eliminated. The entries in the /etc/inittab file which are ad- ded during adapter configuration were written in- correctly on Compaq Tru64 4.x systems; this behavior has been corrected. A minor modem signaling bug on the Xr and Xem adapters has been addressed via the updating of the firmware images accompanying the driver. Compaq Tru64 4.x & 5.x - 5 - Release Notes The TCSBRK, TIOCSBRK, and TIOCCBRK ioctls would not wait for buffered output data to drain from the adapter before being processed. As a result, requests to set and clear _b_r_e_a_k would not execute in sequence with the data stream. Also, code which depends on the _d_r_a_i_n_i_n_g of output data as a side effect of setting break (i.e. the _t_c_d_r_a_i_n function, which causes a TCSBRK ioctl to be sent to the driver) would not wait for drain as expect- ed. This behavior has been fixed in the current revision. The device driver was not properly enabling the default flow control scheme at device open time, resulting in instances in which the modem control devices (or `m' devices) would not have RTS/CTS flow control enabled immediately after opening. This has been corrected. Compaq Qualification: Certain versions of the Compaq Tru64 device driver software have passed Compaq's software qualification process in ac- cordance with the following table. This information is pro- vided solely for the convenience of our customers. _________________________________________________________________ Diskette Part Number: 40001180E Software Revision: 1.3.0 __________________________________________________________________________________________________________________________________ Compaq Qualified Operating System Hardware Platform Digi Hardware Version _________________________________________________________________ Compaq Tru64 3.2g AlphaStation 255/233 AlphaStation 255/300 AlphaStation 500/266 AlphaStation 500/333 AlphaStation 500/400 AlphaStation 500/500 AlphaStation 600/266 AlphaStation 600/333 PCI/4r PCI/8r _________________________________________________________________ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | _________________________________________________________________ Diskette Part Number: 40001180F Software Revision: 1.4.0 __________________________________________________________________________________________________________________________________ Compaq Qualified Operating System Hardware Platform Digi Hardware Version _________________________________________________________________ Compaq Tru64 4.x & 5.x - 6 - Release Notes AlphaServer 300 AlphaServer 400 AlphaServer 800 AlphaServer 1000 AlphaServer 1000A AlphaServer 2100 AlphaServer 2100A AlphaServer 8200 ISA/16em ISA/EPC Compaq Tru64 4.0b _________________________________________________________________ AlphaServer 4100 ISA/16em ISA/EPC PCI/4r PCI/8r PCI/16em Compaq Tru64 4.0b _________________________________________________________________ AlphaServer 8400 PCI/4r PCI/8r PCI/16em Compaq Tru64 4.0b _________________________________________________________________ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Compaq Tru64 4.x & 5.x - 7 - Release Notes