INTRODUCTION

Version 1.4 as of 10/04/02.
Assistant version 1.4 as of 10/01/02


These are release notes for KeyspanUSAdriver.kext, the MacOS X driver for the Keyspan family of USB serial adapters.

This version requires OS X version 10.1.3 or later.

Note that now the installer doesn't require reboot.  If running 10.2 or later, device can be used immediately without reboot.  If running 10.1.x you have to manually reboot.

Changes since 1.3:

1. Fixed bundle permissions and file ownership for Mac OS X 10.2
2. Change parts of uninstaller to better line up with 10.2
3. Mac OS X 10.2 fixes the problem where DSR changes were not reported as well as the occasional problem of device plug/unplug resulting in changing port names.
4. Fixed Assistant to correctly identify device and device ICON on 10.2
5. Changed handling of arbitration to eliminate problem where Classic would hang if started with a USB/Serial port open
6. case of txAck/Flush at close and txAck endpoint left in wrong data toggle state fixed.
7. Classic arbitration has been changed so that, by default, Classic can only get the USB/Serial device if it has never been opened by the native OSX driver.

Changes since 1.2:

1. Fixed a bug that could cause a USB/Serial device to hang on open() after initial open/close under certain modem control and timing circumstances.
2. Support has been added for UPSH-112




SOFTWARE OVERVIEW

This softwar release is a Mac OS X kernel device driver.  This means that any failure or bug in this software could easily crash your system and/or compromise your data.  Use caution.

This software supports the following Keyspan hardware:

1. Twin Serial Adapter (models USA-28X, USA-28XA and USA-28XB)
2. PDA Adapter (models USA-19 and USA-19Qi)
3. High Speed Serial Adapter (models USA-19W and USA-19QW)
4. USA-18X Serial Adapter
5. USA-28 USB Serial Adapter
6. USA-49W 4-port Serial Adapter

This version also installs an assistant application, called 'Keyspan Serial Assistant' into the OSX Applications folder.  This application list all Keyspan Serial devices which are currently connected to your computer.


API

This driver provides serial services through the POSIX API.  The names of the two serial ports are:

  - /dev/tty.KeyUSA28X<geo>1  -- or -- /dev/cu.KeyUSA28X<geo>1
  - /dev/tty.KeyUSA28X<geo>2  -- or -- /dev/cu.KeyUSA28X<geo>2

where <geo> is the 2 or more digit geographical name.  (e.g. "913" means USB bus #9, host hub port #1 and external hub port #3)

Note that using the "cu" ports allows you to open() the port with a normal
blocking call and it doesn't wait on DCD.  Open()ing the "tty" port waits for DCD high unless O_NONBLOCK is used.

See the 'man' page on 'termios' as well as /sys/termios.h

Serial Features

The Keyspan USB/Serial driver supports all POSIX serial port features described in termios, subject to the following details and limitations:

1. Baud rates up to 230400 (on USA-28X, USA-18X, USA-19W, USA-19QW); up to 115200 on USA-19Qi and USA-28; up to 57600 on USA-19

2. Xon/Xoff flow control on all devices

3. CTS/DTR hardware flow control on all devices

4. RTS/DSR hardware flow control on devices with DB9 connector (USA-19xx; USA-49W)

5. Modem control on all available signals (input: CTS and DCD, output: DTR on USA-28X and USA-18X).  (input: CTS, DSR, RI and DCD, output: RTS, DTR on USA-19xx and USA-49W)  (see note below)

