Developer Information
=====================

I hope there will no reason for you to add support to a new UMAX
scanner, because the driver should do it by itself.

To enable unknown Scanners, first try: "umax-cli --continue -I"
to see if the inquiry is ok. Then try first scan by:
"umax-cli --continue -l -w100 -h100 | xv -" (or something like that)

You may also try to change some options. Some scanners just don't work
if they get an option that is not supported, so try with differnt
command-line-options.

If you got an unknown scanner to work with the driver and the inquiry
is ok, you can add the scanner in umax-scanner.h. Just add the name (printed
out by umax-cli --continue -I) to scanner_str[] and increase known_scanners.

If you got the scanner work but the inquiry is not ok, you have to define
your own inquiry like it is done for UC630 nad UG630.
For that you have to create a file umax-scannername.h (like umax-uc630.h).
In umax-scanner.h include the new file and add the structure to inquiry_table
and increase known_inquiry.

Please give informations about that to
Oliver Rauch <Oliver.Rauch@Wolfsburg.DE>
with the Inquiry-output and the changes you made so that the scanner
will be supported by later releases of the driver.

If that doesn't work and you like to try it on your own:

Have a look at
umax-cli.c	for command-line-interface
umax-driver.c	for upper-level-driver
umax-text.c	for big textoutput
umax-scsi.c	for low-level-driver
umax-scsi.h	for low-level-driver-function-definiton
umax-scsidef.h	for scsi-definitions
umax-scanner.h	for scanner-definitions

First try to find out where the driver hangs. Use option "-v 5"
to get scsi-trace in /tmp/umax.scsi.debug and have a look
at it.  The file is opened in O_APPEND mode, so if you want a
fresh start, delete it by hand.  It's a poor substitute for a
scsi analyzer, but it often helps.

If you got a working driver, find out what exactly must be
changed of this version. Don't forget the driver has to
work for other scanners too. So it would be nice if you
could tell us, which bit or byte has to be changed in
the window_parameter block or what else must be changed.
Please send informations to
Oliver Rauch  <Oliver.Rauch@Wolfsburg.DE>
(in german or english).
If possible describe in an easy way what must be done to make
your scanner work, send Inquiry-Output and make unified diffs
(diff -u oldfile newfile), say what version you are using and
send them to one of us for inclusion in later releases of the
driver.

if you need more informations contact me <Oliver.Rauch@Wolfsburg.DE>.

good luck!
