RocketPort® and RocketModem® Driver Installation for Linux 1

RocketPort

and RocketModem

Driver Installation for Linux

You can use this document to install and configure the RocketPort/RocketModem

Linux device driver.

Note: The RocketModem looks to Linux like a RocketPort card with modems

attached; you can refer to the RocketModem AT command set on the Comtrol

CD or ftp/web sites.

Requirements

Review the requirements for running this driver.

Operating System The Linux operating system is distributed from several sources. While all

distributions share general file structure and functionality, there are differences

that can impede the installation of device drivers. The instructions in this

document outline a generic installation procedure. You may need to adjust for

differences in a particular distribution using the Linux system documentation as a

reference.

This document assumes that you have already installed the Linux operating

system (

Kernel Version 2.2 or 2.4 only) and that you have a basic understanding of

Linux

OS operation.

Building the Driver In order to build the driver, the kernel sources are required. These are located by

the driver using a symlink, which points to the base of the kernel source tree. By

convention, this symlink is /lib/modul es/<kernel version>/bui ld, which is created by

all major Linux distribution, RPM installs or by running make dep on the source.

This symlink must point to the same kernel source version as is running on the

machine.

If a build symlink is not found, the driver will search for a symlink named

/usr/src/linux pointing to the source tree. Users who have no build symlink can

create this in order to build the driver.

For example, if the kernel version (uname -r) is 2.4.20, and the source is installed

in /usr/src/linux-2.4.20, the alternative symlink can be created by:

cd /usr/src

ln -s /usr/src/linux-2.4.20 linux

RocketPort® and RocketModem® Driver Installation for Linux 2

Installation Procedure

Use this procedure to install the driver.

1. If you have not done so already, install the hardware using the Hardware

Installation documentation.

Note: Optionally, you can go to http://support.comtrol.com/download.asp

you need to locate the latest device driver or hardware installation

document for your product.

2. If necessary, download the current device driver, copy and extract the files to

the /usr/src directory on the Linux system.

Note: If you need assistance unpackaging the driver, see

ftp://ftp.comtrol.com/extract.htm

For example:

Change to the /usr/src directory and use the untar command.

cd /usr/src

tar xzvf filename.tgz

A subdirectory of /usr/src now exists called comtrol. This contains the

RocketPort/RocketModem driver and associated files.

3. Change to the /user/src/comtrol directory. For example:

cd comtrol

4. Compile the driver.

make clean

make

5. Install the RocketPort/RocketModem driver as root:

make install

6. Configure the driver.

PCI cards require no driver configuration, they are automatically detected and

configured.

If you are using a RocketPort or RocketModem with an ISA bus or the PC104

RocketPort board, you will need to set up the /etc/rocketport.conf file.

/usr/src/comtrol contains an example rocketport.conf file. Copy it to the

/etc directory and edit it according to the comments contained in that file.

7. Optionally, edit your /etc/rc.d/rc.S file (or other appropriate boot-up script) so

that the rc.rocket script runs automatically each time your system boots. This

is done for you automatically if you are using a system with System V init files,

such as is used in the RedHat or Debian releases.

This file may have a different file name, depending upon the Linux

distribution type.

Note: The rc.rocket script requires that setrocket be installed in the /bin

directory. The setrocket program creates the ttyRx devices (where x is a

number designating the port). The setrocket program is structured much

like the familiar setserial program, and performs a similar function.

8. Either reboot to load the driver into the currently running system, or

manually load the driver running the rc.rocket script with the start argument.

For example:

./rc.rocket start

9. Configure applications and/or getty scripts as necessary for your application.

Note: For information about port names, see Port Naming

on Page 3.

10. If applicable, connect the interface box to the controller board (if applicable).