kopia lustrzana https://gitlab.com/sane-project/backends
Docs for the the teco1 backend.
Frank Zago
rodzic
4359513416
commit
8fdce3ac3e
|
|
@ -0,0 +1,64 @@
|
|||
;
|
||||
; SANE Backend specification file
|
||||
;
|
||||
; It's basically emacs-lisp --- so ";" indicates comment to end of line.
|
||||
; All syntactic elements are keyword tokens, followed by a string or
|
||||
; keyword argument, as specified.
|
||||
;
|
||||
; ":backend" *must* be specified.
|
||||
; All other information is optional (but what good is the file without it?).
|
||||
;
|
||||
|
||||
:backend "teco1" ; name of backend
|
||||
:version "1.0-4" ; version of backend
|
||||
:status :alpha ; :alpha, :beta, :stable, :new
|
||||
:manpage "sane-teco1" ; name of manpage (if it exists)
|
||||
:url "http://fz.eryx.net/sane/#teco" ; backend's web page
|
||||
|
||||
:devicetype :scanner ; start of a list of devices....
|
||||
; other types: :stillcam, :vidcam,
|
||||
; :meta, :api
|
||||
|
||||
:mfg "Relisys"
|
||||
:url "http://www.relisys.com/"
|
||||
:model "RELI 2412"
|
||||
:interface "SCSI"
|
||||
:comment "sub model VM3530+"
|
||||
:model "AVEC 2400"
|
||||
:comment "sub model VM3520"
|
||||
;:model "AVEC 2412"
|
||||
;:comment "sub model VM3520+"
|
||||
;:model "AVEC 4800"
|
||||
;:comment "sub model VM4530"
|
||||
;:model "AVEC 4816"
|
||||
;:comment "sub model VM4530+"
|
||||
;:model "RELI DS6"
|
||||
;:comment "sub model VM3420"
|
||||
;:model "RELI DS15"
|
||||
;:comment "sub model VM3440"
|
||||
;:model "RELI 2400"
|
||||
;:comment "sub model VM3530"
|
||||
;:model "RELI 4816"
|
||||
;:comment "sub model VM4540"
|
||||
;:model "RELI 4830"
|
||||
;:comment "sub model VM4542"
|
||||
;:model "RELI 9600"
|
||||
;:comment "sub model VM6530"
|
||||
;:model "RELI 9612"
|
||||
;:comment "sub model VM6530*"
|
||||
;:model "RELI 9624"
|
||||
;:comment "sub model VM6530+"
|
||||
;:model "RELI 9630"
|
||||
;:comment "sub model VM6540"
|
||||
|
||||
|
||||
;:mfg "Actown"
|
||||
;:model "ACT Scan I 30"
|
||||
;:comment "sub model VM3520A"
|
||||
|
||||
|
||||
; :comment and :url specifiers are optional after :mfg, :model, :desc,
|
||||
; and at the top-level.
|
||||
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,186 @@
|
|||
.TH sane-teco1 5 "19 March 2002"
|
||||
.IX sane-teco1
|
||||
.SH NAME
|
||||
sane-teco1 - SANE backend for TECO / RELISYS scanners
|
||||
.SH DESCRIPTION
|
||||
The
|
||||
.B sane-teco1
|
||||
library implements a SANE (Scanner Access Now Easy) backend that
|
||||
provides access to some TECO SCSI flatbed scanners. This backend
|
||||
should be considered
|
||||
.B beta-quality
|
||||
software! TECO scanners are sold under
|
||||
various brands like RELYSIS, PIOTECH, TRUST. This backend may or
|
||||
may not support yours.
|
||||
.PP
|
||||
The scanners that should work with this backend are:
|
||||
.PP
|
||||
.RS
|
||||
Vendor Model TECO model status
|
||||
.br
|
||||
---------------------- -------------- -----------
|
||||
.br
|
||||
Relisys RELI 2412 VM3530+ tested
|
||||
Relisys AVEC 2412 VM3520+ untested
|
||||
Relisys AVEC 2400 VM3520 tested
|
||||
Relisys AVEC 4800 VM4530 untested
|
||||
Relisys AVEC 4816 VM4530+ untested
|
||||
Relisys RELI DS6 VM3420 untested
|
||||
Relisys RELI DS15 VM3440 untested
|
||||
Relisys RELI 2400 VM3530 untested
|
||||
Relisys RELI 2412 VM3530+ untested
|
||||
Relisys RELI 4816 VM4540 untested
|
||||
Relisys RELI 4830 VM4542 untested
|
||||
Relisys RELI 9600 VM6530 untested
|
||||
Relisys RELI 9612 VM6530* untested
|
||||
Relisys RELI 9624 VM6530+ untested
|
||||
Relisys RELI 9630 VM6540 untested
|
||||
|
||||
.RE
|
||||
|
||||
Note that the untested scanner will not be directly supported. You
|
||||
should contact the author for that.
|
||||
|
||||
The TECO VM number can usually be found at the back of the
|
||||
scanner. It is also part of the FCC ID.
|
||||
|
||||
The options the backend supports can either be selected through
|
||||
command line options to programs like scanimage or through GUI
|
||||
elements in xscanimage or xsane.
|
||||
|
||||
.br
|
||||
If you have any success with a scanner not listed here, or if you have
|
||||
any strange behavior, please report to the backend maintainer or to
|
||||
the SANE mailing list.
|
||||
|
||||
Valid command line options and their syntax can be listed by using
|
||||
.RS
|
||||
scanimage --help -d teco1
|
||||
.RE
|
||||
|
||||
.TP
|
||||
.B Scan Mode
|
||||
|
||||
.TP
|
||||
.B --mode
|
||||
selects the basic mode of operation of the scanner valid choices are
|
||||
.I Black & White
|
||||
,
|
||||
.I Grayscale
|
||||
and
|
||||
.I Color
|
||||
The Black & White mode is black and white only (1 bit). Grayscale
|
||||
will produce 256 levels of gray (8 bits). Color will produce a 24 bits
|
||||
color image.
|
||||
|
||||
.TP
|
||||
.B --resolution
|
||||
selects the resolution for a scan. The scanner can do all resolutions
|
||||
between 1 and 600, in increments of 1.
|
||||
|
||||
|
||||
.TP
|
||||
.B Geometry options
|
||||
|
||||
.TP
|
||||
.B -l -t -x -y
|
||||
control the scan area: -l sets the top left x coordinate, -t the top
|
||||
left y coordinate, -x selects the width and -y the height of the scan
|
||||
area. All parameters are specified in millimeters by default.
|
||||
|
||||
|
||||
.TP
|
||||
.B Enhancement options
|
||||
|
||||
.TP
|
||||
.B --custom-gamma
|
||||
(color mode only) allows the user to specify a gamma table (see the
|
||||
next 3 parameters).
|
||||
|
||||
.TP
|
||||
.B --red-gamma-table
|
||||
(color mode only) can be used to download a user defined
|
||||
gamma table for the red channel. The table must be 256 bytes long.
|
||||
|
||||
.TP
|
||||
.B --green-gamma-table
|
||||
(color mode only) can be used to download a user defined
|
||||
gamma table for the green channel. The table must be 256 bytes long.
|
||||
|
||||
.TP
|
||||
.B --blue-gamma-table
|
||||
(color mode only) can be used to download a user defined gamma table
|
||||
for the blue channel. The table must be 256 bytes long.
|
||||
|
||||
.TP
|
||||
.B --dither
|
||||
(Black & White only) select the dither mask to use. Possible values are
|
||||
.I Line art
|
||||
,
|
||||
.I 2x2
|
||||
,
|
||||
.I 3x3
|
||||
,
|
||||
.I 4x4 bayer
|
||||
,
|
||||
.I 4x4 smooth
|
||||
,
|
||||
.I 8x8 bayer
|
||||
,
|
||||
.I 8x8 smooth
|
||||
,
|
||||
.I 8x8 horizontal
|
||||
and
|
||||
.I 8x8 vertical
|
||||
|
||||
|
||||
.TP
|
||||
.B --preview
|
||||
requests a preview scan. The resolution used for that scan is 22 dpi
|
||||
and the scan area is the maximum allowed. The scan mode is user
|
||||
selected. The default is "no".
|
||||
|
||||
|
||||
.SH CONFIGURATION FILE
|
||||
The configuration file @CONFIGDIR@/teco1.conf supports only one information: the device name to use (eg /dev/scanner).
|
||||
|
||||
|
||||
.SH FILES
|
||||
.TP
|
||||
.I @LIBDIR@/libsane-teco1.a
|
||||
The static library implementing this backend.
|
||||
.TP
|
||||
.I @LIBDIR@/libsane-teco1.so
|
||||
The shared library implementing this backend (present on systems that
|
||||
support dynamic loading).
|
||||
|
||||
|
||||
.SH ENVIRONMENT
|
||||
.TP
|
||||
.B SANE_DEBUG_TECO1
|
||||
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.
|
||||
|
||||
|
||||
.SH LIMITATIONS
|
||||
The windows TWAIN driver has many more options than this SANE
|
||||
backend. However they are only software adjustments. This backend only
|
||||
implements what the scanner can support.
|
||||
|
||||
|
||||
.SH BUGS
|
||||
|
||||
None known.
|
||||
|
||||
|
||||
.SH "SEE ALSO"
|
||||
|
||||
sane\-scsi(5), scanimage(1), xscanimage(1), xsane(1), sane(7)
|
||||
|
||||
|
||||
.SH AUTHOR
|
||||
|
||||
The package is actively maintained by Frank Zago.
|
||||
http://fz.eryx.net/sane/#teco
|
||||
|
|
@ -0,0 +1,162 @@
|
|||
|
||||
BACKEND TECO1
|
||||
|
||||
|
||||
|
||||
Relisys RELI 2412 (no ADF, no transparency adapter)
|
||||
single pass scanner - 300*1200 dpi - 8.5*14
|
||||
Inquiry:
|
||||
000: 06 00 02 02 30 00 00 10 52 45 4c 49 53 59 53 20 ....0...RELISYS
|
||||
016: 56 4d 33 35 33 30 2b 20 20 20 20 20 20 20 20 20 VM3530+
|
||||
032: 31 2e 30 38 31 2e 30 38 02 00 54 45 43 4f 20 56 1.081.08..TECO V
|
||||
048: 4d 33 35 33 41 M353A
|
||||
Inquiry page 0x82
|
||||
000: 06 82 00 12 11 54 45 43 4f 20 56 4d 33 35 33 41 .....TECO VM353A
|
||||
016: 20 56 31 2e 30 36 V1.06
|
||||
|
||||
Avec Color Office 2400 (no ADF, no transparency adapter)
|
||||
three pass scanner - 300*600 dpi - 8.5*14
|
||||
Inquiry:
|
||||
000: 06 00 02 02 30 00 00 10 20 20 20 20 20 20 20 20 ....0...
|
||||
016: 49 6d 61 67 65 20 53 63 61 6e 6e 65 72 20 20 20 Image Scanner
|
||||
032: 32 2e 30 34 32 2e 30 34 02 00 54 45 43 4f 20 56 2.042.04..TECO V
|
||||
048: 4d 33 35 32 30 M3520
|
||||
Inquiry page 0x82
|
||||
000: 06 82 00 12 11 54 45 43 4f 20 56 4d 33 35 32 30 .....TECO VM3520
|
||||
016: 20 56 32 2e 30 34 V2.04
|
||||
|
||||
|
||||
/*--------------------------------------------------------------------------*/
|
||||
|
||||
SCSI commands supported by the RELISYS VM3530+:
|
||||
|
||||
TEST UNIT READY
|
||||
00 00 00 00 00 00
|
||||
|
||||
REQ SENSE
|
||||
03 00 00 00 12 00
|
||||
|
||||
VENDOR-09
|
||||
09 00 00 78 00 00
|
||||
3-4 = length of data to receive. Always 30720 bytes.
|
||||
Probably 12 lines of calibration at 300dpi.
|
||||
8.5*300*12=30600
|
||||
|
||||
VENDOR-0E (?)
|
||||
0E 00 00 00 00 00
|
||||
Always follows VENDOR-09 command
|
||||
|
||||
INQUIRY:
|
||||
12 00 00 00 35 00
|
||||
12 01 82 00 21 00
|
||||
standard inquiry
|
||||
52 bytes - appears to never change
|
||||
32-39: firmware version
|
||||
42-52: real scanner name
|
||||
|
||||
page 0x82 (vendor specific) - real scanner name with version
|
||||
0-3 = page header
|
||||
4 = string length
|
||||
5-21 = real scanner name with version
|
||||
|
||||
MODE SELECT
|
||||
15 10 00 00 18 00
|
||||
always sends:
|
||||
00 00 00 00 00 00 00 08 00 00 00 00 00 00 00 01
|
||||
03 06 02 00 00 01 00 00
|
||||
|
||||
|
||||
SCAN
|
||||
1B 00 00 00 00 00
|
||||
|
||||
SET WINDOW
|
||||
24 00 00 00 00 00 00 00 63 00
|
||||
Total length is 99
|
||||
07 = length (99-8 = 91)
|
||||
10-11 = X Resolution
|
||||
12-13 = Y resolution
|
||||
14-17 = X top left corner
|
||||
18-21 = Y top left corner
|
||||
22-25 = width (size in inches * 300)
|
||||
26-29 = length (size in inches * 300)
|
||||
31 = 0x80 ?
|
||||
33 = scan mode
|
||||
0x00 = black & white
|
||||
0x02 = grayscale
|
||||
0x05 = color
|
||||
34 = bit depth? - invariants, always 8
|
||||
36 = dither pattern - only for B&W
|
||||
0x00 = line art
|
||||
0x01 = 2 X 2
|
||||
0x02 = 3 X 3
|
||||
0x03 = 4 X 4 Bayer
|
||||
0x04 = 4 X 4 Smooth
|
||||
0x05 = 8 X 8 Bayer
|
||||
0x06 = 8 X 8 Smooth
|
||||
0x07 = 8 X 8 Horizontal
|
||||
0x08 = 8 X 8 Vertical
|
||||
37 =
|
||||
0x80 = RIF (VM353A only?)
|
||||
63 = calibration?
|
||||
0x00 yes
|
||||
0x02 no
|
||||
93 =
|
||||
0x80 = ? (seems to activate a contrast value on VM353A)
|
||||
|
||||
37, 55, 57, 59, 61, 65, 67, 69, 71, 73, 75, 77, 79 = 0x80
|
||||
85, 89, 93, 97 = 0xff
|
||||
|
||||
READ
|
||||
28 00 00 00 00 00 00 00 3E 00
|
||||
6-8 = length
|
||||
|
||||
SEND
|
||||
2A 00 03 00 00 02 00 04 00 00
|
||||
2 = data type code
|
||||
0x03 = gamma - 4*256 bytes
|
||||
|
||||
GET DATA BUFFER STATUS
|
||||
34 01 00 00 00 00 00 00 12 00
|
||||
1 = bit 1 is wait
|
||||
7-8 allocation length
|
||||
|
||||
returned buffer is 0x10 bytes long.
|
||||
0-2 = additional length (0x10-3 = 0x0D)
|
||||
3 = reserved(?)
|
||||
8 = ?
|
||||
9-11 = filled data buffer
|
||||
12-13 = number of lines (constant during a scan)
|
||||
14-15 = bytes per line (constant during a scan)
|
||||
|
||||
|
||||
/*--------------------------------------------------------------------------*/
|
||||
|
||||
Command sequence
|
||||
(simplified, since the TWAIN driver seems to be quite stupid)
|
||||
|
||||
Get some info:
|
||||
INQUIRY
|
||||
INQUIRY page 0x82
|
||||
|
||||
Setup the scan:
|
||||
TUR
|
||||
MODE SELECT
|
||||
SET WINDOWS
|
||||
GET BUFFER STATUS
|
||||
VENDOR-09
|
||||
VENDOR-0E
|
||||
SEND(10)
|
||||
SET WINDOWS (same as the first one)
|
||||
SCAN
|
||||
|
||||
loop until all data read:
|
||||
GET BUFFER STATUS
|
||||
READ(10) if any data available
|
||||
|
||||
park the CCD:
|
||||
SET WINDOWS
|
||||
SCAN
|
||||
|
||||
/*--------------------------------------------------------------------------*/
|
||||
|
||||
The vendor specific command 0x09 and 0x0e are issued by the windows driver to the AVEC 2400, but the scanner rejects them.
|
||||
Ładowanie…
Reference in New Issue