Initial checkin.

doc/descriptions/niash.desc

@@ -0,0 +1,48 @@
+; $Id$
+; SANE Backend specification file
+;
+; It's basically emacs-lisp --- so ";" indicates comment to end of line.
+; All syntactic elements are keyword tokens, followed by a string or
+;  keyword argument, as specified.
+;
+; ":backend" *must* be specified.
+; All other information is optional (but what good is the file without it?).
+;
+
+:backend "niash"
+:version "0.1"
+:manpage "sane-niash"
+:new :yes
+:url "http://sourceforge.net/projects/hp3300backend"
+
+:devicetype :scanner
+
+:mfg "Hewlett-Packard"
+:url "http://www.hp.com"
+
+:model "ScanJet 3300c"
+:interface "USB"
+:comment "NIASH00012/00013/00014 chip. Color scans only."
+:status :basic
+
+:model "ScanJet 3400c"
+:interface "USB"
+:comment "NIASH00019 chip. Color scans only."
+:status :basic
+
+:model "ScanJet 4300c"
+:interface "USB"
+:comment "NIASH00019 chip. Color scans only."
+:status :basic
+
+:mfg "Agfa"
+:url "http://www.agfa.com"
+
+:model "Snapscan Touch"
+:interface "USB"
+:comment "NIASH00014 chip. Color scans only."
+:status :basic
+
+
+
+

doc/niash/niash.TODO

@@ -0,0 +1,63 @@
+To do:
+======
+- implement coarse calibration to determine settings for analog-front-end
+  All CCDs encountered so far seem to need about the same settings however.
+
+- Store analog calibration data somewhere.
+  Use currently used values as default.
+
+- Suggestions by Marcin Cieslak:
+	- clean up structures
+	- clean up namespace
+	- clean up source formatting ('indent --gnu' ?)
+
+
+- implement real calibration, using 12 bit data at 600 dpi
+  instead of 8 bit data.at 150 dpi.
+  -> is now at 600 dpi, not yet at 12 bit
+
+- design a mechanism to set the scan and calibration areas
+  a) part of HWProps structure, or
+  b) set by user at first scan
+
+- further investigate scanner registers
+  a) study backtracking register more
+  b) identify bits in bit-oriented registers.
+
+- add more error checking ('sanity checking') on parameters
+
+- figure out what the USB interrupts mean that sometimes occur.
+
+- Get rid of mytypes.h / fix types
+  Now an int is implicitly assumed to be 32 bit.
+
+
+Done
+====
+
+- make backend comply with tstbackend
+-> all externs and publics removed when compiling towards sane
+
+- implement sane_cancel properly
+-> done by ullsig
+
+- implement timing mechanism for scanner lamp
+  so scanning can only start if the lamp was already on for 30 seconds
+Possible implementation:
+On startup: if lamp is off, turn it on and start timer
+On scan: if lamp is off, turn it on and start timer. Wait for timer expiry.
+On exit: if scanner chip is niash00012 then turn off lamp,
+  otherwise let the scanner turn it off automatically
+-> Implemented by Ullrich Sigwanz
+
+- try out parallel port scanning on HP3400/4300
+-> parallel port support will be dropped, no people to test/develop it
+
+- investigate vertical resolution setting of hp3400/4300.
+-> experiment with the motor table, formula is already known to generate it
+-> 600 dpi is possible by doubling most values in the table
+-> 150 dpi can be done by using register 0x06 to skip every other line
+
+- Add separate gamma tables for R, G, B. This should be easy (look at how
+  other backends do it) but is not really required yet.
+-> not required

doc/sane-niash.man

@@ -0,0 +1,65 @@
+.\" $Id$
+.TH sane-niash 5 "29 July 2004" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX sane-niash
+
+.SH NAME
+sane-niash - SANE backend for scanners based on the NIASH chipset.
+
+.SH DESCRIPTION
+The
+.B sane-niash
+implements a SANE (Scanner Access Now Easy) backend that
+provides access to NIASH chipset based scanners. This backend will try to support
+the following models:
+
+MANUFACTURER:    MODEL:          USB ID:
+.br
+---------------  --------------  ---------
+.br
+Agfa             Snapscan Touch  06BD-0100 (1)(a)
+.br
+Hewlett-Packard  Scanjet 3300c   03F0-0205 (1)(a)(b)
+.br
+Hewlett-Packard  Scanjet 3400c   03F0-0405 (2)(b)
+.br
+Hewlett-Packard  Scanjet 4300c   03F0-0305 (2)(a)
+.PP
+.br
+ASIC: (1) - NIASH00012/00013/00014 / (2) - NIASH00019
+.br
+ANALOG FRONT-END: (a) - ESIC ES8100QA / (b) - WM8143-12
+.br
+
+.SH CONFIGURATION
+The
+.I niash.conf
+file is meant for future configuration options.
+Empty lines and lines starting with a hash mark (#) are
+ignored. Currently no configuration options exist.
+
+.SH FILES
+.TP
+.I @LIBDIR@/libsane-niash.a
+The static library implementing this backend.
+
+.TP
+.I @LIBDIR@/libsane-niash.so
+The shared library implementing this backend (present on systems that
+support dynamic loading).
+.SH ENVIRONMENT
+
+.TP
+.B SANE_DEBUG_NIASH
+If the library was compiled with debug support enabled, this
+environment variable controls the debug level for this backend.  Higher
+debug levels increase the verbosity of the output.
+
+Example:
+export SANE_DEBUG_NIASH=255
+
+.SH "SEE ALSO"
+sane(7), sane\-usb(5)
+.br
+http://www.sourceforge.net/projects/hp3300backend
+.SH AUTHOR
+Bertrik Sikken <bertrik@zonnet.nl>