2019-02-20 18:12:55 +00:00
|
|
|
.TH "sane\-pixma" "5" "20 Feb 2019" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
2008-07-14 10:49:06 +00:00
|
|
|
.IX sane\-pixma
|
2006-05-26 07:49:24 +00:00
|
|
|
.SH NAME
|
2013-05-29 08:18:06 +00:00
|
|
|
sane\-pixma \- SANE backend for Canon Multi-Function Printers and CanoScan Scanners
|
2006-05-26 07:49:24 +00:00
|
|
|
.SH DESCRIPTION
|
|
|
|
The
|
2008-07-14 10:49:06 +00:00
|
|
|
.B sane\-pixma
|
2006-05-26 07:49:24 +00:00
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that provides
|
2013-05-29 08:18:06 +00:00
|
|
|
access to Canon PIXMA / i-SENSYS / imageCLASS / imageRUNNER multi-function
|
2013-05-29 08:23:59 +00:00
|
|
|
devices (All-in-one printers) and the Canon CanoScan Flatbed/TPU scanners.
|
2017-05-27 05:27:22 +00:00
|
|
|
The backend implements both the USB interface and network interface
|
|
|
|
(using Canon's BJNP and MFNP protocols). The network interface supports scanners
|
2014-02-10 22:55:05 +00:00
|
|
|
over IPv4 as well as IPv6 (MFNP over IPv6 is untested).
|
2013-01-10 20:10:41 +00:00
|
|
|
.PP
|
2006-05-26 07:49:24 +00:00
|
|
|
Currently, the following models work with this backend:
|
|
|
|
.PP
|
|
|
|
.RS
|
2018-10-24 18:24:00 +00:00
|
|
|
PIXMA E510
|
|
|
|
.br
|
2015-02-06 19:30:47 +00:00
|
|
|
PIXMA MG2100, MG2200, MG2400, MG2500, MG2900, MG3100, MG3200
|
2013-04-18 09:06:26 +00:00
|
|
|
.br
|
2017-04-04 09:16:20 +00:00
|
|
|
PIXMA MG3500, MG3600, MG4200, MG5100, MG5200, MG5300, MG5400
|
2014-10-27 16:13:14 +00:00
|
|
|
.br
|
2017-04-04 09:16:20 +00:00
|
|
|
PIXMA MG5500, MG5600, MG5700, MG6100, MG6200, MG6300, MG6400
|
2016-01-08 17:34:27 +00:00
|
|
|
.br
|
2017-04-04 09:16:20 +00:00
|
|
|
PIXMA MG7100, MG7500, MG7700, MG8200
|
2012-08-27 13:40:21 +00:00
|
|
|
.br
|
2009-04-21 08:22:20 +00:00
|
|
|
PIXMA MP140, MP150, MP160, MP170, MP180, MP190
|
2006-06-03 00:39:09 +00:00
|
|
|
.br
|
2013-03-21 18:10:03 +00:00
|
|
|
PIXMA MP210, MP220, MP230, MP240, MP250, MP260, MP270, MP280
|
2009-04-21 08:22:20 +00:00
|
|
|
.br
|
2010-09-08 20:08:32 +00:00
|
|
|
PIXMA MP360, MP370, MP390
|
2010-09-02 16:18:53 +00:00
|
|
|
.br
|
2010-01-08 20:09:22 +00:00
|
|
|
PIXMA MP450, MP460, MP470, MP480, MP490
|
2009-04-21 08:22:20 +00:00
|
|
|
.br
|
2010-01-08 20:09:22 +00:00
|
|
|
PIXMA MP500, MP510, MP520, MP530, MP540, MP550, MP560
|
2007-07-19 22:17:21 +00:00
|
|
|
.br
|
2012-07-31 11:19:37 +00:00
|
|
|
PIXMA MP600, MP600R, MP610, MP620, MP630, MP640
|
|
|
|
.br
|
|
|
|
PIXMA MP700, MP710, MP730, PIXMA MP750 (no grayscale)
|
|
|
|
.br
|
|
|
|
PIXMA MP800, MP800R, MP810, MP830
|
|
|
|
.br
|
|
|
|
PIXMA MP960, MP970, MP980, MP990
|
2008-03-16 16:33:53 +00:00
|
|
|
.br
|
2012-08-26 17:36:07 +00:00
|
|
|
PIXMA MX300, MX310, MX330, MX340, MX350, MX360, MX370
|
2008-04-15 21:27:34 +00:00
|
|
|
.br
|
2015-07-24 07:38:41 +00:00
|
|
|
PIXMA MX410, MX420, MX470, MX510, MX520, MX530, MX700, MX720
|
2010-07-22 05:56:13 +00:00
|
|
|
.br
|
2015-07-24 07:38:41 +00:00
|
|
|
PIXMA MX850, MX860, MX870, MX882, MX885, MX890, MX920, MX7600
|
2012-01-23 10:21:02 +00:00
|
|
|
.br
|
2015-10-14 17:02:43 +00:00
|
|
|
PIXUS MP10
|
|
|
|
.br
|
2018-10-12 10:33:46 +00:00
|
|
|
PIXMA TS3100, TS5000, TS6100, TS8000
|
2017-07-10 21:34:01 +00:00
|
|
|
.br
|
2013-05-29 08:23:59 +00:00
|
|
|
imageCLASS MF3110, MF3240, MF4010, MF4018
|
2006-06-03 00:39:09 +00:00
|
|
|
.br
|
2013-05-29 08:23:59 +00:00
|
|
|
imageCLASS MF4120, MF4122, MF4140, MF4150
|
2008-04-21 19:24:07 +00:00
|
|
|
.br
|
2013-05-29 08:23:59 +00:00
|
|
|
imageCLASS MF4270, MF4350d, MF4370dn, MF4380dn
|
2009-04-21 08:22:20 +00:00
|
|
|
.br
|
2014-01-02 19:54:25 +00:00
|
|
|
imageCLASS MF4410, MF4430, MF4570dw, MF4660, MF4690
|
2009-10-18 13:04:39 +00:00
|
|
|
.br
|
2015-10-14 17:02:43 +00:00
|
|
|
imageCLASS MF5730, MF5770, MF6550, MPC200, D420, D480, D530
|
2009-10-21 19:39:27 +00:00
|
|
|
.br
|
2018-09-22 10:54:05 +00:00
|
|
|
i-SENSYS MF210, MF230, MF240, MF620, MF730, MF3010, MF4320d
|
2013-12-27 10:33:44 +00:00
|
|
|
.br
|
2018-10-28 11:11:49 +00:00
|
|
|
i-SENSYS MF4330d, MF4500, MF4700, MF4800, MF6100, MF8030
|
2018-09-22 10:54:05 +00:00
|
|
|
.br
|
2018-10-28 11:11:49 +00:00
|
|
|
i-SENSYS MF8200C, MF8300
|
2015-05-18 20:49:58 +00:00
|
|
|
.br
|
2013-05-29 08:23:59 +00:00
|
|
|
imageRUNNER 1020/1024/1025
|
2012-09-03 08:41:37 +00:00
|
|
|
.br
|
2013-06-10 19:23:19 +00:00
|
|
|
CanoScan 8800F, 9000F, 9000F Mark II
|
2016-04-22 21:58:23 +00:00
|
|
|
.br
|
2019-02-20 18:12:55 +00:00
|
|
|
CanoScan LiDE 300, 400
|
2019-02-20 17:44:44 +00:00
|
|
|
.br
|
2018-05-12 18:55:16 +00:00
|
|
|
MAXIFY MB2000, MB2100, MB2300, MB2700, MB5000
|
2006-06-10 10:50:43 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2007-04-09 20:41:25 +00:00
|
|
|
The following models are not well tested and/or the scanner sometimes hangs
|
|
|
|
and must be switched off and on.
|
2006-05-26 07:49:24 +00:00
|
|
|
.PP
|
|
|
|
.RS
|
2012-07-31 11:19:37 +00:00
|
|
|
PIXMA MP760, MP770, MP780, MP790
|
2006-05-26 07:49:24 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2017-05-27 05:27:22 +00:00
|
|
|
The following models may use the same Pixma protocol as those listed
|
|
|
|
above, but have not yet been reported to work (or not). They are declared
|
|
|
|
in the backend so that they get recognized and activated.
|
2012-07-28 11:59:17 +00:00
|
|
|
Feedback in the sane\-devel mailing list welcome.
|
2008-02-17 15:49:43 +00:00
|
|
|
.PP
|
|
|
|
.RS
|
2018-10-24 18:24:00 +00:00
|
|
|
PIXMA E400, E410, E460, E470, E480, E500, E560, E600
|
2017-09-01 10:15:10 +00:00
|
|
|
.br
|
|
|
|
PIXMA E610, E3100
|
2012-08-26 17:36:07 +00:00
|
|
|
.br
|
2017-04-04 09:16:20 +00:00
|
|
|
PIXMA MG3000, MG4100, MG6500, MG6600, MG6800, MG6900, MG8100
|
2012-07-31 11:19:37 +00:00
|
|
|
.br
|
|
|
|
PIXMA MP375R, MP493, MP495, MP740
|
2008-10-14 19:48:59 +00:00
|
|
|
.br
|
2015-07-24 07:38:41 +00:00
|
|
|
PIXMA MX320, MX390, MX430, MX450, MX490, MX710
|
2008-04-21 19:24:07 +00:00
|
|
|
.br
|
2017-09-01 10:15:10 +00:00
|
|
|
PIXMA G2000, G3000, G4000
|
2017-04-04 09:59:56 +00:00
|
|
|
.br
|
2018-12-20 11:56:47 +00:00
|
|
|
PIXMA TR7500, TR8500, TS5100, TS6000, TS9000, TS9100, TS9500
|
2017-04-04 09:59:56 +00:00
|
|
|
.br
|
2015-10-14 17:02:43 +00:00
|
|
|
PIXUS MP5
|
|
|
|
.br
|
2018-10-28 11:11:49 +00:00
|
|
|
imageCLASS MF810/820, MF5630, MF5650, MF5750, MF8170c
|
2013-09-13 12:06:38 +00:00
|
|
|
.br
|
2019-01-01 13:13:58 +00:00
|
|
|
imageCLASS MPC190, D550, D570
|
2015-10-14 17:02:43 +00:00
|
|
|
.br
|
2013-09-13 12:06:38 +00:00
|
|
|
imageRUNNER 1133
|
2013-01-14 14:25:45 +00:00
|
|
|
.br
|
2018-10-28 11:11:49 +00:00
|
|
|
i-SENSYS MF220, MF410, MF630, MF731/733, MF5880dn, MF5900
|
2018-01-03 20:00:51 +00:00
|
|
|
.br
|
2018-10-28 11:11:49 +00:00
|
|
|
i-SENSYS MF6680dn, MF8500C
|
2014-10-29 08:14:50 +00:00
|
|
|
.br
|
2018-10-08 19:24:51 +00:00
|
|
|
MAXIFY MB5100, MB5300, MB5400
|
2008-04-02 20:13:48 +00:00
|
|
|
.RE
|
|
|
|
.PP
|
2012-08-26 17:36:07 +00:00
|
|
|
\#The following models may use partly the same Pixma protocol as other devices
|
2017-05-27 05:27:22 +00:00
|
|
|
\#listed above, but may still need some work. They are declared in the backend
|
|
|
|
\#as experimental. Snoop logs are required to further investigate, please contact
|
2012-08-26 17:36:07 +00:00
|
|
|
\#the sane\-devel mailing list.
|
|
|
|
\#.PP
|
|
|
|
\#.RS
|
|
|
|
\#PIXMA MP---
|
|
|
|
\#.RE
|
|
|
|
\#.PP
|
2009-12-26 13:40:39 +00:00
|
|
|
The backend supports:
|
2008-02-22 21:42:30 +00:00
|
|
|
.PP
|
2009-12-26 13:40:39 +00:00
|
|
|
.RS
|
2012-01-15 02:48:19 +00:00
|
|
|
* resolutions of 75, 150, 300, 600, 1200, 2400, 4800, and 9600 DPI (some maybe buggy),
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2010-09-02 16:18:53 +00:00
|
|
|
* color and grayscale mode, as well as lineart on certain models,
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2008-10-14 19:48:59 +00:00
|
|
|
* a custom gamma table,
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2009-12-26 13:40:39 +00:00
|
|
|
* Automatic Document Feeder, Simplex and Duplex.
|
2008-10-05 20:42:19 +00:00
|
|
|
.br
|
2013-02-18 17:53:06 +00:00
|
|
|
* Transparency Unit, 24 or 48 bits depth. Infrared channel on certain models.
|
2009-12-26 13:40:39 +00:00
|
|
|
.RE
|
2006-05-26 07:49:24 +00:00
|
|
|
.PP
|
2009-10-22 14:05:22 +00:00
|
|
|
The device name for USB devices is in the form pixma:xxxxyyyy_zzzzz
|
2006-05-26 07:49:24 +00:00
|
|
|
where x, y and z are vendor ID, product ID and serial number respectively.
|
2017-05-27 05:27:22 +00:00
|
|
|
.PP
|
2006-05-26 07:49:24 +00:00
|
|
|
Example: pixma:04A91709_123456 is a MP150.
|
|
|
|
.PP
|
2014-02-10 22:55:05 +00:00
|
|
|
Device names for BJNP/MFNP devices is in the form pixma:aaaa_bbbbb
|
2009-10-22 14:05:22 +00:00
|
|
|
where aaaa is the scanners model and bbbb is the hostname or ip-adress.
|
|
|
|
.PP
|
2014-02-10 22:55:05 +00:00
|
|
|
Example: pixma:MF4800_192.168.1.45 is a MF4800 Series multi-function peripheral.
|
|
|
|
.PP
|
2017-05-27 05:27:22 +00:00
|
|
|
This backend, based on cloning original Canon drivers protocols, is in
|
2008-05-29 20:01:56 +00:00
|
|
|
a production stage. Designed has been carried out without any applicable
|
2017-05-27 05:27:22 +00:00
|
|
|
manufacturer documentation, probably never available. However, we have tested
|
|
|
|
it as well as we could, but it may not work in all situations. You will find
|
|
|
|
an up-to-date status at the project homepage. (See below).
|
|
|
|
Users feedback is essential to help improve features and performances.
|
2006-06-08 17:50:14 +00:00
|
|
|
.SH OPTIONS
|
|
|
|
Besides "well-known" options (e.g. resolution, mode etc.) pixma backend also
|
2017-04-04 09:23:03 +00:00
|
|
|
provides the following options, i.e. the options might change in the future.
|
2009-04-05 19:49:41 +00:00
|
|
|
.br
|
2014-03-02 18:17:07 +00:00
|
|
|
The button status can be polled i.e. with 'scanimage \-A'.
|
2013-01-18 11:14:19 +00:00
|
|
|
.br
|
2009-04-05 19:49:41 +00:00
|
|
|
Button scan is disabled on MAC OS X due to darwin libusb not handling
|
2014-02-10 22:55:05 +00:00
|
|
|
timeouts in usb interrupt reads, but may work when using the network protocol.
|
2006-06-08 17:50:14 +00:00
|
|
|
.TP
|
2017-04-04 09:23:03 +00:00
|
|
|
.I adf\-wait
|
|
|
|
This option enables and sets the time in seconds waiting for a document
|
|
|
|
inserted into the
|
|
|
|
.BR Automatic
|
|
|
|
.BR Document
|
|
|
|
.BR Feeder .
|
|
|
|
The maximum allowed waiting time is 3600 sec (= 1 hour).
|
|
|
|
.TP
|
2008-07-14 10:49:06 +00:00
|
|
|
.I button\-controlled
|
2013-01-10 20:10:41 +00:00
|
|
|
This option can be used by applications (like
|
2006-06-08 17:50:14 +00:00
|
|
|
.BR scanadf (1)
|
|
|
|
and
|
2013-01-10 20:10:41 +00:00
|
|
|
.BR scanimage (1))
|
2006-06-08 17:50:14 +00:00
|
|
|
in batch mode, for example when you want to scan many photos or
|
|
|
|
multiple-page documents. If it is enabled (i.e. is set to true or yes), the
|
|
|
|
backend waits before every scan until the user presses the "SCAN" button
|
|
|
|
(for MP150) or the color-scan button (for other models). Just put the
|
|
|
|
first page in the scanner, press the button, then the next page, press
|
|
|
|
the button and so on. When you finished, press the gray-scan button. (For
|
|
|
|
MP150 you have to stop the frontend by pressing Ctrl-C for example.)
|
|
|
|
.TP
|
2014-02-10 22:55:05 +00:00
|
|
|
.I button\-update (deprecated)
|
2017-05-27 05:27:22 +00:00
|
|
|
(write only) In the past this option was required to be set to force
|
2013-01-10 20:10:41 +00:00
|
|
|
reading of the button status for
|
2008-07-14 10:49:06 +00:00
|
|
|
.I button\-1
|
2006-06-08 17:50:14 +00:00
|
|
|
and
|
2013-01-10 20:10:41 +00:00
|
|
|
.I button\-2.
|
2017-05-27 05:27:22 +00:00
|
|
|
The
|
2013-01-10 20:10:41 +00:00
|
|
|
.B sane\-pixma
|
2017-05-27 05:27:22 +00:00
|
|
|
no longer requires this option to be used: if no fresh data is available, it
|
|
|
|
will be now requested automatically from the scanner. This option is left for
|
2013-01-10 20:10:41 +00:00
|
|
|
backward compatibility reasons.
|
|
|
|
.TP
|
|
|
|
.I button\-1 button\-2
|
|
|
|
(read only) These options will return the value of the respective buttons.
|
2017-05-27 05:27:22 +00:00
|
|
|
value 0 means that the button was not pressed, 1 is returned when the button
|
2013-01-18 11:14:19 +00:00
|
|
|
was pressed. Some scanners with more than two buttons send the button number
|
|
|
|
as target.
|
2013-01-10 20:10:41 +00:00
|
|
|
.TP
|
|
|
|
.I original
|
2013-07-18 20:45:45 +00:00
|
|
|
(read only) Returns the value of the type or size of original to be scanned
|
|
|
|
if the scanner provides that data. Known values of type: 1 = document, 2 = foto,
|
|
|
|
5 = film. Known values of size: 1 = A4, 2 = Letter, 8 = 10x15, 9 = 13x18, b = auto.
|
2013-01-10 20:10:41 +00:00
|
|
|
Not all scanners can provide this data.
|
|
|
|
.TP
|
|
|
|
.I target
|
2013-07-18 20:45:45 +00:00
|
|
|
(read only) Returns the value of the target of the scan operation if the scanner
|
|
|
|
provides that data. The values depend on the scanner type. Known values:
|
|
|
|
1 = save to disk, 2 = save to pdf, 3 = send to email, 4 = send to application
|
|
|
|
or 1 = JPEG, 2 = TIFF, 3 = PDF, 4 = Compact PDF. For some scanners this value
|
|
|
|
is equivalent to the number of the pressed button. Not all scanners can provide
|
|
|
|
this data.
|
|
|
|
.TP
|
|
|
|
.I scan-resolution
|
|
|
|
(read only) Returns the resolution of the scan operation if the scanner
|
|
|
|
provides that data. Known values: 1 = 75 dpi, 2 = 150 dpi, 3 = 300 dpi,
|
|
|
|
4 = 600 dpi. Not all scanners can provide this data.
|
2006-05-26 07:49:24 +00:00
|
|
|
.SH FILES
|
|
|
|
.TP
|
2008-07-14 10:49:06 +00:00
|
|
|
.I @LIBDIR@/libsane\-pixma.a
|
2006-05-26 07:49:24 +00:00
|
|
|
The static library implementing this backend.
|
|
|
|
.TP
|
2008-07-14 10:49:06 +00:00
|
|
|
.I @LIBDIR@/libsane\-pixma.so
|
2006-05-26 07:49:24 +00:00
|
|
|
The shared library implementing this backend (present on systems that
|
|
|
|
support dynamic loading).
|
2009-10-22 14:05:22 +00:00
|
|
|
.TP
|
|
|
|
.I @CONFIGDIR@/pixma.conf
|
|
|
|
The backend configuration file (see also description of
|
|
|
|
.B SANE_CONFIG_DIR
|
2017-05-27 05:27:22 +00:00
|
|
|
below). The file contains an optional list of networked scanners. Normally
|
|
|
|
only scanners that cannot be auto-detected because they are on a different
|
|
|
|
subnet shall be listed here. If your OS does not allow enumeration of
|
|
|
|
interfaces (i.e. it does not support the getifaddrs() function) you also may need
|
2014-02-10 22:55:05 +00:00
|
|
|
to add your scanner here as well.
|
2017-01-06 21:15:24 +00:00
|
|
|
.RS
|
2014-02-10 22:55:05 +00:00
|
|
|
.PP
|
2017-11-14 21:16:40 +00:00
|
|
|
.I Scanners shall be listed in the configuration file as follows:
|
2009-10-22 14:05:22 +00:00
|
|
|
.PP
|
|
|
|
.RS
|
2017-01-06 21:15:24 +00:00
|
|
|
.I <method>://<host>[:port][/timeout=<value>]
|
2009-10-22 14:05:22 +00:00
|
|
|
.RE
|
2014-02-10 22:55:05 +00:00
|
|
|
.PP
|
|
|
|
where method indicates the protocol used (bjnp is used for inkjet multi-functionals
|
2017-05-27 05:27:22 +00:00
|
|
|
and mfnp is used for laser multi-functionals).
|
2014-02-10 22:55:05 +00:00
|
|
|
.PP
|
2017-05-27 05:27:22 +00:00
|
|
|
host is the hostname or IP address of the scanner, e.g. bjnp://10.0.1.4
|
|
|
|
for IPv4, bjnp://[2001:888:118e:18e2:21e:8fff:fe36:b64a] for a literal
|
2014-02-10 22:55:05 +00:00
|
|
|
IPv6-address or bjnp://myscanner.mydomain.org for a hostname.
|
|
|
|
.PP
|
|
|
|
The port number is optional and in normally implied by the method.
|
|
|
|
Port 8610 is the standard port for mfnp, 8612 for bjnp.
|
|
|
|
.PP
|
2017-05-27 05:27:22 +00:00
|
|
|
A scanner specific timeout value for the network protocol can be set using the
|
2017-01-06 21:15:24 +00:00
|
|
|
bjnp-timeout parameter. The value is in ms.
|
|
|
|
.PP
|
|
|
|
Define scanners each on a new line.
|
|
|
|
.PP
|
2017-11-14 21:16:40 +00:00
|
|
|
More globally applicable timeouts can be set using the bjnp-timeout parameter as follows:
|
2017-01-06 21:15:24 +00:00
|
|
|
.PP
|
|
|
|
.RS
|
|
|
|
.I bjnp-timeout=<value>
|
|
|
|
.RE
|
|
|
|
.PP
|
|
|
|
A timeout defined using bjnp-timeout will apply to the following scanner definitions
|
2017-05-27 05:27:22 +00:00
|
|
|
in the file. If required the bjnp-timeout setting
|
2017-01-06 21:15:24 +00:00
|
|
|
can be defined multiple times, where each settng will apply only to the scanners that
|
|
|
|
follow the setting. The last setting is used for the auto discovered scanners.
|
2017-11-14 21:16:40 +00:00
|
|
|
If not explicitly set, the default 1000ms setting will apply.
|
2017-01-06 21:15:24 +00:00
|
|
|
.PP
|
|
|
|
Setting timeouts should only be required in exceptional cases.
|
|
|
|
.PP
|
2009-10-22 14:05:22 +00:00
|
|
|
.SH USB SUPPORT
|
|
|
|
USB scanners will be auto-detected and require no configuration.
|
|
|
|
.SH NETWORKING SUPPORT
|
2017-05-27 05:27:22 +00:00
|
|
|
The pixma backend supports network scanners using the so called Canon BJNP
|
2014-02-10 22:55:05 +00:00
|
|
|
protocol and MFNP protocol. Both IPv4 and IPv6 are supported, but IPv6 is as
|
|
|
|
yet untested with MFNP. Please report your results on the mailing list.
|
2013-01-10 20:10:41 +00:00
|
|
|
.PP
|
2009-10-22 14:05:22 +00:00
|
|
|
Configuration is normally not required.
|
|
|
|
The pixma backend will auto-detect your scanner if it is within
|
|
|
|
the same subnet as your computer if your OS does support this.
|
2013-01-10 20:10:41 +00:00
|
|
|
.PP
|
2017-05-27 05:27:22 +00:00
|
|
|
If your scanner can not be auto-detected, you can add it to the pixma
|
2013-01-10 20:10:41 +00:00
|
|
|
configuration file (see above).
|
2009-10-22 14:05:22 +00:00
|
|
|
.SH FIREWALLING FOR NETWORKED SCANNERS
|
2017-05-27 05:27:22 +00:00
|
|
|
The sane pixma backend communicates with port 8610 for MFNP or port 8612
|
2014-02-10 22:55:05 +00:00
|
|
|
for BJNP on the scanner. So
|
2017-05-27 05:27:22 +00:00
|
|
|
you will have to allow outgoing traffic TO port 8610 or 8612 on the
|
2014-02-10 22:55:05 +00:00
|
|
|
common subnet for scanning.
|
2013-01-10 20:10:41 +00:00
|
|
|
.PP
|
2009-10-22 14:05:22 +00:00
|
|
|
Scanner detection is slightly more complicated. The pixma backend sends
|
2017-05-27 05:27:22 +00:00
|
|
|
a broadcast on all direct connected subnets it can find (provided your OS
|
|
|
|
allows for enumeration of all netowrk interfaces). The broadcast is sent FROM
|
2014-02-10 22:55:05 +00:00
|
|
|
port 8612 TO port 8610 or 8612 on the broadcast address of each interface.
|
2009-10-22 14:05:22 +00:00
|
|
|
The outgoing packets will be allowed by the rule described above.
|
2013-01-10 20:10:41 +00:00
|
|
|
.PP
|
2009-10-22 14:05:22 +00:00
|
|
|
Responses from the scanner are sent back to the computer TO port 8612.
|
|
|
|
Connection tracking however does not see a match as the response does not come
|
|
|
|
from the broadcast address but from the scanners own address.
|
2017-05-27 05:27:22 +00:00
|
|
|
For automatic detection of your scanner, you will therefore have to allow
|
2014-02-10 22:55:05 +00:00
|
|
|
incoming packets TO port 8612 on your computer. This applies to both MFNP and
|
|
|
|
BJNP.
|
2013-01-10 20:10:41 +00:00
|
|
|
.PP
|
2017-05-27 05:27:22 +00:00
|
|
|
So in short: open the firewall for all traffic from your computer to port
|
2014-02-10 22:55:05 +00:00
|
|
|
8610 (for MFNP) or 8612 (for BJNP)
|
|
|
|
AND to port 8612 (for both BJNP and MFNP) to your computer.
|
2013-01-10 20:10:41 +00:00
|
|
|
.PP
|
2009-10-22 14:05:22 +00:00
|
|
|
With the firewall rules above there is no need to add the scanner to the
|
|
|
|
pixma.conf file, unless the scanner is on a network that is not directly
|
|
|
|
connected to your computer.
|
2006-05-26 07:49:24 +00:00
|
|
|
.SH ENVIRONMENT
|
|
|
|
.TP
|
|
|
|
.B SANE_DEBUG_PIXMA
|
|
|
|
If the library was compiled with debug support enabled, this environment
|
2013-01-10 20:10:41 +00:00
|
|
|
variable controls the debug level for this backend itself. Higher value increases
|
|
|
|
the verbosity and includes the information printed at the lower levels.
|
2006-05-26 07:49:24 +00:00
|
|
|
.RS
|
2006-08-27 12:44:35 +00:00
|
|
|
0 print nothing (default)
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2006-06-03 00:39:09 +00:00
|
|
|
1 print error and warning messages (recommended)
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2006-06-08 17:50:14 +00:00
|
|
|
2 print informational messages
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2006-06-08 17:50:14 +00:00
|
|
|
3 print debug-level messages
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2014-08-16 10:21:27 +00:00
|
|
|
4 print verbose debug-level messages
|
|
|
|
.br
|
2013-01-10 20:10:41 +00:00
|
|
|
11 dump USB traffic
|
|
|
|
.br
|
|
|
|
21 full dump USB traffic
|
|
|
|
.br
|
|
|
|
.RE
|
|
|
|
.TP
|
|
|
|
.B SANE_DEBUG_BJNP
|
|
|
|
If the library was compiled with debug support enabled, this environment
|
2017-05-27 05:27:22 +00:00
|
|
|
variable controls the debug level for the
|
2014-02-10 22:55:05 +00:00
|
|
|
.B BJNP and MFNP
|
|
|
|
network protocols for this backend. Higher value increases
|
2013-01-10 20:10:41 +00:00
|
|
|
the verbosity and includes the information printed at the lower levels.
|
|
|
|
.RS
|
|
|
|
0 print nothing (default)
|
|
|
|
.br
|
|
|
|
1 Print error and warning messages (recommended)
|
|
|
|
.br
|
|
|
|
2 Print high level function tracing information
|
2017-05-27 05:27:22 +00:00
|
|
|
.br
|
2013-01-10 20:10:41 +00:00
|
|
|
3 Print more detailed protocol tracing information
|
2006-05-26 07:49:24 +00:00
|
|
|
.br
|
2013-01-10 20:10:41 +00:00
|
|
|
4 Print protocol headers
|
2008-02-24 09:25:38 +00:00
|
|
|
.br
|
2013-01-10 20:10:41 +00:00
|
|
|
5 Print full protocol contents
|
2006-05-26 07:49:24 +00:00
|
|
|
.RE
|
|
|
|
.TP
|
|
|
|
.B PIXMA_EXPERIMENT
|
|
|
|
Setting to a non-zero value will enable the support for experimental models.
|
2009-10-21 19:39:27 +00:00
|
|
|
You should also set SANE_DEBUG_PIXMA to 11.
|
2009-10-22 14:05:22 +00:00
|
|
|
.TP
|
|
|
|
.B SANE_CONFIG_DIR
|
|
|
|
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 @CONFIGDIR@. If the value of the
|
|
|
|
environment variable ends with the directory separator character, then
|
|
|
|
the default directories are searched after the explicitly specified
|
|
|
|
directories. For example, setting
|
|
|
|
.B SANE_CONFIG_DIR
|
|
|
|
to "/tmp/config:" would result in directories "tmp/config", ".", and
|
|
|
|
"@CONFIGDIR@" being searched (in this order).
|
2006-05-26 07:49:24 +00:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR sane (7),
|
2008-07-14 10:49:06 +00:00
|
|
|
.BR sane\-dll (5),
|
2009-12-26 13:40:39 +00:00
|
|
|
.PP
|
2017-05-27 05:27:22 +00:00
|
|
|
In case of trouble with a recent Pixma model, try the latest code for
|
2009-12-26 13:40:39 +00:00
|
|
|
the pixma backend, available in the Sane git repository at:
|
|
|
|
.br
|
2018-02-09 09:37:21 +00:00
|
|
|
.I https://gitlab.com/sane-project/backends.git
|
2009-12-26 13:40:39 +00:00
|
|
|
.PP
|
|
|
|
You can also post into the Sane-devel mailing list for support.
|
2009-10-22 14:05:22 +00:00
|
|
|
|
2008-05-29 20:01:56 +00:00
|
|
|
.SH AUTHORS
|
2012-01-18 07:58:52 +00:00
|
|
|
Wittawat Yamwong, Nicolas Martin, Dennis Lou, Louis Lagendijk, Rolf Bensch
|
2006-05-26 07:49:24 +00:00
|
|
|
.PP
|
2008-05-29 20:01:56 +00:00
|
|
|
We would like to thank all testers and helpers. Without them we could not be
|
|
|
|
able to write subdrivers for models we don't have. See also the project
|
2006-06-08 17:50:14 +00:00
|
|
|
homepage.
|