Subject: Qtronix Sagitta Sane driver.
Version: 0.4 alpha
Author:  Andre Herms
email:	 aherms@cs.uni-magdeburg.de


This is the alpha version of the Qtonix Sagitta sane driver.
At the moment only Sagitta Gray is tested because I don't 
have an Color. If you have a Color and it works please mail me.

Of course there is NO WARANTY....

Okay, how to install this driver.

The backend is divided in two parts. Because of the controller card, there
is a kernel device needed. I made it available by a kernel patch for 
kernel 2.2.0. There is the first problem: the 2.2.x kernels use a big
among of memory, perhaps too much for some older sytems. I will later 
convert the patch to kernel 2.0.x ( when I have the time ). 

How to apply the kernel patch:
login as root.
the first you need the kernel 2.2.0 source code. (from ftp.kernel.org) 
Put it into a directory named linux ( normally /usr/src/linux ) 
Change to dir where /linux is (/usr/src) and copy the *.gz-files
to this.
Expand the file sagitta-0.4.patch-2.2.0.gz with "gzip -d sagitta-0.4.patch-2.2.0.gz"
Apply the kernel patch with "patch -p0 <sagitta-0.4.patch-2.2.0"
thats it for the kernel source.

Now you need a device file /dev/sagitta.
You create this with "mknod /dev/sagitta 99 1".
I use major 99 for this. This is not offical but its only for testing.

Now you have to compile the kernel. If you don't know how, read the 
Kernel-Howto. The sagitta driver is installed as charakter device. You can also
compile it as modules choosing "m" while configuration.

The settings are given to the driver by boot parameter. Normally this
is done by append in /etc/lilo.conf ( append="sagitta=0x100,5,0" ) or 
in /etc/conf.modules with a line like "option sagitta sagitta=0x100,7,0".
The first number is Port, the second the IRQ of your controller card. 
in the scanner manual you can read how to set this. The third value is
the model of your scanner; "0" for Sagitta Gray and "1" for Sagitta Color.

After running "lilo" and rebooting these should be setted.

Whooo...this was all for the kernel drivers. It was the hardest part.


And know the sane backend. 
copy the sane sources and the file sane-sagitta-0.4.patch.gz in the same directory.
Expand the patch with "gzip -d sane-sagitta-0.4.patch.gz".
Apply the patch with "patch -p0 <sane-sagitta-0.4.patch".
Now just compile and install sane.
( Important note: look for the directory of the libs. In Debian Linux it 
was necessary to run "configure -libdir=/usr/lib" )

And after all this, it should work and maybe it really does.

always remeber: it's still an alpha version.

PLEASE SEND REMARKS, HINTS AND ALL THE BUG REPORTS TO 
email:aherms@cs.uni-magdeburg.de