Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
sane-artec(5)		 SANE Scanner Access Now Easy		 sane-artec(5)

       sane-artec - SANE backend for Artec flatbed scanners

       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 backend:

	      *	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:

       The  contents  of  the  artec.conf file are a list of device names that
       correspond to Artec scanners.  Empty lines and lines  starting  with  a
       hash mark (#) are ignored.  See sane-scsi(5) on details of what consti-
       tutes 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.
       # 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.

       Some Artec scanners come	with an	included SCSI adapter.	If your	 scan-
       ner 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 following 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.

	      The  backend  configuration  file	 (see  also   description   of
	      SANE_CONFIG_DIR below).

	      The static library implementing this backend.

	      The shared library implementing this backend (present on systems
	      that support dynamic loading).

	      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 con-
	      figuration file is searched in two default  directories:	first,
	      the  current  working  direc-  tory  (".")  and then in /usr/lo-
	      cal/etc/sane.d.  If the value of the environment	variable  ends
	      with  the	directory separator character, then the	default	direc-
	      tories are searched after	the explicitly specified  directories.
	      For example, setting SANE_CONFIG_DIR to "/tmp/config:" would re-
	      sult in directories tmp/config, ., and /usr/local/etc/sane.d be-
	      ing searched (in this order).

	      If the library was compiled with debug support enabled, this en-
	      vironment	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 file
	       == 128  print out all messages

       Example:	export SANE_DEBUG_ARTEC=13

       Known bugs in this release: A6000C+ users with firmware v1.92  or  ear-
       lier have problems with the backend, the	cause has not been determined.
       Sometimes 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  correction  is not totally working on models other than
       the AT3.

       sane(7),	sane-scsi(5)

       Chris Pinkham _cpinkham@corp.infi.net_

				  11 Jul 2008			 sane-artec(5)


Want to link to this manual page? Use this URL:

home | help