RocketPort
1 of 8
RocketPort® Series
Device Driver for the SCO UnixWare 2.1.x Operating System
Software Installation Card
Before You Begin
Before you install the RocketPort device driver for
UnixWare 2.1.x, you must:
• Install the RocketPort card or cards using the
Hardware Installation Card that came with your card
or download it from the web/ftp sites.
• Remove any older RocketPort device driver that may be
on your system.
• Obtain and extract the current driver files.
Removing the Existing Driver
Follow these steps to remove the existing RocketPort
driver:
1. Log in as the system administrator (root) and invoke
the pkgrm utility. Use this syntax:
pkgrm rckt
2. If you have other drivers to remove at this time, do so.
3. Shut down and reboot the system so that your changes
take effect.
shutdown -y -i6 -g0
Extracting the Driver Files
This driver is released in a .z file. The package is released
with the following file name format:
180xxxxY.tar.Z
where:
180xxxx is the Comtrol file name.
Y is the revision letter.
tar.Z means that the file has been compressed.
1. Insert the diskette that contains the UnixWare 2.1.x
file you downloaded.
2. Copy the 180xxxxY.tar.Z file from the floppy to the
/var/spool/pkg directory. For example:
doscp a:180xxxxX.Z /var/spool/pkg/180xxxxX.Z
3. Return to the command prompt as root, go to the /var/
spool/pkg directory, and type the following commands
to create a directory structure named rckt.
uncompress 180xxxxY.Z
tar xvf 180xxxxY
4. Go to Installing the Device Driver to install the driver.
Installing the Device Driver
After installing the RocketPort card and extracting the
driver, follow these steps to install the RocketPort driver.
1. Boot the system, login as the system administrator
(root), and invoke the pkgadd utility.
pkgadd rckt
2. Press Enter to select the ALL option.
3. Select the number and type of cards you are installing
by answering the questions presented during the
install. See the Hardware Installation Card for I/O
DIP switch settings for ISA series cards.
4. Shutdown the system and turn the computer off:
shutdown -y -i6 -g0
5. Configure the RocketPort cards using the information
in the following discussions.
Loading the Device Driver
After you install the driver and hardware, you must load
the driver before configuring ports.
To load the driver manually, use either modadmin or the lod
script. For more information on modadmin, see the
modadmin man page.
To use the lod script, enter this command:
/comtrol/rckt/lod
If the driver is loaded successfully, the following message
displays:
UX: modadmin: INFO: module rckt loaded, ID=##
If the driver does not load successfully, an error message
displays.
Unloading the Device Driver
To unload the driver, use either modadmin or the ulod
script. The ulod script syntax is:
/comtrol/rckt/ulod
If the driver is unloaded successfully, the following message
displays:
UX: modadmin: INFO: module ## unloaded
® Series Device Driver for the SCO UnixWare 2.1.x Operating System Software Installation Card
RocketPort
Device Names
Board 1
Board 2
Board 3
Board 4
This driver provides three device types:
• Non-modem Control
Enabling direct device names allows communications
with a non-modem serial device over a simple 3-wire
connection, consisting of the transmit and receive data
lines and the signal ground.
• Modem Control
The modem control device names require modem
control to function properly. Specifically, the carrier
detect signal must be present before the serial port
becomes active.
• Transparent Print
This is an output-only device that allows you to access
the auxiliary port on a terminal.
Note: The driver creates 32 ports (three devices per port) in
the /dev/term directory for each board installed.
Device names are assigned as shown in the table below:
Device Names
card will always be Board 1 and the ISA card will
always be Board 2.
For more information on ISA I/O addressing, see
your RocketPort Hardware Installation Card.
You can use the shell scripts in the following table to
establish port services. The shell scripts make installation
of ttymon login services easier. See the man pages for
information about using port monitors, and the sacadm and
pmadm commands.
After you set up the login services, you may need to do the
following:
• Optionally, configure Transparent Print.
• Optionally, use Baud Rate Mapping to access baud
rates higher than 38,400.
Port Services Shell Scripts
Script Name Description
Adds a ttymon monitor named
addttymon
port_monitor
port_monitor. The system needs only
one port monitor to manage login
service for all serial ports.
Ports
Non-modem
Control
Modem
Control
Transparent
Print
0 - 7 r0a - r0h r0A - r0H tpr0a - tpr0h
8 - 15 r1a - r1h r1A - r1H tpr1a - tpr1h
16 - 23 r2a - r2h r2A - r2H tpr2a - tpr2h
24 - 31 r3a - r3h r3A - r3H tpr3a - tpr3h
32 - 39 r4a - r4h r4A - r4H tpr4a - tpr4h
40 - 47 r5a - r5h r5A - r5H tpr5a - tpr5h
48 - 55 r6a - r6h r6A - r6H tpr6a - tpr6h
56 - 63 r7a - r7h r7A - r7H tpr7a - tpr7h
64 - 71 r8a - r8h r8A - r8H tpr8a - tpr8h
72 - 79 r9a - r9h r9A - r9H tpr9a - tpr9h
80 - 87 raa - rah raA - raH tpraa - tprah
88 - 95 rba - rbh rbA - rbH tprba - tprbh
96 - 103 rca - rch rcA - rcH tprca - tprch
104 -
111
112 -
119
120 -
127
rda - rdh rdA - rdH tprda - tprdh
rea - reh reA - reH tprea - tpreh
rfa - rfh rfA - rfH tprfa - tprfh
Note: With RocketPort/ISA cards, the board numbering
sequence is determined by card I/O addresses. With
RocketPort/PCI cards, the numbering sequence is
determined by the PCI slot number. When mixing
ISA- and PCI-bus RocketPort cards, the PCI cards
always come before the ISA cards. For example, if
you have one PCI and one ISA RocketPort, the PCI
addttysrv
port_monitor
service_tag
ttydefs_entry
Adds login service to port_monitor.
The service_tag is the same as the
device name in /dev/term. Line settings
are obtained from the ttydefs_entry in
the /etc/ttydefs file.
This script is similar to addttysrv,
except that this script configures the
addmdmsrv
port_monitor
service_tag
ttydefs_entry
login service as a dial-in/dial-out
modem. The device names table shows
the modem control device names
assigned to each serial port on the
RocketPort controller. You must use
uppercase device names that may be
found in /dev/term.
rmsrv
port_monitor
service_tag
This script removes the login service
service_tag from port_monitor.
The following example shows how to create a port monitor,
enable direct connect login services for Port r0a,and
configure the port for dialup login with a baud rate of
38400.
/comtrol/rckt/addttymon port_monitor
/comtrol/rckt/addttysrv port_monitor r0a 38400
/comtrol/rckt/addmdmsrv port_monitor r0B 38400
Note: 38400 is one of many configurations that can be
selected from /etc/ttydefs
® Series Device Driver for the SCO UnixWare 2.1.x Operating System Software Installation Card 2 of 8
RocketPort
Enabling Ports
To enable a port, enter this command:
pmadm -e -p<port_monitor> -s<service_tag>
For more information, see the man page for pmadm.
Disabling Ports
To disable a port, enter this command:
pmadm -d -p<port_monitor> -s<service_tag>
For more information, see the man page for pmadm.
Viewing Settings
To view the current tty settings for a port, enter this
command:
stty -a < /dev/term/portname
For more information see the man page for stty.
Baud Rate Mapping
UUCP and CU do not support baud rates above 38.4 Kbps.
Therefore, to take full advantage of the RocketPort board’s
potential speed (such as 57.6K, 76.8K, 115.2K, or 230.4K),
you must use one of the following methods to remap baud
rates on one or more ports:
• setbaud
This program enables you to remap baud rates for one
or more ports, for the current session only.
Note: 460K is not supported.
• baud.init
This command enables you to remap the baud rates
automatically each time the system is rebooted.
Setbaud
Follow these steps to remap baud rates for the current
session.
Note: Baud 50 through 134 are not included in the
/etc/ttydefs file. Setbaud can be used by using the -u
option to set each over 300 or by adding 50, 75, 110,
and 134 to the /etc/ttydefs file.
1. Disable the ports for which you want to remap baud
rates.
2. Enter this command:
/comtrol/rckt/setbaud -h /dev/term/portname
The rates are remapped as shown in the following table:
Baud Rate Mapping
System Rate Setbaud Rate
50 57600
75 76800
110 115200
134 230400
Note: The /etc/ttydefs file does not include the 50 through
134 baud rates. You need to manually add these
baud rates to the file.
3. Repeat Step 2 for each port for which you are
remapping rates.
4. Use the normal tty administrative procedure to set the
port to the system rate. The setbaud rate is used
instead.
To map a port to a rate not in the setbaud table, enter this
command:
/comtrol/rckt/setbaud -u /dev/term/portname oldrate
newrate
Where oldrate is the system rate and newrate is the
desired new rate.
To reset a port to standard system rates, enter this
command:
/comtrol/rckt/setbaud -n /dev/term/portname
Baud.init
Follow these steps to permanently remap baud rates:
1. Edit the /comtrol/rckt/baud.cfg file to list the ports for
which you are remapping baud rates. To use the
remapped rates listed in the setbaud table, simply list
the devices names. For example:
/dev/term/r0a
/dev/term/r0A
/dev/term/r0b
/dev/term/r0B
To create a custom mapping scheme, enter the device
name, the old rate, and the new rate the old rate is
mapped to. For example:
/dev/term/r0a 9600 230400
/dev/term/r0A 9600 230400
/dev/term/r0b 9600 230400
/dev/term/r0B 9600 230400
® Series Device Driver for the SCO UnixWare 2.1.x Operating System Software Installation Card 3 of 8
Loading...