
 SANE (Scanner Access Now Easy) Ver 1.0.14 for OS/2(Only SNAPSCAN USB-Scanner)
  ----------------------------------------------------------------------------

Description
============
Only Snapscan Scanner (SnapScan backend).
This application is Test Version(Ver0.23).
This Application is introduced to the public with a purpose of becoming the
help which a USB Scanner is available for with OS/2.
SANE Frontend Ver 1.0.12 and Backend Ver 1.0.14 compiled with IBM VAC/2.


Snapscan USB-Scanner            Vendor ID Product ID
  Benq/Acer/Vuego 310U            0x04a5    0x1a20
  Benq/Acer/Vuego 320U            0x04a5    0x2022
  Benq/Acer/Vuego 620U / 620UT    0x04a5    0x1a2a
                                  0x04a5    0x2040
  Benq/Acer/Vuego 640U            0x04a5    0x2060
  Benq/Acer/Vuego 640BU           0x04a5    0x207e
  Benq/Acer/Vuego 1240U           0x04a5    0x20c0
  Benq/Acer/Vuego 3300 / 4300     0x04a5    0x20b0
  Benq/Acer/Vuego 4300            0x04a5    0x20de
  Benq/Acer/Vuego 5000            0x04a5    0x20fc
  Benq/Acer/Vuego 5300            0x04a5    0x20fe

  Agfa 1236U                      0x06bd    0x0002
  Agfa 1212U                      0x06bd    0x0001
                                  0x06bd    0x2061
  Agfa Snapscan e10               0x06bd    0x2093
  Agfa Snapscan e20               0x06bd    0x2091
  Agfa Snapscan e25               0x06bd    0x2095
  Agfa Snapscan e26               0x06bd    0x2097
  Agfa Snapscan e40               0x06bd    0x208d
  Agfa Snapscan e42               0x06bd    0x20ff
  Agfa Snapscan e50               0x06bd    0x208f
  Agfa Snapscan e52               0x06bd    0x20fd

  Epson Perfection 660            0x04b8    0x0114
  Epson Perfection 1670           0x04b8    0x011f   Tested. Thanks, Fritz Schori
                                                                     Juergen Ulbts


Files
======
- Readme.txt      : This File.
- scanimage.exe   : SANE Frontend.
- libsane.dll     : SANE Backend.
- snapscan.conf   : Snapscan Scanner configer.

- \USBSCAN
-- readme         : USBSCAN.SYS readme text.
-- usbscan.sys    : USB-Scanner Device class Driver Ver 0.41b.
-- scaninfo.exe   : USB-Scanner Infomation utility.
-- scaninfo.def   : DEF File.
-- scaninfo.c     : scaninfo.exe sorce code.


Requirements
=============
- OS/2 Warp 3/4 or Warp Server for e-Business.
  (Warp 3 and Warp Server not tested)
- USB Basic device drivers(After Augest,2003).
- USB Scanner device class driver(Included).
- Firmware is necessary for the model of some scanner.
  Refer to the following SANE SNAPSCAN Homepage.
    http://snapscan.sourceforge.net/


Installation
==============
Copy scanimage.exe and libsane.dll snapscan.conf to your directory.
USB Scanner device class Driver is SEE \USBSCAN\readme.
The directory name which installed Scanimage.exe in config.sys is added.
  SET SANE_CONFIG_DIR=X:\scanimage_directory


Usage
=======
scanimage [OPTION]...

For Example
------------
 Help Infomation.(Be careful because output changes by the option)
  scanimage --mode gray -h > gray.txt
  scanimage --mode color -h > color.txt

 Start Scanning
  scanimage --mode color --resolution 400 --film-type "Positive Film" > Image.ppm


Debug mode
-----------
A debug mode should add the following to config.sys.
(A debugging file name is CHECK.DAT)
  SET SANE2_DEBUG_MODE=YES


Waitting time of reading
-------------------------
Set up waitting time when a reading error occurs in the data transmission
from the your scanner.

When for example the following error occurred in the debugging mode.
  sane_read: buf len = 1272
  sane_read: buf len (adjusted) = 64872
  sanei_usb_read_bulk: trying to read 64872 bytes
  sanei_usb_read_bulk: ulRc=0, Size=32768, Loop=1
  sanei_usb_read_bulk: ulRc=30, Size=0, Loop=2
  sanei_usb_read_bulk: read failed: Message file not found.
  receive buf, expected = 64872, got = 0
  scan_finish()

Settlement of waitting time of reading is to add the following to config.sys.
  SET SANE2_READ_WAIT_TIME=milli second

Example:  SET SANE2_READ_WAIT_TIME=50


Waitting time of writting
--------------------------
Set up waitting time when a writting error occurs in the data transmission
from the your scanner.

Settlement of waitting time of writting is to add the following to config.sys.
  SET SANE2_WRITE_WAIT_TIME=milli second

Example:  SET SANE2_WRITE_WAIT_TIME=50


note: If you are using a command-prompt, it doesn't need to add 
      'SET SANE2_****' to config.sys. Before carrying out scanimage.exe, a key
      inputs 'SET SANE2_****'. It'S convenient for checking the most suitable
      waitting time.
      Don't forget to turn off the power supply of the scanner once when an
      error occurs in scanimage.exe.


Hints of Source Code
=====================
This Application is being compiled in IBM VAC/2.
Infomation to give to the following isn't mentioned about that parts.


a) FRONTEND(scanimage.exe)
-------------------------
scanimage.c  : Original.
stiff.c      : Original.


b) BACKEND(libsane.dll)
------------------------
snapscan.c              : Original(SANE Snapscan Backend v1.4.38 cvs).
snapscan-options.c      : Original.
snapscan-scsi.c         : Changed.
                          Line 1146. fd = fopen(firmware,"r");
                          changed.   fd = fopen(firmware,"rb");
snapscan-source.c       : Original.
snapscan-mutex.c        : Changed.  Ask me.
snapscan-usb.c          : Original.
sanei_usb.c             : Changed.  Ask me.
sane_strstatus.c        : Original.
sanei_config.c          : Original.
sanei_config2.c         : Original.
sanei_pio.c             : Original.
sanei_scsi.c            : Original.
sanei_thread.c          : Original.
sanei_init_debug.c      : Original.
sanei_constrain_value.c : Original.

c) snapscan.conf
-----------------
snapscan.conf           : Original.


Known bugs
===========
unknown.


Bug Reporting
==============
If you find any bugs, please tell me at the contact address below.
- scanimage.exe and libsane.dll version(Date).
- USBSCAN.SYS version.
- OS/2 Version and fixpack level
- USB Basic device driver Version(Date)
- Description of your usb hardware
- scaninfo.exe data


Version History
================
 Ver 0.10   2003-10-20    Initial release
 Ver 0.11   2003-11-01    Bug Fixed
 Ver 0.12   2003-11-07    Fixed sanei_usb_write_bulk().
 Ver 0.13   2003-11-11    SANE Ver1.0.13 second pre-release compiled.
 Ver 0.14   2003-12-04    SANE Ver1.0.12 Test.
 Ver 0.20   2004-01-25    New, SANE Ver1.0.13 compiled.
 Ver 0.21   2004-06-11    New, SANE Ver1.0.14 compiled.
 Ver 0.22   2004-06-16    Changed fopen(firmware,"rb") of download_firmware().
 Ver 0.23   2004-06-29    New release.


Special Thanks.
================
Klaus Staedtler. Tame/2 Ver 1.0.0 Front-Frontend application.
Fritz Schori, Juergen Ulbts
                 I could release SANE SnapScan bakend with an endeavor of the
                 tester, and appreciate it. This program may not have been
                 completed without their cooperation.

Thanks to those who supported us by testing.


Copyright
==========
 Copyright (c) 2002-2004 Team Arum Japan. All rights reserved.


DISCLAIMER
==========
EXCEPT AS OTHERWISE RESTRICTED BY LAW, THIS WORK IS PROVIDED
WITHOUT ANY EXPRESSED OR IMPLIED WARRANTIES OF ANY KIND, INCLUDING
BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES OF FITNESS FOR A
PARTICULAR PURPOSE, MERCHANTABILITY OR TITLE.  EXCEPT AS
OTHERWISE PROVIDED BY LAW, NO AUTHOR, COPYRIGHT HOLDER OR
LICENSOR SHALL BE LIABLE TO YOU FOR DAMAGES OF ANY KIND, EVEN IF
THEY HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.


Contact
========
 Author:        Maeda Haruyuki
 e-mail:        sacana@luck.ocn.ne.jp



