CardBus 32-bit 10/100 Fast Ethernet PC Card
                      Installation Guide(Rev:1.01)
                          Date: 2001/09/05 
CONTENTS
 1. Introduction
 2. Installing PCMCIA Card Services package
    2.1 Configuring LAN cards
 3. Troubleshooting
 4. Contacts
 5. Copyright

1. Introduction
   This document briefly describes how to use the PCMCIA/CardBus LAN cards 
   on a Linux operating system. Our PCMCIA/CardBus LAN cards have been 
   supported by Linux since kernel 2.2.14. If your kernel version is older 
   than this version or does not support our PCMCIA/CardBus LAN cards, please
   follow the procedures below to make use of our PCMCIA/CardBus LAN cards. 
   Firstly, you need to install a standalone PCMCIA Card Services package 
   which includes the network drivers, responds to card insertion and removal 
   events, loading and unloading drivers on demand. To use the drivers 
   provided by standalone PCMCIA Card Services package, configure the kernel 
   with CONFIG_PCMCIA ("CardBus support") Disabled, then re-compile the kernel
   with the new configurations. If you don't know how to compile a kernel, 
   please refer to the illustration of troubleshooting. Now, let follow step 
   2 to install the latest PCMCIA Card Services package.
   
   Chapter two discusses the installation of the PCMCIA Card Services package 
   as well as the configuration of LAN cards.

2. Installing the PCMCIA Card Services package

   PRECAUTIONS:Card Services package for Linux is written by David Hinds 
   <dhinds@hyper.stanford.edu>. It can be applied on most parts of
   Linux distributions, like RedHat, Slackware, Debian GNU/Linux
   S.u.S.E. Linux and TurboLinux. 

   Before installing the Card Services package, you need to upgrade the kernel
   to 2.2.14 or later.
   
   The PCMCIA Card Services package for our PCMCIA/CardBus LAN cards is 
   available at <http://download.sourceforge.net/pcmcia-cs/pcmcia-cs-3.1.xx.tar.gz>. 
   PS:xx is the latest version of the package
    
   To install the PCMCIA Card Services package, you need to install a full 
   kernel source and perform the following shell commands and suppose that
   the kernel configuration has CONFIG_PCMCIA option disabled:

                
        1. Download the "pcmcia-cs-3.1.xx.tar.gz" into the
           "/usr/src" directory.
           PS: xx is the latest version of the package
        
        2. Run the following commands:

           #cd /usr/src  
           #tar zxvf pcmcia-cs-3.1.xx.tar.gz                 
           #cd pcmcia-cs-3.1.xx
           #./Configure or make config
           #make all
           #make install
  
    Generally, to run "./Configure", you do not need to change the default
    selections. But if you want to use CardBus PC Card, enabled the (CardBus)
    option.
  
2.1 Configuring LAN cards
    For LAN card users, you need to edit the file 
    "/etc/pcmcia/network.opts" to assign IP address, netmask, gateway IP,
    nameservers,broadcast address, and etc.  
   
    The file will display as follows when it's being edited:

        #File: /etc/pcmcia/network.opts
        #
        #
        #
        #Host's IP address, netmask, network address, broadcast address
        IPADDR="203.66.99.137"
        NETMASK="255.255.255.128"
        NETWORK="203.66.99.0"
        BROADCAST="203.66.99.255"
        #Gateway address for static routing
        GATEWAY="203.66.99.254"
        #Things to add to /etc/resolv.conf for this interface
        DOMAIN="your.domain"
        SEARCH=""
        DNS_1="168.95.1.1"
        DNS_2="168.95.192.1"
        DNS_3="203.66.99.251"
        #
        # 
 
   Be sure to restart the Linux machine after installing the Card Services 
   package.
  
   Now the standalone PCMCIA Card Services package should be installed correctly. 
   If not, read the "PCMCIA-HOWTO" or "README" for the details in the root 
   directory of the Card Services source code or get it from any Linux's
   Documentation Web sites to resolve installation and configuraton problems.

3. Troubleshooting
   Q: Why couldn't I compile the latest standalone PCMCIA Card Services package on RedHat7.1?

   A: For whatever reasons, RedHat7.1 changes kernel's default configuration
      settings. To solve the problem, you must re-compile the kernel and
      disable the CONFIG_PCMCIA option. About the proper procedures,
      please refer to the following:

   #cd /usr/src/linux-2.x.x.x       
   (x.x.x.x->your Linux kernel version)    
   #make config
   Please disable the CONFIG_PCMCIA option, and the other options can 
   use the default setting.
   #make dep
   #make clean
   #make bzImage
   #make modules
   #make modules_install
   #cp /usr/src/linux/System.map /boot/System.map-2.x.x.x
   #cp /usr/src/linux/arch/i386/boot/bzImage /boot/bzImage-2.x.x.x
   #cd /boot
   #rm System.map
   #ln -s System.map-2.x.x.x System.map
   #lilo -v -v -v
   #init -6
   The system will restart. After Linux finished rebooting, please follow 
   the step 2 to install the standalone PCMCIA Card Services package.

   PS. This problem does not only happen on RedHat7.1, but also the Linux distributions
       which build-in the 2.4 Kernel. 


4. Contacts
   You can send e-mail to the authors at <tech@hamletcom.com> for
   questions, feedback and document fixes.