Comtrol Rocket Port Multiport Serial Cards 550 Manuel utilisateur

QUICK START Linux DRIVER and
HARDWARE REFERENCE CARD
RocketPort 550 4 Port Quad
RocketPort 550 4 Port RJ45
RocketPort 550 8 Port Octa
RocketPort 550 8 Port RJ11
RocketPort 550 8 Port (with dedicated interface box)
RocketPort 550 16 Port (with dedicated interface box)
This Guide.
Comtrol Europe Ltd Document Number COM226Linux
Release Rev H, 29th January 2003

2
1. Installing Your RocketPort 550 hardware..............................3
2. Installing the RocketPort 550 Linux Device Driver
software ............................................................................................4
3. Viewing the RocketPort 550 Port Installation.......................9
4. Driver Removal..........................................................................10
5. Application Programming.......................................................10
6. Port Names ...............................................................................11
7. RocketPort 550 Linux driver (re)compilation ......................13
8. RocketPort 550 Cable Types...................................................14
9. Technical Support.....................................................................18
10. Specifications ...........................................................................19
11. Copyright and Trademarks................................................... 20

3
The Linux RocketPort 550 Drivers allow application space programs to perform
asynchronous communications using boards from the Comtrol RocketPort 550 range.
1. Installing Your RocketPort 550 hardware
Take care when you handle the RocketPort 550 PCI cards, like any electronic device,
they are sensitive to static electricity. Use normal static precautions such as wearing an
earth ground strap.
Power down the host PC and disconnect its mains input.
Follow the host PC instructions for access to the PC and the installation of additional
cards.
You may install up to 4 RocketPort 550 PCI cards in one PC.
Ensure the front panel retaining screws are fitted.
Follow the host PC instructions for re assembly of the host PC its cabling and re-fitting
of safety covers.
Re-connect the host PC mains input, power up the PC and login as root.

4
2. Installing the RocketPort 550 Linux Device Driver
software
NOTE
The Comtrol Linux driver release 1.03 was developed using the RED HAT 8.0
distribution with Kernel revision 2.4.18-14.
The driver source is provided should developers wish or need to modify the driver for
use with alternative Linux distributions and/or Kernels. For use with other 2.4.x kernels,
a simple re-compilation (on the target system) is all that may be necessary and a
‘Makefile’ is provided to automate this process. Before (re)compilation, the kernel
source must be installed.
For test purposes, the driver source was (re)compiled under Red Hat 7.3 kernel 2.4.18-3.
The driver module was installed and functioned correctly.
This driver source will not (re)compile under the obsolete 2.2.x kernels. If it is wished to
use the RocketPort 550 with these earlier kernels, then request a copy of the RocketPort
550 Linux driver release 1.00.
The installation media (i.e. what you are installing from)may be a 1.44Mb floppy diskette or a
CD-ROM. Alternatively, you may have downloaded the driver from
http://www.comtrol.com
There may be minor differences in the installation procedure depending on the
installation media.
If you have downloaded the driver from http://www.comtrol.com, then it is suggested
that you copy the ‘tar’ file to an MS-DOS formatted floppy diskette and follow the
floppy disk based installation procedure
Following download, you may need to unzip the downloaded file in order to obtain the tar file. The tar
file name will be of the format relXXX.tar where XXX is the release number. E.g. XXX = 103 =
release 1.03
The following assumes that you have booted Linux and logged in as root.
Step 1
Extract the files from the installation media. First insert the floppy diskette or
CD into the relevant drive and mount the media so that the file can be accessed.
DISKETTE
[root@localhost root]# mount -t msdos /dev/fd0 /mnt/floppy
CD ROM
[root@localhost root]# mount /dev/cdrom /mnt/cdrom

5
Step 2.
Next, create a temporary directory into which the files can be extracted:
[root@localhost root]# cd /tmp
[root@localhost tmp]# mkdir inst_Comtrol
[root@localhost tmp]# cd inst_Comtrol
Step 3.
Then, extract the driver components from the tar file on the diskette or CD ROM to the
temporary directory: Note that the name of the tar file may be different.
DISKETTE
[root@localhost inst_Comtrol]# tar xvf /mnt/floppy/rel103.tar
CD ROM
[root@localhost inst_comtrol]# tar xvf /mnt/cdrom/rel103.tar
Note:The path to rel103.tar may differ on the CD ROM.
Step 4
Run the installation script
IMPORTANT
If your Linux kernel is not version 2.4.18-14 or your kernel configuration
differs from our development system then you will need to (re)compile the
RocketPort 550 driver source on your system, otherwise the Install script will
display error messages and the driver will not be installed. If this is the case
then follow the procedure in section 7 , ( Re)-compiling the RocketPort 550
Linux driver, before proceeding with installation step 4.

6
Run the install script from the directory into which the files were extracted:
[root@localhost inst_Comtrol]# ./install
===========================================================
Comtrol Europe RocketPort 550 Drivers installation
Version 1.03
January 2003
===========================================================
Press Enter to begin installation
Press enter to begin installation.
A screen of text is displayed. It contains information about the names you can
select for the RocketPort 550 ports and details how the driver assigns numbers to
individual ports.
Your system will connect to the RockPort 550 Ports through entries
in the /dev/ directory. You can choose any prefix for the names,
as long as it is different from names given to other devices.
For example, if you select a prefix of 'ttyA', then the RocketPort 550
Ports will be called /dev/ttyA00, /dev/ttyA01 and so on up to
/dev/ttyA63
You can install up to 4 RocketPort 550 cards in a system. The device names
for the first card starts with ttyA00, the second starts ttyA16, the third
ttyA32, and the fourth ttyA48. If the installed cards have less than
16 ports, then there will be gaps in the numbering corresponding to the
missing ports.

7
There are two names for each port, one is for communication with a
modem, the other is for communication with a terminal or computer
Usually the modem connection has a Device name like 'cuaa..' and
the terminal/computer connection has a name such as 'ttyA..'
See section 6 for more information about port naming.
You are prompted to enter the Special Device name prefix for terminal ports:
Please enter the Special Device name for terminals [....]

8
… and for modem ports:
Please enter the Special Device name for modems [....]
The installation script now copies the driver file into the module directory and
adds a command to initialisation scripts so that the driver is loaded whenever
Linux is rebooted.
Copying files ......Done
Adding insmod command to /etc/rc... directories...Done
Next, you are asked if you want to load the drivers now. If you have already fitted
the RocketPort 550 cards into the system (as we suggest you do), then you should
choose ‘Y’ here.
If you have not installed the cards yet, or have other administration tasks that will
need a reboot, you can say ‘N’ for no.
Do you want to install the RocketPort module now. If you don't do it
now, then you will have to reboot before the serial ports can be
used.
Please enter [Y]es or [N]o [.]
If you say Yes, and you’re running on the System Console (not in X-Windows),
then you’ll see messages from the RocketPort 550 driver confirming that it has
successfully loaded and listing any boards it detects
Rckt550: Direct MAJOR is 253, callout is 252.

9
Comtrol Europe RocketPort 550 Linux Drivers installation Complete
Your RocketPort 550 Linux Drivers are now installed
Remove the driver distribution media from the drive
3. Viewing the RocketPort 550 Port Installation
You can check that devices have been created in the /dev directory.
[root@localhost inst_Comtrol]# ls -l /dev/ttyA*
crwxrwxrwx 1 root root 254, 0 Jan 23 20:36 /dev/ttyA00
crwxrwxrwx 1 root root 254, 1 Jan 23 20:36 /dev/ttyA01
crwxrwxrwx 1 root root 254, 2 Jan 23 20:36 /dev/ttyA02
crwxrwxrwx 1 root root 254, 3 Jan 23 20:36 /dev/ttyA03
[root@localhost inst_Comtrol]# ls -l /dev/cuaa*
crwxrwxrwx 1 root root 254, 0 Jan 23 20:36 /dev/cuaa 00
crwxrwxrwx 1 root root 254, 1 Jan 23 20:36 /dev/cuaa 01
crwxrwxrwx 1 root root 254, 2 Jan 23 20:36 /dev/cuaa 02
crwxrwxrwx 1 root root 254, 3 Jan 23 20:36 /dev/cuaa 03
[root@localhost inst_Comtrol]#
.Changing Configurations
It is not necessary to re-install the driver if you change the number of
RocketPort 555 cards in the system. Each time the system is restarted, the
boards are re-scanned and the Special Device files re-created.

10
4. Driver Removal
There is generally no need to remove the device driver from the system.
If a card is no longer required, simply shutdown and power off the computer,
remove the card and reboot the system. If there are no longer any installed cards
then the driver will detect this condition unload itself. However, the driver files will
remain installed on the system’s hard disk.
At a later time the RocketPort 550 card(s) can be re-installed and the computer
restarted. The drivers will detect and operate the card(s).
5. Application Programming
The Application Programming Interface pertaining to the RocketPort 550 Linux
device driver is described in the Linux documentation for serial (tty) ports.
Ce manuel convient aux modèles suivants
1
Table des matières
Manuels Matériel informatique populaires d'autres marques

EMC2
EMC2 VNX Series Manuel du propriétaire

Panasonic
Panasonic DV0PM20105 Manuel utilisateur

Mitsubishi Electric
Mitsubishi Electric Q81BD-J61BT11 Manuel utilisateur

Gigabyte
Gigabyte B660M DS3H AX DDR4 Manuel utilisateur

Raidon
Raidon iT2300 Manuel utilisateur

National Instruments
National Instruments PXI-8186 Manuel utilisateur











