#

# sane-epjitsu.5

    sane-epjitsu(5)          SANE Scanner Access Now Easy          sane-epjitsu(5)

## NAME

           sane-epjitsu - SANE backend for Epson-based Fujitsu USB scanners.

## DESCRIPTION

           The  sane-epjitsu  library  implements a SANE (Scanner Access Now Easy)
           backend which provides  basic  access  the  Fujitsu  fi-60F/fi-65F  and
           ScanSnap S300/S1300(i)/S1100(i) scanners.

## HARDWARE SUPPORT

           These  scanners  are  fairly limited, only supporting a couple of modes
           and resolutions, and always scanning full width. The  backend  supports
           missing modes (binary, grayscale) and intermediate resolutions in soft‐
           ware, but provides only minimal scan area controls. See KNOWN ISSUES.

           This backend may support other scanners. If physical inspection reveals
           an  Epson  chipset,  please contact the author for instructions on col‐
           lecting a USB trace under Windows to verify.

## OPTIONS

           A limited effort has been made to expose the standard  options  to  the
           API.   This allows a frontend to set resolution, color mode, and choose
           the ADF setting. The  epjitsu  backend  supports  the  following  basic
           options for most scanners:

           source s
                  Selects  the source for the scan. Options may include "Flatbed",
                  "ADF Front", "ADF Back", "ADF Duplex".

           mode m
                  Selects the mode for the scan. Options  may  include  "Lineart",
                  "Gray", "Color".

           resolution, y-resolution
                  Controls   scan   resolution.  Setting  --resolution  also  sets
                  --y-resolution, though this behavior is overridden by some fron‐
                  tends.

           Other  options will be available based on the capabilities of the scan‐
           ner. Use 'scanimage --help' to get a list. Be aware that  some  options
           may  appear  only  when  another option has been set, and that advanced
           options may be hidden by the frontend.

## CONFIGURATION FILE

           The configuration file "/usr/local/etc/sane.d/epjitsu.conf" is used  to
           tell the backend how to look for scanners, and provide options control‐
           ling the operation of the backend. This file  is  read  each  time  the
           frontend  asks  the backend for a list of scanners, generally only when
           the frontend starts. If the configuration file is missing, the  backend
           will not work.

           Scanners can be specified in the configuration file in two ways:

           "usb 0x04c5 0x10c7" (or other vendor/product ids)
                  Requests  backend  to  search all usb busses in the system for a
                  device which uses that vendor and product id.  The  device  will
                  then be queried to determine if it is a supported scanner.

           "usb /dev/usb/scanner0" (or other device file)
                  Some  systems  use  a kernel driver to access usb scanners. This
                  method is untested.

           The only configuration option supported  is  "firmware  /PATH/TO/FILE",
           allowing  you  to  set  the  location  of  the  firmware  file you have
           extracted from the Windows driver.

           Note: This firmware is a copyrighted work of Fujitsu, so cannot be pro‐
           vided by the backend or the author. Please do not ask.

           Note:  These scanners REQUIRE a firmware file to function. See the sup‐
           plied configuration file for more detail.

           Note: This option may appear multiple times in the configuration  file.
           It  only applies to scanners discovered by 'usb' lines that follow this
           option.

## ENVIRONMENT

           The backend uses a  single  environment  variable,  SANE_DEBUG_EPJITSU,
           which enables debugging output to stderr. Valid values are:

                  5  Errors
                  10 Function trace
                  15 Function detail
                  20 Option commands
                  25 USB trace
                  30 USB detail
                  35 Useless noise

## KNOWN ISSUES

                  Only limited scan area options are exposed.
                  fi-60F  and  fi-65F hardware grayscale mode is not used, because
                  the calibration code is not finished.

## CREDITS

           S300 support funded by Microdea, Inc. and Archivista, GmbH.
           fi-60F support funded by TrueCheck, Inc.
           Improved calibration code provided by Richard Goedeken.

## SEE ALSO

           sane(7), sane-usb(5)

## AUTHOR

           m. allan noah: <kitno455 a t gmail d o t com>

                                      11 Apr 2017                  sane-epjitsu(5)