-------------------------------------------------------------------------------
LSpccard, version 2.0, CardBus Controller Patch for Solaris 8
-------------------------------------------------------------------------------

0. Overview

   2.0 - Major re-work in this revision, summarized below:

   * Re-structured the pcic S/W so that it does not conflict with SUN's
     version of pcic S/W.

     The pcic driver, /kernel/drv/pcic is now /kernel/drv/lspcic, and is
     dependent upon the following modules:

		/kernel/misc/ls/cs
		/kernel/misc/ls/cis
		/kernel/misc/ls/pcmcia

   * SUN's pcic driver is disabled by removing the pcic alias in 
     /etc/driver_aliases.  The alias is restored upon package removal.

   * Re-named the 3Com574 driver (pcboom) to p574c.
   * Re-named the 3Com575 driver (cbelx) to c575b.

   * Removed inclusion of the pcelx driver in our package, since this driver
     is a part of the OS bundle.

   * Removed inclusion of the pcxcom driver (Xircom MultiFunction Card). 
     Contact Support@LynnSoft.com for a  copy.

   * Re-directed exection of /boot/solaris/bootconf.exe to the following:
     /boot/solaris/lsbootco.exe, by modifying the /boot/solaris/boot.rc
     script.  The script will be restored upon package removal.

   1.7.5
   - Added the busra-mem-base prop to pcic.conf, in order to get around
     the memory allocation bug on the Panasonic CF-28.

   1.7.4
   - Added Adaptec 1480 SlimScsi extensions to support development of
     the c1480b driver.

   1.7.3
   - Added pcpsm-iobase property to pcpsm.conf, which will allow you
     to overide the auto establishment of the I/O base.

   1.7.2
   - Fixed memory resource allocation bug in busra module
   - Added mac-addr property to the pcnat driver

   1.7.1 
   - Fixed cbelx ftp 'hang'

   1.7 - Added support for the Intel PRO/100B CardBus LAN Card, cbiprb

   1.6.6 - Added support for multiple 575 cards.

   1.6.5 
   - Fixed bootconf bug in setting up the CardBus bus number.  
   - Added multi-cast capability to pcboom (3Com 574) & cblex (3Com 575).  
   - Added WEP capability to pcpsm (Wireless LAN).
   - Fixed wireless to access point bug.
   - Removed debug messages from pcnat (NE2000 clones).

   1.6.4 -
   Added feature to use the Solaris Bus Resource Allocator to determine the
   CardBus I/O address.  You can still override this feature with the pcic-
   cb-iobase property.  Changed pcpsm (wireless) driver to search an exanded
   range of I/O, 200-400, as opposed to 300-400.   

   1.6.3 -
   This version of the patch fixes a major problem with TI based CardBus
   controllers.  

   Also, an attempt has been made to automatically determine the ISA IRQ 
   that is routed to the PCI bus.  To override the auto detection, set the 
   /kernel/drv/pcic.conf:interrupt-vectors property to the ISA IRQ that you 
   believe to be correct, most cases, this will be IRQ 11. 

   We've also added a test to determine whether the I/O address used by the 
   CardBus card (cb-iobase) is valid.  Most cases you'll see an error message 
   during boot if there's a conflict, but not always.  If your machine 'locks up' 
   during boot with a CardBus card inserted, remove the card and reboot.  Check 
   your /var/adm/messages file for error messages from the 'locked up' boot. 
   See the attached faq.txt file for solutions to the most common problems.

   IMPORTANT NOTE : 

   In order for the pcic driver to be configured properly for
   a CardBus card, the CardBus card MUST be inserted during
   boot time.  When a CardBus card is detected during power-up,
   the socket is configured for PCI interrupts, which means
   that only CardBus cards will work in the socket.  Hot swapping
   of CardBus cards in the CardBus enabled socket is supported,
   while hot swapping a 16-BIT card into a CardBus enabled socket
   is is not.  Since the default power up mode (no cards inserted) 
   does not enable CardBus features, hot-swapping a CardBus card 
   into a socket which has not been enabled for CardBus, will not 
   work.


1. Distribution Contents

1.1 readme.txt   - this file
1.2 LSpccard.tar - pkgadd distribution 


2 Patch Installation

2.1 Extract pkgadd distribution media: 

	tar xvf LSpccard.tar 

2.2 Execute the pkgadd :

	pkgadd LSpccard 

2.3 Restart the computer. You may need to reboot twice before any PC cards are
    recognized.


3 Patch Removal

3.1 Execute pkgrm :

	pkgrm LSpccard 

3.2 Restart the computer.


4 Compatability

4.1 The PCMCIA patch has been tested on the following laptop computers:

	- Panasonic ToughBook, Model CF-71
	- Toshiba Satellite, Model 2805

4.2 The following PC Cards have been tested :

	- Network
		- 3Com EtherLink III, Model 3CCE589B, (pcelx)
		- 3Com 10Mbps LAN PC Card, Model 3CCE589DT, (pcelx)
		- 3Com 10Mbps LAN PC Card, Model 3CCE589ET, (pcelx)
		- 3Com 10/100 LAN PC Card, Model 3C3FE574BT, (p574c)
        - 3Com 10/100 LAN CardBus card, Model 3CCFE575TX, (c575b)
        - 3Com 10/100 LAN CardBus card, Model 3CCFE575BT, (c575b)
        - 3Com 10/100 LAN CardBus card, Model 3CCFE575CT, (c575b)
   		- D-Link DFE-650, (pcnat)
		- Intel PRO/100B 10/100 LAN CardBus Card, MBLA3300, (cbiprb)
		- Intel PRO/100B 10/100 LAN CardBus Card, MBLA3300 C3, (cbiprb)
		- Intel PRO/100B 10/100 LAN CardBus Card, MBLA3400, (cbiprb)
		- Intel PRO/100B 10/100 LAN CardBus Card, MBLA3456, (cbiprb)
   		- NETGEAR FA 410, (pcnat)
   		- Socket EA, (pcnat)
   		- Socket LP-E, (pcnat)
		- Xircom RealPort2 Ethernet 10/100, Model R2E-100, (pcrpII)
		- Xircom RealPort2 CardBus Ethernet 10/100, Model R2BE-100, (cbrpII)

	- Modem
		- 3Com 56K Global Modem PC Card, Model 3CCM156B
		- BocaModem, Model M144PA
		- Racal SafeDial, Model V.34
		- Practical Peripherals ProClass, Model PC288T2 EZ

	- Network/Modem Multifunction
   		- Xircom RealPort Ethernet 10/100+Modem 56, Model REM56G-100, (pcxcom)
		- NOTE: This driver is no longer bundled into the LSpccard package,
          contact support@LynnSoft.com for a free copy.

	- WireLess Network
		- Linksys Instant Wireless PC Card, Model WPC11, (pcpsm)
		- Netgear 802.11b Wireless PC Card, Model MA401, (pcpsm)
                * Agere (Lucent) Orinoco PC Card Silver (pcpsm???) 
	- Disk
		- Calluna 520, Model CT521RM 
		- Calluna 260, Model CT260MC
		- Maxtor MobileMax 105, Model MXL-105-III
		- Kingston DataPak 520
		- SanDisk FlashDisk PCMCIA PC Card ATA

	- Serial
		- Socket I/O Serial Card

5 Technical Support

  LynnSoft Technical Support may be reached at : support@lynnsoft.com.

  See the attached faq.txt for answers to frequently asked questions.

  Along with a description of the problem and the hardware involved,
  we'll need the following files:

  1. /boot/debug.txt file

     enabled by editing /boot/solaris/boot.rc and changing:

		run /boot/solaris/lsbootco.exe ${confflags}
	to
		run /boot/solaris/lsbootco.exe -d136 ${confflags}

  2. /var/adm/messages file, with pcic debugging enabled.  Edit 
	 /kernel/drv/lspcic.conf and set pcic-debug=1;

     please send only the last boot sequence...

  3. /etc/driver_aliases file

  4. prtconf.txt file

     use prtconf > prtconf.txt to create this one.

  5. modinfo.txt file

     use modinfo > modinfo.txt to create this one.