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

FreeBSD Manual Pages

  
 
  

home | help
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 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:
	      http://www4.infi.net/~cpinkham/sane/

DOCUMENTATION
CONFIGURATION
       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.
       /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 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.

FILES
       /usr/local/etc/sane.d/artec.conf
	      The   backend   configuration  file  (see	 also  description  of
	      SANE_CONFIG_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.  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/lo-
	      cal/etc/sane.d" being searched (in this order).

       SANE_DEBUG_ARTEC
	      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 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 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.

SEE ALSO
       sane(7),	sane-scsi(5)

AUTHOR
       Chris Pinkham (cpinkham@corp.infi.net)

				  11 Jul 2008			 sane-artec(5)

NAME | DESCRIPTION | DOCUMENTATION | CONFIGURATION | SCSI ADAPTER TIPS | FILES | ENVIRONMENT | BUGS | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=sane-artec&sektion=5&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help