


sane-hp(5)                                             sane-hp(5)


NNAAMMEE
       sane-hp - SANE backend for HP ScanJet scanners

DDEESSCCRRIIPPTTIIOONN
       The  ssaannee--hhpp library implements a SANE (Scanner Access Now
       Easy) backend that provides access to HP ScanJet scanners.
       At present, the following scanners are known positively to
       work with this backend:

              Model:          Product  id:                 Inter-
              face:
              ----------                              -----------
              ----------
              ScanJet Plus   C9195A                     HP Paral-
              lel Interface Card
              ScanJet IIc    C1750A 3226                SCSI
              ScanJet IIcx   C2500A 3332                SCSI
              ScanJet IIp    C1790A                     SCSI
              ScanJet 3C     C2520A 3503                SCSI
              ScanJet 4C     C2520A                     SCSI
              ScanJet 6100C  C2520A 3644                SCSI
              ScanJet 6200C  C6270A 3828                SCSI
              ScanJet 6250C  C6270A 3828                SCSI
              ScanJet 3P     C2570A 3406                SCSI
              ScanJet 4P     C1130A 3540                SCSI
              ScanJet 5P     C5110A                     SCSI
              PhotoSmart     C5100A R029, R030, R032    SCSI

       Any  HP  scanners  connected  to the parallel port are not
       supported.

       If you own a ScanJet scanner other than  the  ones  listed
       above,  please  let  us know if your model works with this
       backend.  To do this, send a mail with the relevant infor-
       mation for your scanner 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 the UNIX path-name for the special device
       that corresponds to the scanner.  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. For the Hp
       ScanJet Plus the special device name must  be  the  device
       that  corresponds  to the parallel interface card that was
       shipped with the scanner. Under Linux, such a device  name
       could be _/_d_e_v_/_h_p_s_c_a_n for example.

CCOONNFFIIGGUURRAATTIIOONN
       The  contents of the _h_p_._c_o_n_f file is a list of options and
       device names  that  correspond  to  HP  ScanJet  scanners.



                         28 February 1999                       1





sane-hp(5)                                             sane-hp(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.

       Options  specified  infront of the first line that keeps a
       device name are defaults for all devices.  Options  speci-
       fied  below  a line that keeps a device name apply just to
       the most recently mentioned device.

       Supported options are ccoonnnneecctt--ssccssii, and ccoonnnneecctt--ddeevviiccee.

       Option ccoonnnneecctt--ssccssii specifies that  the  scanner  is  con-
       nected  to  the system by SCSI.  Input/output is performed
       using SCSI-commands.  This is the default.

       Option ccoonnnneecctt--ddeevviiccee specifies that the scanner  is  con-
       nected  to the system by a special device. Input/output is
       performed by read()/write()-operations on the device. This
       option must be used for HP ScanJet Plus.

         A sample configuration file is shown below:

              /dev/scanner
              # this is a comment
              /dev/hpscan
                option connect-device

FFIILLEESS
       _/_u_s_r_/_l_o_c_a_l_/_e_t_c_/_s_a_n_e_._d_/_h_p_._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_-_h_p_._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_-_h_p_._s_o
              The shared library implementing this backend  (pre-
              sent on systems that support dynamic loading).

       _$_H_O_M_E_/_._s_a_n_e_/_c_a_l_i_b_-_h_p_:_<_d_e_v_i_c_e_>_._d_a_t
              Calibration  data  for  HP  PhotoSmart PhotoScanner
              that is retrieved from the scanner  after  calibra-
              tion.  The data is uploaded to the scanner at start
              of the backend if it is in media mode 'print media'
              or if the media mode is changed to 'print media'.

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



                         28 February 1999                       2





sane-hp(5)                                             sane-hp(5)


              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__HHPP
              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.


BBUUGGSS
       HHPP PPhhoottooSSmmaarrtt PPhhoottooSSccaannnneerr
              In  media mode 'slide' and 'negative', scan resolu-
              tions must be selected as multiple of 300 dpi.  The
              scanner  does not scale the data correctly on other
              resolutions. Some newer models (firmware code  R030
              and  later)  do  not  support  adjustment  of  con-
              trast/intensity level and tone  map.   The  backend
              will  simulate  this by software, but only for gray
              and 24 bit color.

       AAuuttoommaattiicc DDooccuummeenntt FFeeeeddeerr ((AADDFF))
              For use of the ADF with xscanimage(1), first  place
              paper  in  the  ADF  and then check the box labeled
              'scan from ADF'. Press 'change document' to load  a
              sheet. Then press 'scan' to start a scan.  Maybe it
              is sufficient to press 'scan' without 'change docu-
              ment'  for  repeated  scans. The use of the preview
              window is not recommended  when  working  with  the
              ADF.


       IImmmmeeddiiaattee aaccttiioonnss
              Some  actions in xscanimage(1) (i.e. unload, select
              media, calibrate) have an immediate effect  on  the
              scanner without starting a scan.  These options can
              not be used with scanimage.


TTOODDOO
       HHPP PPhhoottooSSmmaarrtt PPhhoottooSSccaannnneerr
              PhotoScanners with firmware  release  R030  and  up
              have   no  firmware  support  for  contrast/bright-
              ness/gamma table. In the current  backend  this  is
              simulated  by software on 24 bits data.  Simulation
              on 30 bits should give better results.



                         28 February 1999                       3





sane-hp(5)                                             sane-hp(5)


       PPaarraalllleell ssccaannnneerr ssuuppppoorrtt
              Parallel scanners other than ScanJet Plus  are  not
              supported.   If someone wants to add parallel scan-
              ner support, search the  source  code  for  HHPP__CCOONN--
              NNEECCTT__RREESSEERRVVEE ..  This will lead you to 4 routines in
              hp-scl.c to  open,  read,  write  and  close  those
              devices.  The option ccoonnnneecctt--rreesseerrvvee must be speci-
              fied in the hhpp..ccoonnff file to activate the  routines.
              If there is a kernel driver that would make a scan-
              ner on the parallel port  available  as  a  special
              device,  it  could  be  possible that accessing the
              scanner by ccoonnnneecctt--ddeevviiccee will work.



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

AAUUTTHHOORR
       The sane-hp backend was written by Geoffrey T. Dairiki. HP
       PhotoSmart PhotoScanner support by Peter Kirchgessner.




































                         28 February 1999                       4


