#######################################################################
#         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 Enterprise 9.0, SP1, RC5, Kernel revision 2.6.5-7.139.
      * This driver rev. 1.0.5.8 supports 64-bit AMD/Intel platforms for 
        Sii3512 controller with RAID 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 SP1 Bootable( disk 1) CDROM.

     3.2  Insert the driver floppy, the driver would be loaded later automatically.

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

     3.4  Swap to SLES CD as prompt indicated.

     3.5  When it comes to Yast Base installation screen, select "I Agree" to the license agreement.

     3.6  Continue to follow the rest of the instructions.

	  Note: 1. Right before you click 'OK' to choose 'New installation' during Yast settings, get a shell prompt
                 by [Ctrl]-[Alt]-[F2] and type 'rmmod sata_sil' to remove the open source driver, otherwise the installer                      would use the open source driver instead of SiI31xx driver to do the installation.

     3.7  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.1 through 3.5.

          c)  However, when Yast (the graphical interface) comes up 
              choose 'Boot installed system' instead of 'New installation'.
	      Note: Right before you click 'OK' to choose 'Boot installed system' during Yast settings, get a shell prompt
                 by [Ctrl]-[Alt]-[F2] and type 'rmmod sata_sil' to remove the open source driver, otherwise the installer                      would use the open source driver instead of SiI31xx driver to do the 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 Restrictions

   1. The driver could only work on 3512 controller, but not 3112 controller.
   2. When doing fresh installation for bootable drive connected to SiI controller, this driver might have problem on certain AMD platforms.

   3. 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
