diff options
Diffstat (limited to 'doc/sane-hp3900.man')
| -rw-r--r-- | doc/sane-hp3900.man | 110 |
1 files changed, 110 insertions, 0 deletions
diff --git a/doc/sane-hp3900.man b/doc/sane-hp3900.man new file mode 100644 index 0000000..ab0a100 --- /dev/null +++ b/doc/sane-hp3900.man @@ -0,0 +1,110 @@ +.TH sane\-hp3900 5 "06 Jan 2009" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy" +.IX sane\-hp3900 +.SH NAME +sane\-hp3900 \- SANE backend for RTS8822 chipset based scanners +.SH DESCRIPTION +The +.B sane\-hp3900 +library implements a SANE (Scanner Access Now Easy) backend that provides +access at least to the following USB flatbed scanners: +.PP +.RS +.ft CR +.nf +Model: Chipset: +------ -------- +HP ScanJet 3800 RTS8822BL-03A +HP ScanJet 3970 RTS8822L-01H +HP ScanJet 4070 Photosmart RTS8822L-01H +HP ScanJet 4370 RTS8822L-02A +HP ScanJet G2710 RTS8822BL-03A +HP ScanJet G3010 RTS8822L-02A +HP ScanJet G3110 RTS8822L-02A +UMAX Astra 4900/4950 RTS8822L-01H * +BenQ 5550 RTS8823L-01E * +.fi +.ft R +.RE +.PP +More details can be found on the hp3900 backend homepage +.IR http://sourceforge.net/projects/hp3900\-series/ . +.PP +This is ALPHA software. Keep your hand at the scanner's plug and unplug it, if +scanner does not start to scan. See also the BUGS section. +.PP +If you own a scanner other than the ones listed above that works with this +backend, please let us know this by sending the scanner's exact model name and +the USB vendor and device ids (e.g. from +.IR /proc/bus/usb/devices , +.I sane\-find\-scanner +or syslog) to us. Even if the scanner's name is only slightly different from +the models mentioned above, please let us know. +.PP + +.SH CONFIGURATION +The contents of the +.I hp3900.conf +file is a list of usb lines containing vendor and product ids that correspond +to USB scanners. The file can also contain the names of device files that +correspond to an HP 39XX scanner. Empty lines and lines starting with a hash +mark (#) are ignored. The scanners are autodetected by +.B usb vendor_id product_id +statements which are already included into +.IR hp3900.conf . +"vendor_id" and "product_id" are hexadecimal numbers that identify the +scanner. If autodetection does not work, add the device name of your scanner +to the configuration file, +.PP + +.SH FILES +.TP +.I @CONFIGDIR@/hp3900.conf +The backend configuration file (see also description of +.B SANE_CONFIG_DIR +below). +.TP +.I @LIBDIR@/libsane\-hp3900.a +The static library implementing this backend. +.TP +.I @LIBDIR@/libsane\-hp3900.so +The shared library implementing this backend (present on systems that +support dynamic loading). +.SH ENVIRONMENT +.TP +.B SANE_CONFIG_DIR +This environment variable specifies the list of directories that may +contain the configuration file. Under UNIX, the directories are +separated by a colon (`:'), under OS/2, they are separated by a +semi-colon (`;'). If this variable is not set, the configuration file +is searched in two default directories: first, the current working +directory (".") and then in @CONFIGDIR@. If the value of the +environment variable ends with the directory separator character, then +the default directories are searched after the explicitly specified +directories. For example, setting +.B SANE_CONFIG_DIR +to "/tmp/config:" would result in directories "tmp/config", ".", and +"/etc/sane.d" being searched (in this order). +.TP +.B SANE_DEBUG_HP3900 +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_HP3900=4 + +.SH "SEE ALSO" +.BR sane (7), +.BR sane\-usb (5), +.br +.I http://sourceforge.net/projects/hp3900\-series/ +.I http://jkdsoftware.dyndns.org/drupal/?q=es/books/151 + +.SH AUTHOR +Jonathan Bravo Lopez <jkdsoft@gmail.com> + +.SH BUGS +Scanning is only tested with Linux/ix86/gcc. Be careful when testing on other +operating systems and especially on big-endian platforms. The scanner may get +wrong data. + |