Release Notes PN 93000400_B Digi RealPort Version 3.3.0 SCO UnixWare Release 7.x Software Package PN 40001130_J 09/24/01 CONTENTS Section Description 1 Intro 2 Supported Products 3 Enhancements 4 Bug Fixes 5 Known Limitations 6 Comments 7 Basic Installation 8 Getting Technical Support 9 History 1. INTRO The Digi UnixWare RealPort (ncxa) driver makes the ports on Digi units appear as though they are local UnixWare tty devices directly attached to the computer. 2. SUPPORTED PRODUCTS PortServer PortServer II PortServer TS Digi One RealPort Device Server Etherlite 2, 160, 162, 80 (with RealPort firmware) 3. ENHANCEMENTS Custom baud rates are now supported for individual ports, either by using the stty-ncxa's cspeed option, or by using the new ioctls: The new ioctls to get and set custom baud rates are defined here: #define DIGI_SETCUSTOMBAUD (('d'<<8) | 106) /* Set custom baud */ #define DIGI_GETCUSTOMBAUD (('d'<<8) | 107) /* Get custom baud */ Keep in mind that the ioctls do not know the valid range of baud rates supported by each unit, and will let you set the baud rate to values that are unsupported by that port. In the examples below, the variable fd is the file descriptor of a RealPort tty device that is currently open by the calling process. - 1 - { int speed, check; if (ioctl(fd, DIGI_SETCUSTOMBAUD, &speed) < 0) { fprintf (stderr,"ioctl DIGI_SETCUSTOMBAUD fails: errno =%x0,errno); } if (ioctl(fd, DIGI_GETCUSTOMBAUD, &check) < 0) { fprintf (stderr,"ioctl DIGI_GETCUSTOMBAUD fails: errno =%x0,errno); } } 4. BUG FIXES None. 5. KNOWN LIMITATIONS This driver no longer supports Unixware 2. There is no way to convert the configuration from the previous UnixWare RealPort driver to the new driver. If you are creating a response script for multiple installations, do not choose to run ncxa_config during the installation process. Responses to ncxa_config will not be saved in the response script. After installation, copy /etc/ncxa.conf to each machine or run ncxa_config on each machine. The alternate start and stop characters are not "sticky", the port must be kept open to retain these settings. 6. COMMENTS Be sure to install all relevant UnixWare patches. For example, an unpatched UnixWare 7.1.0 system will eventually crash if RealPorts are opened and closed repeatedly. UnixWare patches available from SCO fix this problem. Unit ports used exclusively for RealPort use should be configured as type "dev=prn" or "dev=rp". See the hardware documentation for more information on this. 7. BASIC INSTALLATION If you have the file 40001130_J.bin on disk, as root run pkgadd -d /FULL_PATH_TO_DIRECTORY/40001130_J.bin ncxa where you must replace FULL_PATH_TO_DIRECTORY with the full path of the directory containing 40001130_J.bin. If you have the file 40001130_J.bin on a floppy, as root run pkgadd -d diskette1 ncxa - 2 - You can also install the driver by running scoadmin. First choose Software_Management, then Application Installer. To install from a file choose Install From: Other, then enter the full pathname to 40001130_J.bin. To install from a floppy choose Install From: Disk_A, then click on ncxa, and finally click on Install. You must run realport_config to configure the RealPorts for your units. You will need to know the hostname or IP address of each unit, how many ports it has, and what device names you want to use for those ports. The realport_config program will suggest defaults for port names and it has a help option for more information. You can run realport_config during the installation, or after it completes. You can change the configuration at anytime by running realport_config 8. GETTING TECHNICAL SUPPORT Read the the Digi UnixWare RealPort manual, the readme.txt file in /opt/ncxa, the man pages, and the relevant UnixWare documentation. The RealPort manual has installation and configuration instructions and a trouble shooting section which might be helpful. The readme.txt file and man pages have technical details about this driver. Contact Digi Technical Support by email at support@digi.com, on the web at www.digi.com/support, or by phone at (952) 912-3456. 9. HISTORY Ver 3.2.0 The driver now supports new RealPort units which are listed above, and the fastbaud rates are now changed to support rates up to 921600. Note that older units may not support the highest baud rates. Here is the new fastbaud table: 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 - 3 - 9600 - 9600 19200 - 19200 38400 - 38400 Please note that if you select a baud rate the unit cannot handle, you will not get an error message. Spurious RWIN updates are no longer made. Ver 3.0.3 The Unixware driver has been redesigned and rewritten for better performance and capablities. Improved configuration utilities allows units to be added and removed dynamically. Man pages for the driver, daemon, and utilities have been added. 4. BUG FIXES NA - 4 -