#######################################################################
#         Silicon Image SiI SATA controller                           #
#                     Linux  Driver                                   #
#######################################################################

1. OVERVIEW
   This driver disk adds support for SiI SATA controller that is otherwise
   not supported by a Distribution. For newer kernels this driver overrides
   the Open Source Driver.

   Supported versions:

      * SuSE Pro 9.3, Kernel revision 2.6.11.4-20a.
      * This driver rev. 1.0.5.8 supports 32-bit AMD/EM64T platforms for 
        Sii3124 controller with base (non-RAID) port multiplier and hot-plug capabilities.


2. CREATE FLOPPY

   A floppy disk is required to install into a brand new (or blank) disk drive. 

   Several Options:
 
  . If you received a zip file, Use Winzip to unzip the [distribution]filename.zip file on to a formatted floppy disk.
  . If you received a tgz file, extract the contents of the [distribution]_sii____rhdd.tgz file on to a
    formatted floppy disk. (e.g. use tar xzf [distribution]_sii____rdhh.tgz)
    
  . If you received an img file, and you are running windows: use "rawrite.exe sii____.img A:" 

  . If you are running Linux:  use "dd if=filename.img of=/dev/fd0"
  

  Note: IMPORTANT NOTE FOR OEM CUSTOMERS
        ADD your PCI ID to the "pcitable" file if OEM VendorId is going to be different 
        from SiI 0x1095 IDs. (End Users should ignore this step) 

 
   *** The following BIOS BOOT sequence is recommended => CD, Hard Disk, Floppy



3. INSTALL SOFTWARE SuSE

     The installation requires special care since SuSE 9.x series reboots automatically.
     By default SuSE wants to boot from the Hard Disk.  At Boot Time manual intervention is required to
     choose Installation.

     3.1  Insert Bootable( disk 1) CDROM and Driver Floppy

     3.2  Choose "Installation" instead of "Boot From Hard Disk"

     3.3  When it comes to Yast Base installation screen, before you choose the language for
          installation, get a shell prompt (see last page) and execute the initial_install script
          as follows:

          # mount /dev/fd0 /media/floppy
          # cd /media/floppy
          # ./initial_install.sh


     3.4   Follow the rest of the instructions

	   Choose 'New installation' if a fresh install


     3.5  Most SuSE installations require some extra steps as follows:

          a)  Disk 1( bootable CD) should be in the CD/DVD ROM drive before system reboot. 
               

          b)  REPEAT the installation steps EXACTLY as the first
              time. Choose INSTALLATION again and repeat the steps
              you followed in 3.3.

          c)  However, when Yast (the graphical interface) comes up 
              choose 'Boot installed system' instead of 'New installation'

          d)  Finish the installation but BEFORE rebooting the second
              time do the following:

              # mount /dev/fd0 /media/floppy
              # cd /media/floppy
              # ./upgrade_driver.sh    or    sh ./upgrade_driver.sh

	      After running upgrade_drive.sh, now remove CD and You are done.

	  e)  Reboot System.
              If you get a 'grub>' screen or 'Kernel Panic' you will have to go back to step a).  
	      Typically you login as root and have the full window system
              at this point.
	      

			     


4. GENERAL INFO

   . If you cat /proc/scsi/sii31*/* you should see the Driver as reported by
     the kernel
 
   . If you cat /proc/scsi/scsi you should see the your device as reported
     by the kernel


5. Special Cases

   If the driver does not install automatically you can install it manually 
   as follows:

	  a) Wait until the Graphical Interface comes up at boot time. An 
             ACCEPT/CANCEL box show up. 

	  b) Get a console window (CTL-ALT-F2). 

	  c) Mount the floppy and install the default driver. One way
             to do it is by typing:

	     mkdir /f; mount /dev/fd0 /f; cd /f; ./initial_install.sh

	  d) CTL-ALT-F7 gets you back to the graphical interface. 

	  e) Continue with the installation. The next time it reboots
             you will have to repeat the steps above. See next section.
          
          *  If disk fails to format you may have to repartition the drives
             as follows:
             . get a window CTL-ALT-F2)
             . mke2fs /dev/sda; fdisk /dev/sda 
               then type "2" then "w" to rewrite the partition table

6. New Features and bug fixes

   a. The driver could support SATA ATAPI devices.
   b. This revision of driver has Java GUI interface that can configure legacy RAID set.

7.   Known Restriction

   Please note that ATAPI hot plug is not expected.



Console Keystrokes Contents 

1 [Ctrl]-[Alt]-[F1] installation dialog 
2 [Ctrl]-[Alt]-[F2] shell prompt 
3 [Ctrl]-[Alt]-[F3] install log (messages from installation program) 
4 [Ctrl]-[Alt]-[F4] system-related messages 
5 [Ctrl]-[Alt]-[F5] other messages 
7 [Ctrl]-[Alt]-[F7] X graphical display
