
              ---------------------------------------------
             | How to use the PCI driver for Khomp boards. |
              ---------------------------------------------

0) Garantee you have the kernel source from the kernel you are using 
   right now installed in your system.

   To check the kernel being used by your system, type:

$ uname -a

1) Compile the PCI driver:

$ make

2) Check the driver compilation (as root):

# sh kptest
Loading Khomp PCI device: ok!

3) If loaded OK, install the driver:

# make install

Then, update the modules registry:

# depmod -a

This command is needed for your system to be able
to load 'kpci9030' module using modprobe command.

4) With your driver loaded, now you can proceed the board
   utilization with the proper userspace tools.


                           ------------------
                          | Troubleshooting. |
                           ------------------

Q: What kernels do you support?
A: The 2.6 series. We tested the driver mostly from the 2.6.8 kernel
   to the 2.6.20, and we recommend kernels above the 2.6.13.

Q: What about the 2.4/2.2/2.0/.. series?
A: The 2.4.x series was supported in old releases, but it was not very
   good for realtime audio (too much latency issues), so we do not
   support it anymore. As a general rule, the 2.6 series is needed if
   you want good support for processing that needs low latency.

Q: How do I install the kernel sources for Linux XXXX version YYY?
A: Every distribution has a different way for doing this. Check your
   distribution documentation, or try searching on the internet: this
   procedure probably is documented somewhere, with an explanation
   showing the needed steps.

Q: The module does not compile, it could not find the kernel sources!
A: You can use the option KDIR at make to force a specific kernel source,
   as shown below:

# make KDIR=/usr/src/my-kernel-source

   Beware that if you pass sources from a different kernel version, or even
   sources from a kernel with the same version but different configuration
   to this option, the driver *MAY NOT WORK PROPERLY*.

Q: I am using kernel version X.Y.Z but want to install the driver for 
   version A.B.C!
A: Use the option KVER for the make program, like this:

# make KVER=A.B.C

   Beware that you will have to boot to the other kernel in order to be
   able to test the driver compilation!
