FreeBSD Manual Pages
sane-artec(5) SANE Scanner Access Now Easy sane-artec(5) NAME sane-artec - SANE backend for Artec flatbed scanners DESCRIPTION The sane-artec library implements a SANE (Scanner Access Now Easy) backend that provides access to Artec/Ultima SCSI flatbed scanners. At present, the following scanners are known to work at least partially with this back- end: * Artec A6000C * Artec A6000C PLUS * Artec ViewStation AT3 * BlackWidow BW4800SP (rebadged Artec AT3) * Artec ViewStation AT6 * Artec ViewStation AT12 * Artec AM12S * Plustek 19200S (rebadged Artec AM12S) Although this manual page is generally updated with each release, up-to- date information on new releases and extraneous helpful hints are available from the backend homepage: http://www4.infi.net/~cpinkham/sane. CONFIGURATION The contents of the artec.conf file are a list of device names that corre- spond to Artec scanners. Empty lines and lines starting with a hash mark (#) are ignored. See sane-scsi(5) on details of what constitutes a valid device name. Sample file: # artec.conf # # this is a comment. # # this line says search for any SCSI devices which are scanners and have # a vendor string of 'ULTIMA' scsi ULTIMA # # the next line forces the backend to assume the next scanner found has # the specified vendor string (useful for testing rebadged models). vendor ULTIMA # # the next line forces the backend to assume the next scanner found has # the specified model string (useful for testing rebadged models). model AT3 # # now a line that actually specifies a device. The backend is going to # assume this is an Artec/Ultima AT3 because we forced the vendor and # model above. /dev/scanner # # once we hit a scanner device line, the forced vendor and model # string are # 'forgotten', so the vendor and model for this next device will be # determined from the result of a SCSI inquiry. /dev/sge # SCSI ADAPTER TIPS Some Artec scanners come with an included SCSI adapter. If your scanner came with a DTC ISA SCSI cards, you can probably use it with recent (>= 2.2.0) kernels using the generic NCR5380 support. You must pass the fol- lowing boot argument to the kernel: "dtc3181e=0x2c0,0" I do not have any information on the PCI SCSI adapter included with some newer Artec scanners. FILES /usr/local/etc/sane.d/artec.conf The backend configuration file (see also description of SANE_CON- FIG_DIR below). /usr/local/lib/sane/libsane-artec.a The static library implementing this backend. /usr/local/lib/sane/libsane-artec.so The shared library implementing this backend (present on systems that support dynamic loading). ENVIRONMENT SANE_CONFIG_DIR This environment variable specifies the list of directories that may contain the configuration file. On *NIX systems, 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 /usr/local/etc/sane.d. If the value of the environment variable ends with the directory separator character, then the default directories are searched after the ex- plicitly specified directories. For example, setting SANE_CON- FIG_DIR to "/tmp/config:" would result in directories tmp/config, ., and /usr/local/etc/sane.d being searched (in this order). SANE_DEBUG_ARTEC If the library was compiled with debug support enabled, this envi- ronment variable controls the debug level for this backend. E.g., a value of 128 requests all debug output to be printed. Smaller levels reduce verbosity: SANE_DEBUG_ARTEC values: Number Remark 0 print important errors 1 print errors 2 print sense 3 print warnings 4 print scanner-inquiry 5 print information 6 print less important information 7 print major called procedures 8 print all called procedures 9 print procedure info/data messages 10 print called sane-init-routines 11 print called sane-procedures 12 print sane infos 13 print sane option-control messages 50 print verbose data/debug messages == 100 print software RGB calibration data == 101 print raw data from scanner to artec.data.raw file == 128 print out all messages Example: export SANE_DEBUG_ARTEC=13 BUGS Known bugs in this release: A6000C+ users with firmware v1.92 or earlier have problems with the backend, the cause has not been determined. Some- times the backend is not particularly robust, you can possibly lock up the SCSI bus (and/or machine) by not having patience enough when scanning. 3-channel gamma correction is not implemented and single-channel gamma cor- rection is not totally working on models other than the AT3. SEE ALSO sane(7), sane-scsi(5) AUTHOR Chris Pinkham <cpinkham@corp.infi.net> 11 Jul 2008 sane-artec(5)
NAME | DESCRIPTION | CONFIGURATION | SCSI ADAPTER TIPS | FILES | ENVIRONMENT | BUGS | SEE ALSO | AUTHOR
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sane-artec&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>