                     AMD Linux Driver for SP5100
                          For SLES 10 SP1
                    Version 2.3.1   [June.03, 2009]
                  =================================

Contents
========

  1. Introduction
  2. Installation and Configuration
  3. Changes
  4. Known Issues


1 INTRODUCTION
==============

Driver status:
  SATA AHCI  Need to upgrade AHCI driver
             (See Installation and Configuration - SATA AHCI Driver)
  IDE        Not supported
  USB        Supported in standard distribution
  SMBUS      Not supported
  ACPI       Modify OS config file
             (see Installation and Configuration - ACPI)


2 INSTALLATION and CONFIGURATION
================================

SATA AHCI Driver
----------------
  When a SATA device (HDD or ODD) is used for SLES 10 SP1 installation, the 
  updated driver image in the "driver-disk" folder needs to be loaded. The 
  installation procedure is shown as below:

  1) unzip 32bit or 64bit disk image package
  2) Choose "Native IDE" mode or "AHCI" mode in BIOS
  3) use "dd" command to generate driver disk in a floppy or a USB flash drive
     - floppy disk usage (/dev/fd0 is the device node of floppy diskette):
         # dd if=dd_ahci.img of=/dev/fd0
     - USB flash drive usage (/dev/sdb is the device node of USB flash disk, 
       dd_ahci.img is the disk image):
         # dd if=dd_ahci.img of=/dev/sdb
  4) In the first installation screen, you will see "F3 Other Options" at the 
     bottom of the screen. After pressed F3, "F5 Driver" will appear at the 
     bottom of the screen.
  5) Press F5 and choose "YES".
  6) Select "installation" to continue the driver installation
  7) select "fd0" or "USB partition" and press "OK" in the "Driver upgrade 
     mediam" dialog box
  8) In the "Installation Settings" window, click "Change" -> "Partitioning" -> 
     "Base Partition Setup on This Proposal", You NEED to change all partitions'
     fstab options to "Volume Label" from "Device Name", and define a volume 
     label.
  9) Continue the OS installation procedure.

  Example:

  1) Follow the installation guide, when you see the "Installation Settings" 
     window, click "Change"->"Partitioning"->"Base Partition Setup on This 
     Proposal".
  2) Create partitions for swap, / by "Create".
  3) Choose partition for swap, click "Edit", change fstab options as Volume 
     Label, and define a volume label.
  4) Repeat step 3) for / partition.
  5) Continue to install linux, OS installation passes and rebooting is OK too.

  AHCI Driver Upgraded for XEN kernel:
  
  1) If you choose to install XEN kernel during OS installation, the AHCI
     driver disk can support XEN kernel.
  2) If you choose to insatll XEN kernel after OS installation, go into the 
     scripts folder and run ahci_xen_install.sh with root privilege.
	# cd scripts
	# sh ahci_xen_install.sh
	# reboot

USB
---
  EHCI driver can be upgraded for stability, add ehci-hcd to INITRD_MODULES 
  variable in /etc/sysconfig/kernel before install the package.
  Go into the "scripts" folder and run usb_ehci_install.sh with root
  privilege to install the USB EHCI driver:
        # cd scripts
        # sh usb_ehci_install.sh
	# reboot

ACPI
----
  1) Change the root and resume partition to device name (such as sdax,sdbx...)
     in /boot/grub/menu.lst.
  2) Make sure the root and resume partitions in /etc/fstab are the same as in
     the /boot/grub/menu.lst.
  3) Configure the /etc/powersave/sleep as:
        SUSPEND2RAM_FORCE="yes"
        SUSPEND2RAM_VBE_POST="yes"
  4) Boot with "vga=0".
  5) Please use the command "powersave -u" for S3 and command 
     "powersave -U" for S4.

  Notes:
  1) It is normal that the system resumed from s3 with a blank screen, delete the
     specified function "screen_saver" of the configuration item 
     EVENT_GLOBAL_SUSPEND2RAM / EVENT_GLOBAL_SUSPEND2DISK in/etc/powersave/events 
     to remove the screen saver for S3/S4.

  2) If Broadcom 57xx Gigabit ethernet controller is used in your platform, please 
     upgrade tg3 driver to version 3.80+ or add the following configuration in
     /etc/powersave/sleep:
     - Add "tg3" in variables 
        UNLOAD_MODULES_BEFORE_SUSPEND2DISK 
        UNLOAD_MODULES_BEFORE_SUSPEND2RAM
     - Add "network" in variables
        SUSPEND2DISK_RESTART_SERVICES
        SUSPEND2RAM_RESTART_SERVICES


3 CHANGES
=========

  1) [2009/05/13] Add support to ACPI.
  2) [2009/06/03] Update support to ACPI.


4 KNOWN ISSUES
==============

  1) PATA/IDE device is not Supported.
  2) SMBUS is not supported in standard distribution.
  3) When combined mode is enabled in BIOS, the last 2 SATA ports are not 
     supported because they are driven by IDE driver.
  4) If `lspci` does not give the accurate infomation, please replace the 
     native pci.ids file with the latest one from the official website:
         http://pciids.sourceforge.net/
  5) USB subsystem may hang or show error messages when operation through
     USB hub.
  6) BurnInTest to USB ODD may fail after several stress cycles.
  7) ACPI S3/S4 can not work in x86_64 with 4G or 4G above system memory,
     please add boot option "iommu=soft" to work around it.

