1. 2_SATALINUXSRC1.00.0.8.zip Driver
2. README File Contents

README Driver File Contents (2_SATALINUXSRC1.00.0.8.zip)

              Promise SATA150 Series Linux Driver Version 1.00.0.8
              ----------------------------------------------------

July 23, 2003

Contents
========

- Foreword
- Support List
- File List
- Prerequisites
- Building and Installation
- OS Dependent Information
- Troubleshooting
- Support


Foreword
========

Use this driver with all Promise SATA150 Series adapter and onboard
chipsets running under the Linux operating system. 


Support List
============

The following Promise SATA150 series adapters and Linux operating systems are
compatible with the drivers in this release:

Chipset		Adapter Name
--------	------------
PDC20318	Promise SATA150 TX4
PDC20375	Promise SATA150 TX2plus
PDC20378	Promise SATA 378
PDC20618	Promise Ultra 618

OS		kernel version
--		--------------
RedHat 7.3	kernel 2.4.18-3
RedHat 8.0	kernel 2.4.18-14
Mandrake 9.0	kernel 2.4.19-16
SuSE 8.0	kernel 2.4.18
SuSE 8.1	kernel 2.4.19
TurboLinux 8.0	kernel 2.4.18
N/A		kernel 2.4.x	(a kernel that you compiled)


File List
=========

File Name	Description
---------	-----------
pdc618_mod.c	Promise SATA150 Series Linux Driver 
pdc618_mod.h	header file of pdc618_mod.c
Makefile	Makefile of Linux driver
README		this README
cam/		directory of Common Access Module (CAM). 
		needed by pdc618_mod.c


Prerequisites
=============

A develop environment is required to compile SATA150 Linux driver. Please 
verify these tools are all functional. The easiest way is to choose the
developer toolkit when installing Linux. 

4.1 kernel source code
    #rpm -qa|grep kernel-source

4.2 GNU C
    #gcc --version

4.3 GNU make
    #make --version

4.4 binutils
    #ld --version

4.5 modutils
    #insmod -V
   

Building and Installation
=========================

For the build to work properly it is important that the currently running 
kernel MATCH the version and configuration of the installed kernel source. 

5.1 Create the folder: /usr/local/src/pdc-ultra

5.2 Copy all files in the Ultra-1.0.8 package into the pdc-ultra folder.

5.3 Clean up old object files.

    #make clean

5.4 Compile SATA150 Linux driver.

    #make

5.5 Install the driver module.

    #make install
   
5.6 Load SCSI driver first 
    (Some OS have built in kernel and can skip this step, such as SuSE)
 
    #insmod scsi_mod
    #insmod sd_mod

5.7 Load the driver module.

    #insmod pdc-ultra

   NOTE: `insmod pdc-ultra' and `insmod pdc-ultra.o' is different.
   `insmod pdc-ultra' will load /lib/modules/<kernel_version>/kernel/drivers/
   				  scsi/pdc-ultra.o
   `insmod pdc-ultra.o' will load pdc-ultra.o in current directory.

5.8 Create a RAM Disk. An example:

    #mkinitrd --preload scsi_mod --preload sd_mod --with=pdc-ultra 
    /boot/initrd.ft `uname -r`

5.9 Edit your boot loader to recognize the RAM Disk.

5.10 Restart Linux, partition and format the drive(s) on the SATA150 card.
       

OS Dependent Information
========================

6.1 SuSE 8.x

   Compiling Linux SATA150 Drivers  
   -------------------------------
   When trying to compile SATA150 drivers on SuSE 8.x systems a compilation 
   failure occurs, and a message regarding a mismatch between the running kernel
   and the kernel source tree configuration appears. By default, SuSE installs
   SMP kernel while the kernel source tree is configured for UP. A possible 
   solution is to reconfigure kernel configuration.

   #cd /usr/src/linux/
   #make mrproper
   #cp /boot/vmlinuz.config .config
   #make oldconfig
   #make dep

     

Troubleshooting
===============

7.1 Can't compile SATA Linux dirver
-------------------------------
   1. Read Prerequisties section, make sure all tools are functional. For more
      information, please read kernel documents.
   2. Linux kernel must be configured correctly.


When I `insmod pdc-ultra.o', there are some error messages.

7.2 pdc-ultra.o: kernel-module version mismatch
-------------------------------------------
   That means kernel version mismatch.
   1. check kernel source version in `/usr/src/linux/include/linux/version.h' 
   2. check the currently running kernel version

      #uname -r

   3. Both two version must match.
   4. If not match, please reconfigure kernel.


7.3
pdc-ultra.o: unresolved symbol scsi_unregister_module
pdc-ultra.o: unresolved symbol scsi_register
pdc-ultra.o: unresolved symbol scsi_register_module
pdc-ultra.o: unresolved symbol scsi_unregister
-----------------------------------------------------
   That means scsi module have not load.
   1. Load scsi module first
      #insmod scsi_mod
      #insmod sd_mod
   2. Load scsi module first
      #mkinitrd --preload scsi_mod --preload sd_mod


7.4 pdc-ultra.o: create_module: Operation not permitted
---------------------------------------------------
   That means you must have root privilege to load driver.


7.5
pdc-ultra.o: init_module: Operation not permitted
Hint: insmod errors can be caused by incorrect module parameters, including 
invalid IO or IRQ parameters.
---------------------------------------------------------------------------
   That means SATA driver can't find any supporting adapter.
   1. check your adapter is in SATA driver supporting list.
   2. verify adapter is correctly installed in PCI slot.
   3. BIOS load correctly and detect all hard drives.
   4. linux have detected your adapter
      #lspci -n | grep 105a

      for example, it shows like this, where 105a is vendor id, 3375 is device 
      id.

         01:03.0 Class 0180: 105a:3375 (rev 01)

      here is a short list of vendor id and device id.
      Chipset		Adapter Name		Vendor:Device
      -------		------------		-------------
      PDC20318		Promise SATA150 TX4	105a:3318
      PDC20375		Promise SATA150 TX2plus	105a:3375
      PDC20378		Promise SATA 378	105a:3373
      PDC20618		Promise Ultra 618	105a:6626

   5. recompile driver and load correct driver
      #make -C cam clean all
      #make clean all
      #insmod pdc-ultra.o


7.6 insmod: a module named pdc-ultra already exists
-----------------------------------------------
   That means SATA driver have been loaded.  Ther is no need to load it again.
   SATA driver status can be found by using following command
   #cat /proc/scsi/pdc-ultra/*


Support
=======

This code is provided as-is and Promise Technology does not provide
technical support for the code. This Linux source code should only be
used by experienced Linux users.  


If you have any Linux Source Code comments, please email: 
linuxcomments@promise.com and linux@promise.nl