     Date: Wed Dec 2 1998, 
     Originally from: Nev Okyay <nev@home-free.com>
     Modified by: Herve Bronnimann <Herve.Bronnimann@sophia.inria.fr>
                  for Debian 2.0


 Installing 3CCFE575BT on Dell Inspiron 7000 with Debian 2.0:

 0.  This document is for people who have some experience with linux.
     Alternatively, Steve Hsieh reports that using the built-in kernel from the
     distribution should work. If you are willing to use the kernel 2.0.34 (or newer),
     then go right ahead to step 2, but don't forget you need the to install
     the source (kernel-source-2.0.34 or newer in section devel of the main distribution)

     Contact the author: Herve.Bronnimann@sophia.inria.fr
     for notes, items, points that are not on the list and you'd like to see.

 1.  The first step is identical to RedHat, but in Debian this means
     you have installed the kernel-source package (kernel-source-2.0.34 in
     section devel of the main distribution) or download the kernel source. 
     
     First, you need to enable the modules support in the kernel.
     There is a lot of info and readme files in the /usr/src/linux
     directory, but the gist of it is this:
     a. Type "make menuconfig" in /usr/src/linux directory.
     b. At the prompt, go to the section "General support" and select
	"Networking support". In the section "Networking options" select
	"TCP/IP" and as many as you would like to have.
     c. Then make the kernel and modules as usual.
     e. Now you can type "make install" to activate your new kernel.
     f. Don't forget to run lilo.  type "lilo", and reboot.

 2.  Get the latest version (pcmcia-cs-3.0.6) of the pcmcia module.
     Check out <http://hyper.stanford.edu/HyperNews/get/pcmcia/home.html>
     and get pcmcia-cs-3.0.6.tar.gz.

 3.  Unpack this package under /usr/src/linux.
     Type "tar xvzf pcmcia-cs-3.0.6.tar.gz"  and read some documents,
     they are good!  If you are impatient tho, continue on...

 4.  Type "cd pcmcia-cs-3.0.6".  Now you go through three steps, config,
     make, and install.

 5.  Type "make config".  Leave all defaults alone, except for two things:
     say "yes" to cardbus support, and say "yes" to experimental
     interrupt support like this-
               Include 32-bit (CardBus) card support (y/n) [y]:
               Experimental interrupt probe code (y/n) [y]:

     Note: Cardbus support is *essential*

 6.  Then type "make all" and "make install".  Type "lilo" again to update
     the symbol table.  Reboot the system by typing "shutdown -r now".

 7.  Now it is time to "futz with" the pcmcia configuration files.  They are
     in /etc/pcmcia.

 8.  The second file is config.opts in the /etc/pcmcia directory.  The first
     uncommented line in this file includes some ports and memory.
     Do not change that line, but add one right below it that says:

        include port 0x200-0x27F, memory 0xA0000000-0xA0FFFFFF.
     
     Leave everything else alone, but note that in this file some irq's
     are excluded from probing.  Later you may have to exclude more
     irq's in this file (such as irq 5 for sound).

 10. Now update your network configuration files.  This may take a
     little while, so my recommendation would be to do this while you try
     some home-brewed beer.  Here is the list of files I know about:
     [they differ a little from RedHat to Debian]
         /etc/pcmcia/network.opts (IP address, network, gateway values go here)
         /etc/hosts
         /etc/resolv.conf

 11. To start pcmcia, type "/etc/init.d/pcmcia start". 

 12. How do you know if it is working?  You should hear two beeps when
     the pcmcia starts.  Detailed info is dumped into the /var/log/messages
     file.  Also type "cardctl status/config/ident".  If the card seems to
     work for a little while and then stops with an error like
     "unknown interrupt" or "IRQ blocked by another device?",
     you have a potential interrupt conflict.
     To fix it, find out which interrupt was assigned to
     the card, and exclude that interrupt in the /etc/pcmcia/config.opts.
     Then stop and start the pcmcia module.

 13. More problems? Read the documentation! It saved me a couple of times:
         zless /usr/doc/HOWTO/PCMCIA-HOWTO.gz
	 zless /usr/doc/HOWTO/NET-3-HOWTO.gz
	 zless /usr/doc/HOWTO/DNS-HOWTO.gz
     And for quickies:
         cardctl config
	 mnore /proc/interrupts
         ifconfig        [should list an interface for eth0]
	 ping/traceroute [will tell you if network is accessible]

     Your card is recognized as a memory card?
     High memory is not available?
         make sure you have step 8 properly (it's related to the memory field
	                                     in /etc/pcmcia.opts)
     Your modem is not recognized on the other slot?
         again, make sure step 8 adds a line (you need to keep the previous ones too)
     
 NOTE: Win98 interrupt assignments have nothing to do with linux interrupt
       assignments. Sooo..., don't try to make them identical.

 -----------------------------------------------------------------------
 Here are how various outputs should look when the card is set up
 properly.

 cardctl status output:
 ======================
 Socket 0:
   3.3V cardbus card present
   Function 0: ready
 Socket 1:
   no card

 cardctl config output:
 ======================
 Socket 0:
   Vcc = 3.3, Vpp1 = 0.0, Vpp2 = 0.0
   Interface type is cardbus
   IRQ 9 is exclusive, level mode, enabled
   Function 0:
     I/O window 1: 0x0200 to 0x027f, 32 bit
 Socket 1:
   not configured

 cardctl ident output:
 =====================
 Socket 0:
   product info: "3Com Corporation", "3CCFE575BT", "LAN Cardbus Card", "001"
   manfid: 0x0101, 0x5157
   function: 6 (network)
 Socket 1:
   No product info available.
