
RocketPort(R) Device Driver for Windows(TM) NT Operating System
Part Number: 6540 (V2.6)

---------------------------------
INSTALLING THE BOARD

Note:  For more detailed installation instructions, see the Reference
       Card that came with the RocketPort Board.  The Setup program 
       that you install for the RocketPort board has addition help 
       information.  To access this information prior to installing 
       the board, you canRun>"WINHELP setup.hlp".

1. Select and set a valid I/O address range for each RocketPort ISA 
   board.(A table of switch setting is provided near the end of this 
   file. The ISA board ships with the default 180H address setting.)

   For a RocketPort PCI board the computer's BIOS sets the I/O address.

2. Install the RocketPort board(s) into the computer.

3. Connect the peripherals. For more detailed information, see the 
   Hardware Reference Card that came with the controller.

4. Restart the system.


---------------------------------
INSTALLING THE DEVICE DRIVER

1. Start the Control Panel from Program Manager.

2. Double-click on the Network icon in the Control Panel to start up
   the network applet.

3. Click on the <Add Adapter...> button when the Network Settings 
   dialog box appears. The Add Network Adapter dialog box appears.

4. In the list box, go the the botton and choose the "<Other> Requires 
   disk from manufacturer" option. 

5. Click on the <Continue> button.

6. Set the path you are installing from.  If from a floppy, set it to
   a: or b: and insert the Comtrol RocketPort device driver for the
   Windows NT System. Click on the <OK> button.

7. Click on the <OK> button, the RocketPort installation screen 
   appears.

8. Select unused I/O address ranges for each ISA controller; or PCI-BUS
   if the controller is a RocketPort PCI controller.  PCI controllers 
   must be installed before ISA controllers, if you have both.

9. Select the Starting COM Port for the first controller.

   Make sure these selections do not conflict with other peripherals
   installed in the system or an existing COM port number.

10. Click on the <OK> button after making your selections.

11. Close the Network Settings dialog box.

12. Select NO when the system prompts you to shutdown and restart.

13. Close the Control Panel.

14. Remove the diskette from the drive.

15. Shut down the system and restart the computer to start the driver.


---------------------------------
VERIFYING THE INSTALLATION

Use the following procedures to verify the installation.

1. Double-click on the Event Viewer icon.

2. If the installation was successful, a log entry for the RocketPort
   controller displays stating that the RocketPort device driver
   initialized its hardware. If the device driver did not load, a Stop
   Event Log entry for the RocketPort controller states that there was
   a problem and that the driver was not loaded.

If your installation was not successful, check that RocketPort ISA
boards are configured with the proper I/O address switch settings and
that the I/O address selection in the RocketPort setup program is
configured to match.

The RocketPort board comes with a bootable diagnostic disk.  This 
diagnostic is used to verify proper operation of the RocketPort board.
You can run this diagnostic by booting with the diagnostic diskette in 
A: drive. Use the loopback plug that came with the RocketPort board for
the tests. 

Read over any RocketPort events in the Event Viewer.

In the Advanced Options menu in the setup program, you can select
"Verbose EventLog" that may provide additional event logs to help 
determine installation problems.

In addition, the Windows NT Diagnostics program in the Administration 
Group can be a useful tool for determining what resources are 
available.


---------------------------------
USING THE ROCKETPORT WITH NT-REMOTE ACCESS SERVER (RAS)

If using the RocketPort series to provide dial-in access to the NT
system, you may need to re-install RAS after the RocketPort 
installation before RAS will see the new ports.


---------------------------------
TROUBLESHOOTING COMMUNICATIONS WITH EXTERNAL DEVICES

You can use a simple terminal program to help troubleshoot 
communications problems with Modems and other external equipment. 
NT comes with the TERMINAL.EXE program, and Comtrol provides 
some test programs such as WCOM32.EXE and RTTY.EXE.  A modem should 
echo back characters sent to it. If you type "AT" and press <ENTER>,
an "OK" response should return.

If no characters are echoed back on the screen, the first thing you 
should do is disconnect the cable, and install the test loopback plug 
that came with the RocketPort board.  The plug will "loopback"(echo) 
any characters typed back to the communications program, which should 
be seen on the screen.


---------------------------------
UPGRADING THE DEVICE DRIVER TO A NEW VERSION

To upgrade the device driver to a new version, the driver should be
removed by following the directions in the "Removing the Device 
Driver" section.  Afterwards, follow the same directions in the
"Installing the Device Driver" section.


---------------------------------
CHANGING DEVICE DRIVER SETTINGS

Use the following procedure to change existing device driver settings.

1. Double-click on the Setup icon in the Comtrol program group.

2. Select unused I/O address ranges for each board,
   and the Starting Com Port number for the device driver. Make
   sure that these selections do not conflict with other peripherals
   installed in the system or an existing COM port.

   If you are changing the I/O addresses, make sure that you record the
   new switch settings.

3. Click on the <OK> button.
 
4. Shut down the system after making any changes by selecting the
   File | Shutdown options from the Program Manager.

5. If you changed I/O addresses, turn off the computer when the
   shutdown is complete, and reset the DIP switch on the RocketPort ISA
   controllers.

6. Restart the system.


---------------------------------
REMOVING THE DEVICE DRIVER

1. Start the Control Panel from the Program Manager.

2. Double-click on the Network icon in the Control Panel to start up
   the network applet. 

3. Select the Comtrol RocketPort entry from the Installed Adapter Cards
   list (not the Installed Network Software list) when the Network 
   Settings dialog box appears.

4. Click on the Remove button.

5. Close the Network Settings dialog box.

6. Reboot the system so that the driver removal takes effect.


---------------------------------
SETTING DEFAULT COMMUNICATIONS PARAMETERS

Use the following procedure to change the COM port default settings.
Most applications configure the port directly, so this procedure is
not required in most instances.

Note:  The settings configured by the Ports applet take affect each
       time the system reboots.

1. Start the Control Panel from Program Manager.

2. Double-click on the Ports icon to start the Ports applet.

3. Select the desired COM port.

4. Click on the Settings... button.

5. Choose the desired settings for the COM port.

6. Close the Settings window.

7. Close the Ports applet.

8. Close the Control Panel.

9. Reboot the system so that the desired changes take affect.


---------------------------------
NOTES ON SETTING UP MULTIPLE ROCKETPORT ISA BOARDS

The I/O addressing of multiple RocketPort ISA boards can be a bit 
confusing. If you are installing additional boards, set the switches 
according to the chart for the first board.  The actual I/O address 
selection for the additional boards is determined by the setup program 
and not by these switch settings.  The I/O address selections for 
additional boards can be changed using the setup program without 
adjusting the switch settings.


---------------------------------
SWITCH SETTINGS

Graphical representations are available in the setup help and 
Installation Card Documentation. See the note below for multiple 
board settings.

ISA-RocketPort Switch Settings 
===============================================================
  8 7 6 5 4 3 2 1                         8 7 6 5 4 3 2 1
  ---------------  off                    ---------------  off
	    X   X                                   X X  
  X X X X X   X                           X X X X X     X
  ---------------  on                     ---------------  on
    100 - 143                                140 - 183
===============================================================
  8 7 6 5 4 3 2 1                         8 7 6 5 4 3 2 1       
  ---------------  off                    ---------------  off  
	    X X X                                 X     X
  X X X X X                               X X X X   X X         
  ---------------  on                     ---------------  on
    180 - 1C3 (Default)                       200 - 243
===============================================================
  8 7 6 5 4 3 2 1                       8 7 6 5 4 3 2 1
  ---------------  off                  ---------------  off
	  X   X                                 X   X X
  X X X X   X   X                       X X X X   X    
  ---------------  on                   ---------------  on
    240 - 283                                 280 - 2C3
===============================================================
  8 7 6 5 4 3 2 1                       8 7 6 5 4 3 2 1
  ---------------  off                  ---------------  off
	  X X   X                               X X X  
  X X X X     X                         X X X X       X 
  ---------------  on                   ---------------  on
    300 - 343                                 340 - 383
===============================================================
  8 7 6 5 4 3 2 1       
  ---------------  off  
	  X X X X       
  X X X X               
  ---------------  on   
    380 - 3C3   
===============================================================
For a second RocketPort ISA card, set as 1st card, and switch 5 off.
For a  third RocketPort ISA card, set as 1st card, and switch 6 off.
For a  forth RocketPort ISA card, set as 1st card, and switch 5&6 off.
---------------------------------

DEVICE DRIVER CAPABILITIES AND LIMITATIONS

This device driver was written to the Win32 API, this means that it 
also works with applications like:

*  Terminal programs

*  Remote Access Server NT

Note: Device names above COM9 require the \\.\ (backslash backslash 
      period backslash) in order for the system to recognize them. 
      For example, to reference COM20, use  \\.\COM20 as the file name

The following lists device driver capabilities and limitations for the 
Win32 API.

          DEVICE CONTROL BLOCK SETTINGS

Item	           Status
--------           ------------------------------------------
BaudRate           Any valid baud rate between 75 and 460,800
ByteSize           7 or 8
ErrorChar          Supported
EofChar            Not used, supports only binary
EvtChar            Supported
fAbortOnError      Supported
fBinary            Always binary mode
fDtrControl        Supported
fDsrSensitivity    Not supported
fErrorChar         Supported
fInX, fOutX        Supported
fNull              Supported
fParity            Supported
fOutxCtsFlow       Supported
fRtsControl        RTS_CONTROL_DISABLE, RTS_CONTROL_ENABLE, 
                   RTS_CONTROL_HANDSHAKE, RTS_CONTROL_TOGGLE
fTXContinueOnXoff  Supported as always TRUE
Parity             EVENPARITY, NOPARITY, or ODDPARITY
StopBits           ONESTOPBIT or TWOSTOPBITS
XonChar, XoffChar  Supported

          UNSUPPORTED IOCTL FUNCTIONALITY

Item                           Status
------------------             ------------------------
IOCTL_SERIAL_XOFF_COUNTER      Not Supported
IOCTL_SERIAL_SET_HANDFLOW      SERIAL_DSR_HANDSHAKE,
    (Unsupported options)      SERIAL_DCD_HANDSHAKE, SERIAL_DSR_SENSITIVITY
IOCTL_SERIAL_GET_COMMSTATUS    fCtsHold, fDsrHold, fRlsdHold, 
    (Unsupported options)      fXoffHold, fXoffSent


---------------------------------
Driver History

11-05-96, V2.6 - Formal release of previous BETA changes.

10-31-96, V2.51.009B - Fix bug where incoming data may time-out
  as incomplete, even though the data had been read in.

10-31-96, V2.51.007B - Adjust close routine to allow more time for
  outgoing data to complete.  Previously caused problems with some
  serial printers.

10-22-96, V2.51.006B - Add code to handle small packet writes faster.
Fix PCI support to handle multiple PCI buses properly, add some
hardware checks for PCI.

9-26-96, V2.51.005B - Fix for Delrina SAPS software, would error
out opening port due to problem with DCB xon,xoff chars setup when
using hardware flow control.

7-25-96, V2.51.004B - Compile initial PowerPC version.

7-25-96, V2.51.003B - minor change to avoid PCI system calls if no
  PCI boards setup.  Avoids hang in customers Intergraph 4-processor system.

7-10-96, V2.51.001B - added support for SETXOFF escape function for
  Predator software.

5-31-96, V2.51  Formal Release(non-beta).

5-29-96, V2.50.006  Fix escape char used by NT virtual port, so MSDOS
  applications can use on COM3/COM4(if RocketPort starts at COM3.)

5-24-96, V2.50.005  Addition: Add support for PCI 8-port RJ, add in
  newer WCOM32 test terminal, add rktmon.exe monitoring program.

5-09-96, V2.50.004  Bugfix: memory allocation in init code not large enough,
  may have caused problems during init phase.

5-03-96, V2.50.003  Bugfix: buffer overflows were not being reported
  properly.

5-03-96, V2.50.002  Added input queue dynamic buffer sizing.

5-01-96, V2.50.001  Changes to driver initialization code, additions and
  enhancements to setup program.  Inclusion of a test terminal
  program: WCOM32.EXE.  Take out rcktutil.exe.

4-25-96, V2.4.005  Produce an initial ALPHA driver.

2-29-96, V2.4.002 Changes to run off system timer as well as IRQ.

11-20-95, V2.2
      Changed to not use HalQuerySystemInfomation since it is not 3.5 
      compatible.

11-10-95, V2.1  Added support for PCI boards.


---------------------------------
TECHNICAL SUPPORT

USA
    Phone: (612) 631-7654
      FAX: (612) 631-8117
      BBS: (612) 631-8310
    email: support@comtrol.com

Comtrol Europe
    Phone: +44 (0) 1 869-323-220
      FAX: +44 (0) 1 869-323-211
      BBS: +44 (0) 1 869-243-687
    email: support@comtrol.co.uk

  Web: http://www.comtrol.com
  FTP: ftp.comtrol.com


TECHNICAL INFORMATION / PROGRAMMERS SAMPLE CODE

Additional technical information and sample code for Windows is
available on the Comtrol BBS or FTP site.

---------------------------------
ALPHA is a trademark of Digital Corporation.
Comtrol is a trademark of Comtrol Corporation.
PowerPC is a trademark of IBM Corporation & Motorola Corporation.
RocketPort is a registered trademark of Comtrol Corporation.
Windows is a trademark of Microsoft Corporation.

