


sane-mustek(5)                                     sane-mustek(5)


NNAAMMEE
       sane-mustek - SANE backend for Mustek flatbed scanners

DDEESSCCRRIIPPTTIIOONN
       The  ssaannee--mmuusstteekk library implements a SANE (Scanner Access
       Now Easy) backend that provides access to  Mustek  flatbed
       scanners.  At present, the following scanners are known to
       work with this backend:

              Model:      Product id: Firmware revision: Type:
              ----------- ----------- ------------------ -----
              MFC-600S    MFC-06000CZ v1.01 (and higher) 1-pass
              MFC-600CD   MFC-06000CZ v2.03 (and higher) 1-pass
              MFS-6000CX  MSF-06000CX v2.71 (and higher) 3-pass
              MSF-6000SP  MSF-06000SP v3.12 (and higher) 1-pass
              MFS-8000SP   MFS-08000SP   v2.05   (lineart   drops
              lines?) 1-pass
              MFC-800S    MFC-08000CZ v1.06 [color fails] 1-pass
              MFS-1200SP  MSF-12000SP v1.00 (and higher) 1-pass
              MFS-1200SP  MFS-12000SP v1.02 [color fails?] 1-pass
              MFS-1200SP  MFS-12000SP v1.07 1-pass
              MFS-12000CX MFS-12000CX v2.71 (and higher) 3-pass

       Note that most of the above  scanners  come  with  a  SCSI
       interface.   The  only non-SCSI scanner that has some sup-
       port at this point is the 600 II  N  scanner  which  comes
       with  its  own  parallel  port  adapter (i.e., it does _n_o_t
       attach to the printer port).  More info on how to use  the
       600 II N can be found below in section PARALLEL PORT SCAN-
       NERS.

       If you own a Mustek scanner other  than  the  ones  listed
       above  that works with this backend, please let us know by
       sending the scanner's model name, SCSI  id,  and  firmware
       revision to _s_a_n_e_-_d_e_v_e_l_@_m_o_s_t_a_n_g_._c_o_m.


DDEEVVIICCEE NNAAMMEESS
       This backend expects device names of the form:

              _s_p_e_c_i_a_l

       Where  _s_p_e_c_i_a_l  is  either  the  path-name for the special
       device that corresponds to a SCSI scanner or the port num-
       ber  at  which  a  parallel-port scanner can be found (see
       section PARALLEL PORT SCANNERS below).  For SCSI scanners,
       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  _/_d_e_v_/_s_g_a  or  _/_d_e_v_/_s_g_e, for example.  See sane-
       scsi(5) for details.

CCOONNFFIIGGUURRAATTIIOONN
       The contents of the _m_u_s_t_e_k_._c_o_n_f file is a list of  options
       and  device  names  that  correspond  to  Mustek scanners.



                           13 May 1998                          1





sane-mustek(5)                                     sane-mustek(5)


       Empty lines and lines starting with a hash  mark  (#)  are
       ignored.   See sane-scsi(5) on details of what constitutes
       a valid device name.

       The three options supported are lliinneeddiissttaannccee--ffiixx, lliinneeaarrtt--
       ffiixx,  and  ssttrriipp--hheeiigghhtt.   Options  come  in  two flavors:
       global and positional ones.  Global options apply  to  all
       devices  managed by the backend whereas positional options
       apply just to the most recently  mentioned  device.   Note
       that this means that the order in which the options appear
       matters!  Option lliinneeddiissttaannccee--ffiixx is positional and  works
       around  a  problem  that occurs with some SCSI controllers
       (notably the ncr810 controller  under  Linux).   If  color
       scans  have  horizontal stripes and/or the colors are off,
       then it's likely that your controller  suffers  from  this
       problem.   Turning  on this option usually fixes the prob-
       lem.

       Option lliinneeaarrtt--ffiixx is positional and works around a timing
       problem that seems to exist with certain MFS-12000SP scan-
       ners.  The problem manifests itself in dropped lines  when
       scanning  in  lineart mode.  Turning on this option should
       fix the problem but may slow down scanning a bit.

       Finally, ssttrriipp--hheeiigghhtt is a global option limits the  maxi-
       mum  height  of  the strip scanned with a single SCSI read
       command.  The height is specified in inches and  may  con-
       tain  a  fractional  part (e.g., 1.5).  Setting the strip-
       height to a small value (one inch,  for  example)  reduces
       the  likelihood  of encountering problems with SCSI driver
       timeouts and/or timeouts with other devices  on  the  same
       SCSI  bus.   Unfortunately,  it also increases scan times.
       Thus, if the scanner is the only device on the SCSI bus it
       is  connected  to  and if it is known that the SCSI driver
       does not suffer from premature timeouts, it is recommended
       to  increase  the  strip-height  or remove the option com-
       pletely, which corresponds to an  infinite  strip  height.
       See  sane-scsi(5) on how to avoid problems with SCSI time-
       outs.

       A sample configuration file is shown below:

              # limit strip height of /dev/scanner to 1.5 inches:
              option strip-height 1.5

              /dev/scanner    # first Mustek scanner

              /dev/sge        # second Mustek scanner
                # turn on fixes for /dev/sge:
                option lineart-fix
                option linedistance-fix






                           13 May 1998                          2





sane-mustek(5)                                     sane-mustek(5)


SSCCSSII AADDAAPPTTEERR TTIIPPSS
       Mustek  SCSI  scanners are typically delivered with an ISA
       SCSI adapter.  Unfortunately, that adapter  is  not  worth
       much  since it is not interrupt driven.  It is (sometimes)
       possible to get the supplied card  to  work,  but  without
       interrupt line, scanning will put so much load on the sys-
       tem, that it becomes almost unusable for other tasks.

       If you already have a working SCSI controller in your sys-
       tem,  you should consider that Mustek scanners do not sup-
       port the SCSI-2 disconnect/reconnect  protocol  and  hence
       tie  up  the  SCSI  bus while a scan is in progress.  This
       means that no other SCSI device on the  same  bus  can  be
       accessed while a scan is in progress.

       Because  the Mustek-supplied adapter is not worth much and
       because Mustek scanners do not support the SCSI-2  discon-
       nect/reconnect  protocol,  it  is recommended to install a
       separate (cheap) SCSI controller for Mustek scanners.  For
       example,  ncr810  based  cards  are known to work fine and
       cost as little as fifty US dollars.

       For Mustek scanners, it is typically necessary to  config-
       ure  the  low-level  SCSI  driver  to  disable synchronous
       transfers, tagged command queuing, and target disconnects.
       See sane-scsi(5) for driver and platform-specific informa-
       tion.

PPAARRAALLLLEELL PPOORRTT SSCCAANNNNEERRSS
       This backend has very preliminary support for the  Paragon
       600  II  N  parallel port scanner.  Note that this scanner
       comes with its own ISA card that implements a funky paral-
       lel  port  (in other words, the scanner does not connected
       to the printer parallel port).  The code present  in  this
       release  has NOT been tested, so proceed at your own risk!
       Be prepared to pull the scanner cable on short  notice  in
       case the situation grows dangerous and/or noisy.

       A  parallel  port scanner can be configured by listing the
       port number of the adapter in the mustek.conf file.  Valid
       port numbers are 0x26b, 0x2ab, 0x2eb, 0x22b, 0x32b, 0x36b,
       0x3ab, 0x3eb.  Pick one that  doesn't  conflict  with  the
       other hardware in your computer.

       Note  that  for parallel port scanners root privileges are
       required to access the I/O ports.  Thus, either make fron-
       tends  such  as scanimage(1) and xscanimage(1) setuid root
       (generally not recommend for saftey reasons) or,  alterna-
       tively,  access  this  backend  through the network daemon
       saned(1).

       Also note that after a while of no activity,  the  scanner
       itself  (not  the  SANE  backend) turns off its CCFL lamp.
       This shutdown is not always perfect with the  result  that



                           13 May 1998                          3





sane-mustek(5)                                     sane-mustek(5)


       the  lamp  sometimes  continues  to glow dimly at one end.
       This doesn't appear to be dangerous since as soon  as  you
       use  the scanner again, the lamp turns back on to the nor-
       mal high brightness.  However,  the  first  image  scanned
       after  such  a  shutdown may have stripes and appear to be
       over-exposed.  When this happens, just take another  scan,
       and the image will be fine.

FFIILLEESS
       _@_C_O_N_F_I_G_D_I_R_@_/_m_u_s_t_e_k_._c_o_n_f
              The  backend  configuration file (see also descrip-
              tion of SSAANNEE__CCOONNFFIIGG__DDIIRR below).

       _@_L_I_B_D_I_R_@_/_l_i_b_s_a_n_e_-_m_u_s_t_e_k_._a
              The static library implementing this backend.

       _@_L_I_B_D_I_R_@_/_l_i_b_s_a_n_e_-_m_u_s_t_e_k_._s_o
              The shared library implementing this backend  (pre-
              sent on systems that support dynamic loading).

EENNVVIIRROONNMMEENNTT
       SSAANNEE__CCOONNFFIIGG__DDIIRR
              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 sepa-
              rator character, then the default  directories  are
              searched  after  the  explicitly specified directo-
              ries.   For  example,  setting  SSAANNEE__CCOONNFFIIGG__DDIIRR  to
              "/tmp/config:"    would   result   in   directories
              "tmp/config", ".", and "@CONFIGDIR@" being searched
              (in this order).

       SSAANNEE__DDEEBBUUGG__MMUUSSTTEEKK
              If  the  library  was  compiled  with debug support
              enabled, this  environment  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.

SSEEEE AALLSSOO
       sane-scsi(5)

AAUUTTHHOORR
       David Mosberger and Andreas Czechanowski

BBUUGGSS
       Transparency adapter and automatic document feeder support
       is severly lacking (due to absence of  equipment  to  test



                           13 May 1998                          4





sane-mustek(5)                                     sane-mustek(5)


       this with).

       There seems to be a performance bug that makes scanning on
       (some) three-pass scanner slower than necessary.





















































                           13 May 1998                          5


