The RocketPort(R) FreeBSD Driver (XXXX) Release 1.4  Feb 28, 1997
  -- A driver for the Comtrol(tm) RocketPort Intelligent Serial Port Cards

PRODUCT OVERVIEW
----------------
This driver provides a kernel device driver for the RocketPort and 
RocketPort RA serial boards. These boards provide, 8, 16, or 32 high-speed
serial ports while requiring only 68 bytes of I/O space for all 8, 16, or 32
ports, and do not require an interrupt channel. This driver supports
up to four RocketPort or RocketPort RA boards in one machine simultaneously.
If you are using four 32 port RocketPort boards, you can put as many as 128
intelligent serial ports on your system.

For dealer, distributor and other information regarding Comtrol RocketPort,
contact Comtrol Corporation at (800) 926-6876 or email: info@comtrol.com.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
SYSTEM REQUIREMENTS
-------------------

The driver requires FreeBSD version 2.2 or higher.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
INSTALLATION PROCEDURES
-----------------------
Read the instructions found in the HW-INSTALL file or the Hardware Reference
Card shipped with the board to install the RocketPort into your computer.

After the board(s) are installed, you will need to build a new kernel
for your system with the RocketPort driver installed.  See the BSD/OS
2.0 documentation for an in-depth background information on building
and configuring BSD/OS kernels.

1.  Copy the comtrol-freebsd-beta.tar.gz file to /usr/src

2.  Untar the file using tar and gunzip like this:
		cd /usr/src
		gunzip < comtrol-freebsd-beta.tar.gz | xvf -

3.  A subdirectory of /usr/src now exists called comtrol.  This contains the
    RocketPort driver and associated files.  Change your current
    working directory to this directory:
		cd /usr/src/comtrol

4.  Copy the rocket port device driver files into your kernel source tree:
		cp rp.c rpreg.h rpvar.h /sys/i386/isa


5.  Edit your kernel configuration file.  This is a file located in
    /sys/i386/conf which controls which devices are configured for
    your particular machine.  Its name is in all capital letters; for
    example, GENERIC, FLOPPY, or LOCAL.  See page 165 of the 
    Running FreeBSD manual.

    You will need to add the lines which look like the following to
    your kernel configuration file:

		# Comtrol Rocketport(ISA)
		device	rp0	at isa? port 0x180 tty
		device	rp1	at isa? port 0x100 tty
		device	rp2	at isa? port 0x340 tty
		device	rp3	at isa? port 0x240 tty

    The lines starting with "rp0", "rp1", "rp2", "rp3" configure the
    I/O address for your first, second, third, and fourth Comtrol
    Rocketport boards, respectively.  If you only have one or two
    boards, then you should omit those configuration lines which do
    not apply.

    For example, if you only have one board installed at I/O port
    0x280, then you should add the following to your kernel
    configuration file:

		# Comtrol Rocketport(ISA)
		device	rp0	at isa? port 0x280 tty

    If instead you have two boards, one installed at 0x100 and the
    second installed at 0x180, then you should add the following to
    your kernel configuration file:

		# Comtrol Rocketport
		device	rp0	at isa? port 0x100 tty
		device	rp1	at isa? port 0x180 tty

    For RocketPort(PCI) you only need to say:

		device rp0
		device rp1

    Note: Make sure the PCI devices are specified BEFORE the ISA devices.
	  For example, if you have 2 PCI boards and 1 ISA board the conf
          file would look like this:

	       device rp0
	       device rp1
	       device rp2  at isa? port 0x180 tty

    Note: Make sure that you allow a 68-byte contiguous address block for the
          first board (starting at 0x100h, 0x140h, 0x180h, 0x200h, 0x240h,
          0x280h, 0x300h, 0x340h, or 0x380h). The second, third, or fourth
          boards require a 64-byte contiguous address block, starting at one
          of the ranges mentioned above but not overlapping the first board.
    
    Note: The driver assigns major # 20 to the RocketPort. You should not have
          any devices configured at that major #. Once the driver is registered
          with FreeBSD we will have our own major #.

7.  Edit /sys/i386/conf/files.i386 and add /sys/i386/isa/rp.c to it.

8.  Rebuild your kernel, and install it.  If your
    configuration file is named "LOCAL", then the commands to do this
    are as follows: (see the BSD/OS documentation for more
    information)

		cd /sys/i386/conf
		config LOCAL
		cd /sys/compile/LOCAL
		make
		make install

    Reboot the system to start using your newly built kernel.

9.  In order to create the device files in /dev for your Comtrol
    Rocketport boards, immediately after rebooting, run the shell
    script make_rpdevs.sh:

		/usr/src/comtrol/make_rpdevs.sh

    This will create the necessary devices files in /dev.

Note: It's been reported that make_rpdevs.sh may hang. This is an
easily fixable problem. In the worst case you may have to add the
devices by hand and set their permissions.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

REPORTING BUGS
--------------
Please send any bugs to Amir Farah, <amir@comtrol.com>

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
