


sane-abaton(5)                                     sane-abaton(5)


NNAAMMEE
       sane-abaton - SANE backend for Abaton flatbed scanners

DDEESSCCRRIIPPTTIIOONN
       The  ssaannee--aabbaattoonn library implements a SANE (Scanner Access
       Now Easy) backend that provides access to  Abaton  flatbed
       scanners. At present, only the Scan 300/GS (8bit, 256 lev-
       els of gray) is fully supported, due  to  the  absence  of
       programming information.  The Scan 300/S (black and white)
       is recognized, but support for it is untested.

       If you own a Abaton scanner other  than  the  ones  listed
       above  that works with this backend, or if you own an Aba-
       ton scanner that does not work with this  backend,  please
       contact  _s_a_n_e_-_d_e_v_e_l_@_m_o_s_t_a_n_g_._c_o_m  with the model number, so
       that arrangements can be made to include support for it.

       Abaton is out of business, and these scanners are not sup-
       ported  by  Everex  (the parent company of Abaton), nor is
       there any  programming  information  to  be  found.   This
       driver  is therefore based on information obtained by run-
       ning Abaton's scanning desk accessory  under  MacsBug  and
       tracing  the MacOS SCSI Manager calls it made during image
       acquisition.

       However, the protocol is very similar to, though not  com-
       patible  with,  the one used by the Apple scanners, there-
       fore, if this backend is  ever  extended  to  support  the
       other  Abaton models (they also made a color flatbed scan-
       ner), it may be possible to fill in some "missing  pieces"
       from the (quite detailed) Apple scanner documentation.


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 the path-name for the special device that
       corresponds to a SCSI scanner. For SCSI scanners, the spe-
       cial  device  name must be a generic SCSI device or a sym-
       link to such a device.  Under Linux, such  a  device  name
       takes  a format such as _/_d_e_v_/_s_g_a or _/_d_e_v_/_s_g_0, 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 _a_b_a_t_o_n_._c_o_n_f file is a list  of  device
       names that correspond to Abaton 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.






                           19 Nov 1998                          1





sane-abaton(5)                                     sane-abaton(5)


FFIILLEESS
       _/_u_s_r_/_l_o_c_a_l_/_e_t_c_/_s_a_n_e_._d_/_a_b_a_t_o_n_._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).

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_a_b_a_t_o_n_._a
              The static library implementing this backend.

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_a_b_a_t_o_n_._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 /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 explicitly spec-
              ified  directories.  For example, setting SSAANNEE__CCOONN--
              FFIIGG__DDIIRR to "/tmp/config:" would result in  directo-
              ries "tmp/config", ".", and "/usr/local/etc/sane.d"
              being searched (in this order).

       SSAANNEE__DDEEBBUUGG__AABBAATTOONN
              If the library  was  compiled  with  debug  support
              enabled,  this  environment  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.


BBUUGGSS
       There are a few known ones, and  definitely  some  unknown
       ones.

       SSccaann aarreeaa mmiissccaallccuullaattiioonnss
              For the sake of programmer efficiency, this backend
              handles all measurements in millimetres, and floors
              (rather  than rounds) values to avoid possible dam-
              age to the scanner mechanism.   Therefore,  it  may
              not  be  possible  to  scan to the extreme right or
              bottom edges of the page.

       CCaanncceelllliinngg tthhee ssccaann
              This might not work correctly, or  it  might  abort
              the  frontend.   The former is more likely than the
              latter.



                           19 Nov 1998                          2





sane-abaton(5)                                     sane-abaton(5)


       If you have found something  that  you  think  is  a  bug,
       please  attempt  to recreate it with the SANE_DEBUG_ABATON
       environment variable set to 255, and send a report detail-
       ing    the    conditions    surrounding    the    bug   to
       _s_a_n_e_-_d_e_v_e_l_@_m_o_s_t_a_n_g_._c_o_m.


TTOODDOO
       IImmpplleemmeenntt nnoonn--bblloocckkiinngg ssuuppppoorrtt

       FFiinniisshh rreevveerrssee--eennggiinneeeerriinngg tthhee MMaaccOOSS ddrriivveerr
              This will allow me to add support for other  models
              with  reasonable  confidence  that it will work, as
              well as to fully exploit the  information  returned
              by the INQUIRY command.


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


AAUUTTHHOORR
       The  sane-abaton  backend  was  partially written by David
       Huggins-Daines, based on the sane-apple backend  by  Milon
       Firikis.
































                           19 Nov 1998                          3


