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

FreeBSD Manual Pages

  
 
  

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

NAME
       sane-microtek2 -	SANE backend for Microtek scanners with	SCSI-2 command
       set

DESCRIPTION
       The sane-microtek2 library implements a SANE (Scanner Access Now	 Easy)
       backend that provides access to Microtek	scanners with a	SCSI-2 command
       set.  This backend can be considered alpha to beta. Some	scanner	models
       are reported to work well, others not. New development versions of this
       backend can be obtained from http://karstenfestag.gmxhome.de

       There exists a different	backend	for Microtek scanners with SCSI-1 com-
       mand set.  Refer	to sane-microtek(5) for	details.

       And   there   is	  work	in  progress  for  the	ScanMaker  3600.   See
       http://sourceforge.net/projects/sm3600

       At present, the following scanners are known positively	to  work  with
       this backend:

       Vendor	  Product id	    Remark
       --------------------------------------------------------------------
       Microtek	  E3+		    Parport and	SCSI
       Microtek	  X6		    SCSI
       Microtek	  X6EL		    SCSI
       Microtek	  X6USB		    USB
       Microtek	  ScanMaker V300    Parport and	SCSI
       Microtek	  ScanMaker V310    Parport and	SCSI
       Microtek	  ScanMaker V600    Parport and	SCSI
       Microtek	  ScanMaker 330	    SCSI
       Microtek	  ScanMaker 630	    SCSI
       Microtek	  ScanMaker 636	    SCSI
       Microtek	  ScanMaker 9600XL  SCSI; only flatbed mode?
       Microtek	  Phantom 330CX	    Parport
       Microtek	  SlimScan C3	    Parport
       Microtek	  SlimScan C6	    USB
       Microtek	  Phantom 636	    SCSI
       Microtek	  Phantom 636CX	    Parport
       Microtek	  V6USL		    SCSI and USB
       Microtek	  V6UPL		    USB; not stable
       Microtek	  X12USL	    SCSI; only 8bit color, work	in progress
       Vobis	  HighScan	    SCSI (E3+ based models)
       Scanport	  SQ300		    Parport?
       Scanport	  SQ4836	    SCSI
       Scanpaq	  SQ2030	    Parport

       Additional information can be found at http://www.sane-project.org/.

       If  you own a Microtek scanner other than the ones listed above,	it may
       or may not work with SANE! Because equal	scanners are sold  under  dif-
       ferent names in different countries your	model may be equivalent	to one
       of the above.

       The parport scanners work with the ppscsi + onscsi kernel modules.  See
       http://cyberelk.net/tim/parport/ppscsi.html     and     http://penguin-
       breeder.org/kernel/download/.

       The USB scanners	work with the microtek kernel module. You may have  to
       add  the	vendor and model codes to microtek.c if	they aren't yet	listed
       there.

       Both parport and	USB scanners need the generic SCSI support,  so	 check
       if you have loaded the scsi_mod and sg modules!

       If  you	try  your  scanner for the first time keep an eye on it. If it
       gets commands that it doesn't understand	the scanhead may go beyond the
       scan area.  The scanner then makes strange noises. In this case immedi-
       ately switch off	the scanner or disconnect its power cable  to  prevent
       damages!

       If  your	scanner	is a different one than	the models mentioned above and
       it is working please tell the author about it. It would be nice if  you
       add a logfile to	this information (creation of the logfile: see below).

       If  your	 scanner is not	working	properly you also should create	a log-
       file and	send it	to the author. He will use the information to  improve
       the backend and possibly	make your scanner work.

       How to create the logfile?

       - put the line
	      "option  dump 2" into your microtek2.conf	file or	change the ex-
	      isting "option dump" to "2"

       - in a terminal (bash) type
	      "export SANE_DEBUG_MICROTEK2=30" and then
	      "scanimage -l0 -t0 -x100 -y20 2>scan.log >sout.pnm"
	      You get two files: scan.log contains the	logfile	 and  sout.pnm
	      the scanned image	(if there was scanned something). Zip them be-
	      fore sending.

FRONTEND OPTIONS
       This backend dynamically	enables	the options for	the frontend, that are
       supported  by  the scanner in dependence	of the scanning-mode and other
       options.	 Not supported options are disabled.

       The following options are supported by the Microtek2-driver:

       Color, grayscale, halftone and lineart scans.

       Highlight, midtone, shadow, contrast, brightness,  exposure  time  con-
       trol,  gamma  correction, threshold (dependent of the scan mode and the
       scanner capabilities)

       Transparency media adapter, automatic document feeder

       Additional options can be enabled or  disabled  in  the	microtek2.conf
       file. See the configuration section of this manpage.

DEVICE NAMES
       This backend expects device names of the	form:

	      special

       Where  special is the UNIX path-name for	the special device that	corre-
       sponds to the scanner.  The special device name must be a generic  SCSI
       device  or a symlink to such a device.  Under Linux, such a device name
       could be	/dev/sga or /dev/sge for example.

CONFIGURATION
       The  configuration  file	 for  this   backend   resides	 in   /usr/lo-
       cal/etc/sane.d/microtek2.conf.

       Its  contents  is  a  list  of device names that	correspond to Microtek
       scanners	with SCSI-2 interface. Empty lines and lines starting  with  a
       hash mark (#) are ignored.

       The  configuration  file	 may also contain options. Global options that
       are valid for all devices are placed above the  device  names.  Device-
       specific	 options  are  placed under the	device name. Note that,	except
       for option dump <n> and option strip-height <n>,	the entry in  the  mi-
       crotek2.conf  file  only	 enables  the  corresponding  option for being
       showed in the frontend. There, in the frontend, you can switch the  op-
       tions on	and off.  Currently the	following options are supported:

	      option dump <n>
	      option strip-height <n>
	      option no-backtrack-option <on/off>
	      option lightlid-35 <on/off>
	      option toggle-lamp <on/off>
	      option lineart-autoadjust	<on/off>
	      option backend-calibration <on/off>
	      option colorbalance-adjust <on/off>

       option  dump  _n_  enables printing of additional information about the
       SCSI commands that are sent to the scanner to stderr.  This  option  is
       primarily  useful for debugging purpose.	This option has	to be a	global
       option and is best placed at the	top of the microtek2.conf file.

       If n=1 the contents of the command blocks and the results for  the  IN-
       QUIRY and READ SCANNER ATTRIBUTES command are printed to	stderr.

       If  n=2	the contents of	the command blocks for all other SCSI commands
       are printed to stderr, too. If n=3 the contents of the gamma  table  is
       printed,	too. If	n=4 all	scan data is additionally printed to stderr.

       The default is n=1.

       option  strip-height _n_	, where	<n> is a floating point	number,	limits
       the amount of data that is read from the	scanner	with one read command.
       The  unit is inch and <n> defaults to 1.0, if this option is not	set in
       the configuration file. If less than <n>	inch of	data fit into the SCSI
       buffer, then the	smaller	value is used and this option has no effect.

       If  your	 system	 has a big SCSI	buffer and you want to make use	of the
       whole buffer, increase the value	for <n>. For example, if <n> is	set to
       14.0,  no  restrictions	apply  for scanners with a letter, legal or A4
       sized scan area.

       The following options enable or disable additional frontend options. If
       an  option  is  set  to	<on>  an appropriate option will appear	in the
       frontend.

       option no-backtrack-option _on/off_ prevents the	scanner	head from mov-
       ing  backwards between the read commands.  This speeds up scanning. Try
       it.

       option lightlid-35 _on/off_ If you  use	the  LightLid-35  transparency
       adapter	you get	an advanced option which switches off the flatbed lamp
       during the scan.

       option toggle-lamp _on/off_ You get a button in the frontend where  you
       can switch on and off the flatbed lamp.

       option  lineart-autoadjust  _on/off_ You	can tell the backend to	try to
       determine a good	value for the lineart threshold.

       option backend-calibration _on/off_ Some	scanners (e.g.	Phantom	 330CX
       and  636CX)  need  to have calibrated the data by the backend. Try this
       option if you see vertical stripes in your pictures.

       option colorbalance-adjust _on/off_ Some	scanners (e.g.	Phantom	 330CX
       and  636CX) need	to have	corrected the color balance. If	this option is
       enabled you get advanced	options	where you can balance the colors.  And
       you will	have a button to use the values	that the firmware of the scan-
       ner provides.

       A sample	configuration file is shown below:

	      option dump 1
	      option strip-height 1.0
	      /dev/scanner
	      option no-backtrack-option on
	      #	this is	a comment
	      /dev/sge
	      option lightlid-35 on

       This backend also supports the  new  configuration  file	 format	 which
       makes  it  easier  to detect scanners under Linux. If you have only one
       scanner it would	be best	to use the following  configuration  file  for
       this backend:

	      option dump 1
	      option strip-height 14.0
	      option no-backtrack-option on
	      option backend-calibration on
	      option lightlid-35 on
	      option toggle-lamp on
	      option lineart-autoadjust	on
	      option colorbalance-adjust off
	      scsi * * Scanner

       In this case all	SCSI-Scanners should be	detected automatically because
       of the

       scsi * *	Scanner

       line.

FILES
       /usr/local/etc/sane.d/microtek2.conf
	      The backend configuration	file.

       /usr/local/lib/sane/libsane-microtek2.a
	      The static library implementing this backend.

       /usr/local/lib/sane/libsane-microtek2.so
	      The shared library implementing this backend (present on systems
	      that support dynamic loading).

ENVIRONMENT
       SANE_DEBUG_MICROTEK2
	      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 255 requests all debug output	to be printed.
	      Smaller levels reduce verbosity. To see error messages on	stderr
	      set  SANE_DEBUG_MICROTEK2	to 1 (Remark: The whole	debugging lev-
	      els should be better revised).
	      E.g. just	say:
	      export SANE_DEBUG_MICROTEK2=128

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

AUTHORS
       Bernd Schroeder (not active anymore)
       Karsten Festag  karsten.festag@gmx.de

				  13 Jul 2008		     sane-microtek2(5)

NAME | DESCRIPTION | FRONTEND OPTIONS | DEVICE NAMES | CONFIGURATION | FILES | ENVIRONMENT | SEE ALSO | AUTHORS

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

home | help