<==========================================================================>
| Ositech Four of Diamonds Trumpcard |
| Ositech Trumpcard Ethernet LLI Driver Installation Instructions |
| Version 1.11 |
| Copyright (c) 1994-1996, Ositech Communications Inc. |
<==========================================================================>
This document supplements the "Ositech Four of Diamonds Ethernet User's
Guide" and the accompanying software. Please read this document in its
entirety before installing this software. This document describes the
installation instructions for the Four of Diamonds Ethernet LLI driver for
SCO Unix System V Release 3.2v4.2 and SCO Unix System V Release 3.2v5.0.0.
This document contains information specific to this "Four of Diamonds
Trumpcard SCO Unix and UnixWare Drivers Diskette". More general, up-to-date
information on Version 1.10 of the Ositech Four of Diamonds Trumpcard
software, including a directory map of all text/readme files on all
diskettes, can be found in the README.TXT file located on the "Four of
Diamonds Trumpcard Installation for DOS / Win 3.x / 95 / NT, Diagnostics and
Utilities Diskette".
The Trumpcard LLI Driver is a network driver for the Ositech Four of
Diamonds Trumpcard. With this driver installed, the Networking functions
available on the Four of Diamonds can be used.
The Trumpcard LLI driver requires that the Four of Diamonds PCMCIA adapter be
inserted prior to the driver being loaded. If no Trumpcard is found the
driver will not be loaded and networking functions will NOT be available.
When the driver has successfully loaded, if the Trumpcard is now removed from
the PCMCIA slot unpredictable results will occur. The Trumpcard LLI Driver
DOES NOT support hot swapping.
Contents
========
1. General Installation Instructions
1.1 Requirements
1.2 Installation Steps
2. Installation Instructions Using the INSTALL Shell Script
2.1 Preparing for Installation by the INSTALL Shell Script
2.2 Using the INSTALL Shell Script
3. Installation Instructions Using Manual Commands
3.1 Creating the Ositech LLI Driver Disk
3.2 Installing the Ositech LLI Driver Package
4. LAN Installation & Configuration
4.1 Auto Media Detect
5. Error Messages
6. Known Problems
7. Technical Support
==========================================================================
1. General Installation Instructions
These installation instructions assume that you are familiar with the
installation of software packages on SCO Unix.
1.1 Requirements
In order to successfully complete the installation process, the following are
required:
> SCO OpenServer 3.0.0. It is NOT recommended that you attempt to
install the LLI driver under SCO OpenServer 5.0.0.
> One blank 3.5 inch high density (1.44MB) diskette labeled "Ositech
Trumpcard Four of Diamonds LLI Driver Disk".
> IRQs that you wish to assign to the LAN function. You can use
"hwconfig" to see what devices are currently configured on your SCO UNIX
system.
> A 4k memory window in the range of 0xc0000 and 0xf0000 to which you
can assign to the driver. The default is location is 0xc8000.
> The "netconfig" utility to configure the network software.
> 2MB of free disk space in the filesystem containing the /tmp
directory for the temporary files which are created during the install
process.
> If using an ISA legacy PCMCIA interface card in a machine with a PCI Bus
you must use the BIOS configuration to open a ISA compatibility memory
window which encompasses the 4k memory window (described above).
> The SCO TCP/IP and LLI Driver kits must be installed for the driver to
be installed correctly.
1.2 Installation Steps
The installation process consists of four basic steps:
1) Creating the Ositech LLI Driver Disk from the compressed disk image
(osi_sco.dd) extracted from the osi_sco.tar archive.
2) Installing the driver from the newly created Ositech LLI Driver
Disk using the SCO UNIX "custom" utility.
3) Installing and configuring a serial port driver using mkdev serial.
4) Binding the network software to the Trumpcard driver using "netconfig".
==========================================================================
2. Installation Instructions Using the INSTALL Shell Script
2.1 Preparing for Installation by the INSTALL Shell Script
To install the Trumpcard LLI driver, you need to create an Ositech
LLI Driver Disk using the INSTALL shell script from the DOS distribution
diskette labeled "Trumpcard SCO Unix and UnixWare Drivers Diskette".
The first step is to copy the INSTALL shell script to the UNIX /tmp directory
from the distribution diskette \UNIX\SCO directory. If you do not have the
DOS filesystem support installed on your UNIX system, then you must also copy
the osi_sco.tar file to the /tmp directory. If you wish to install the DOS
filesystem support, logon to your machine as "root", execute the UNIX command
"mkdev dos", and reboot your machine.
2.2 Using the INSTALL Shell Script
NOTE: You MUST run this INSTALL shell script as "root" in single-user mode
because the installation process will require you to relink the kernel.
To create the Ositech Trumpcard LLI Driver install diskette, and to
install the driver, you need only execute the INSTALL shell script that you
have copied to the /tmp directory. A typical install would be as follows:
$ su
enter the root password at the Password: prompt
If you are not already in the System Maintenance mode, use the
following command to reboot the machine:
# /etc/shutdown -i1
INIT: SINGLE USER MODE
Type CONTROL-d to proceed with normal setup,
(or give root password for system maintenance):
enter the root password to activate the System Maintenance
mode
# cd /tmp
# sh install
Then simply follow the instructions provided by the installation script to
complete the installation of the driver. Any steps in the INSTALL shell
script which you skip must be completed manually later.
==========================================================================
3. Installation Instructions Using Manual Commands
3.1 Creating the Ositech LLI Driver Disk
The osi_sco.dd file contains a disk image of the Ositech Trumpcard LLI
Driver SCO distribution diskette. This diskette is used to install the LLI
driver software. The LLI driver will enable the various members of the
Ositech Trumpcard family that have the Ethernet function on Intel 365 and
Databook compatible PCMCIA controllers. The current driver enables the
Ethernet functions of the Four of Diamonds Trumpcard.
The file, "osi_sco.tar" must be unpacked before any further installation can
occur. The files included in this file are:
Filename Size Date Time Version
osi_sco.txt (this file)
osi_sco.dd.Z 155641 05-Jan-96 10:51 1.0.2c
Format a 3.5-inch 1.44 Mb. diskette using the following commands:
$ su
provide the root password at the Password: prompt
place a 3.5-inch high density disk in the floppy drive
# format -v /dev/rfd0135ds18 ( /dev/rfd1135ds18 if it's
the b: drive )
Now uncompress the file using:
# uncompress osi_sco.dd.Z
Now "dd" the image onto the disk using:
# dd if=/tmp/osi_sco.dd of=/dev/rfd0135ds18
note the path to the dd image may be different
use /dev/rfd1135ds18 if it's the b: drive
3.2 Installing the Ositech LLI Driver Package
After creating the installation diskette, you can then use the SCO "custom"
utility to install the Ositech LLI driver package from the diskette. After
running "custom", select Install and choose the product listed as "A New
Product", assuming that the Ositech LLI Driver product is not currently
installed on your machine. Then select the "Entire Package" option. The
"custom" program will then prompt you to make sure that the diskette is
installed in the drive.
Now you must use the "netconfig" utility to configure your network stacks and
provide the hardware configuration for the LAN. See the "4. LAN
Installation & Configuration" section of this document.
==========================================================================
4. LAN Installation & Configuration
To install the network driver you must use the "netconfig" utility to create
a binding to the driver. You must start with the "Add a chain" option.
1. Execute "netconfig" to configure SCO networking software and netconfig
will display output similar to the following:
Currently configured chains:
1. sco_tcp->lo0
sco_tcp SCO TCP/IP for UNIX
lo0 SCO loopback driver
Available options:
1. Add a chain
2. Remove a chain
3. Reconfigure an element in a chain
q. Quit
Select option: 1
The display lists the bindings or chains that are currently configured.
A chain is an association between a protocol stack and a LLI driver.
2. Select the operation to perform. To configure your system to use the
Ositech Trumpcard LLI driver, you must add a new chain.
Select option 1 to add the new chain and netconfig will display output
similar to the following menu:
Num Name Description
1. sco_ipx SCO IPX/SPX for UNIX
2. sco_tcp SCO TCP/IP for UNIX
Select top level of chain to Add or q to quit: 2
The menu lists the protocol stacks that can be used with an LLI driver.
3. Select the protocol stack for which the new chain should be configured.
Select option 2 to add a new chain for SCO TCP/IP and netconfig will
display the following:
Add chain : sco_tcp->
Num Name Description
1. tok0 IBM Token Ring Network Adapter driver, board 0
2. osi0 Ositech Trumpcard Ethernet driver, card 0
3. wdn0 Western Digital 8003/8013 Series driver, board 0
Select next level of chain to Add or q quit: 2
The display lists the network cards for which drivers are installed and
that can therefore be configured with SCO TCP/IP. This list will vary
depending on the hardware configuration and the LLI drivers that are
installed on your system.
4. Select the Ositech Trumpcard Ethernet driver to associate this driver with
TCP/IP. The rest of the installation process will consist of configuring
the Trumpcard Ethernet driver and the TCP/IP protocol. Refer to "SCO
Installation and Upgrade Guide", Appendix E, "Configuring your networking
software". Also chapters 1 and 2 of "Administering Networking Services"
in the "SCO Systems Administrator's Guide".
Add chain sco_tcp->osi0 (y/n): y
5. Enter <y> and the Ositech Trumpcard driver will now be configured. First
the Ethernet portion of the Trumpcard will be configured. You need to
assign the LAN a IRQ and a I/O address.
Adding: sco_tcp->osi0
Configuring Ositech Trumpcard card 0
Installing the osi driver into the link kit
Configuring Ositech Trumpcard LAN ...
Enter IRQ (2 3 4 5 7 10 11 12 15) [5] or 'q' to quit: 5
Enter I/O base address (300..400) [300] or 'q' to quit: 300
Enter RAM base address (c0000..f0000) [c8000] or 'q' to quit: c8000
Configuring Ositech Trumpcard media ...
Enter <0> for 10BaseT (twisted pair) media.
<1> for 10Base2 (coaxial) media.
<2> for Auto Detection of media.
Enter media type (0, 1 or 2) (0 1 2) [2] or 'q' to quit: 2
4.1 Auto Media Detect
If auto media detect is selected as the media type and no cable is detected
when the driver is loading, then the network driver will not load, and the
LAN function on the Trumpcard will be powered down. If 10BaseT or 10Base2
media are selected, then the cable detect check will not be performed.
==========================================================================
5. Error Messages
install: cannot find the source archive file on diskette
The osi_sco.tar file is not present on the DOS diskette.
Make sure that the correct diskette is in the drive.
install: cannot find the archive file /tmp/osi_sco.tar
The osi_sco.tar file is not present in the UNIX /tmp directory.
You should copy the file from the DOS diskette manually, or if you
have DOS filesystem support installed, allow the install script to
copy the file.
install: cannot find the compressed disk image /tmp/osi_sco.dd.Z
The archive file might be corrupt, or there is not enough disk space
to hold the file.
otceth: LAN IRQx is not supported in a Databook configuration
The IRQ that you configured the Databook controller for is
not available when using a Databook PCMCIA controller. The
LAN function must be assigned IRQ11.
otceth: Unable to detect network cable. Powering down LAN chip.
The network cable was not detected. As a result, the LAN chip
was powered down to save power.
otceth: verification of node address checksum failed
otceth: memory conflict or CIS has been corrupted
The CIS memory on the Trumpcard has been corrupted, or you
have a memory window conflict. If you are using a ISA PCMCIA
card in a PCI Bus machine, then make sure that you have opened
a ISA memory window (See "Known Problems" section). Use the
DOS diagnostic diskette to verify that the selected memory
range is free and to fix this problem.
otceth: Failed to power up LAN chip
There is most likely an address conflict with the LAN I/O
port range, or the LAN chip is not functioning properly.
Use the MS-DOS diagnostics to verify.
==========================================================================
6. Known Problems
If you are using an ISA PCMCIA controller in machine that has a PCI Bus, then
you will have to open an ISA compatibility memory range which includes the 4k
memory window which you will be using for the Trumpcard enabler.
There are several error messages generated when installing or reinstalling
the drivers under SCO UNIX 5.0.
==========================================================================
7. Technical Support
If you have any problems with your Ositech Trumpcard adapter, please
call our technical support staff toll free in Canada and the United States
at 1-800-563-2365, FAX at 1-519-836-6156, Internet e-mail at
support@ositech.com, CompuServe (GO OSITECH), or mail to the following
address:
Ositech Communications, Inc.
679 Southgate Drive,
Guelph, Ontario N1G 4S2
CANADA
Tel: 1 (519) 836-8063
FAX: 1 (519) 836-6156
BBS: 1 (519) 836-1196
WWW: http://www.ositech.com/
FTP: ftp.ositech.com
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.