/* -*- linux-c -*- *//*  * Driver for USB Scanners (linux-2.4.12) * * Copyright (C) 1999, 2000, 2001 David E. Nelson * * Portions may be copyright Brad Keryan and Michael Gee. * * David E. Nelson (dnelson@jump.net) *  * This program is free software; you can redistribute it and/or * modify it under the terms of the GNU General Public License as * published by the Free Software Foundation; either version 2 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, but * WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU * General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. * * Originally based upon mouse.c (Brad Keryan) and printer.c (Michael Gee). * * History * *  0.1  8/31/1999 * *    Developed/tested using linux-2.3.15 with minor ohci.c changes to *    support short packes during bulk xfer mode.  Some testing was *    done with ohci-hcd but the performace was low.  Very limited *    testing was performed with uhci but I was unable to get it to *    work.  Initial relase to the linux-usb development effort. * * *  0.2  10/16/1999 * *    - Device can't be opened unless a scanner is plugged into the USB. *    - Finally settled on a reasonable value for the I/O buffer's. *    - Cleaned up write_scanner() *    - Disabled read/write stats *    - A little more code cleanup * * *  0.3  10/18/1999 * *    - Device registration changed to reflect new device *      allocation/registration for linux-2.3.22+. *    - Adopted David Brownell's <david-b@pacbell.net> technique for  *      assigning bulk endpoints. *    - Removed unnessesary #include's *    - Scanner model now reported via syslog INFO after being detected  *      *and* configured. *    - Added user specified vendor:product USB ID's which can be passed  *      as module parameters. * * *  0.3.1 * *    - Applied patches for linux-2.3.25. *    - Error number reporting changed to reflect negative return codes. * * *  0.3.2 * *    - Applied patches for linux-2.3.26 to scanner_init(). *    - Debug read/write stats now report values as signed decimal. * * *  0.3.3 * *    - Updated the bulk_msg() calls to usb usb_bulk_msg(). *    - Added a small delay in the write_scanner() method to aid in *      avoiding NULL data reads on HP scanners.  We'll see how this works. *    - Return values from usb_bulk_msg() now ignore positive values for *      use with the ohci driver. *    - Added conditional debugging instead of commenting/uncommenting *      all over the place. *    - kfree()'d the pointer after using usb_string() as documented in *      linux-usb-api.txt. *    - Added usb_set_configuration().  It got lost in version 0.3 -- ack! *    - Added the HP 5200C USB Vendor/Product ID's. * * *  0.3.4  1/23/2000 * *    - Added Greg K-H's <greg@kroah.com> patch for better handling of  *      Product/Vendor detection. *    - The driver now autoconfigures its endpoints including interrupt *      endpoints if one is detected.  The concept was originally based *      upon David Brownell's method. *    - Added some Seiko/Epson ID's. Thanks to Karl Heinz  *      Kremer <khk@khk.net>. *    - Added some preliminary ioctl() calls for the PV8630 which is used *      by the HP4200. The ioctl()'s still have to be registered. Thanks  *      to Adrian Perez Jorge <adrianpj@easynews.com>. *    - Moved/migrated stuff to scanner.h *    - Removed the usb_set_configuration() since this is handled by *      the usb_new_device() routine in usb.c. *    - Added the HP 3300C.  Thanks to Bruce Tenison. *    - Changed user specified vendor/product id so that root hub doesn't *      get falsely attached to. Thanks to Greg K-H. *    - Added some Mustek ID's. Thanks to Gernot Hoyler  *      <Dr.Hoyler@t-online.de>. *    - Modified the usb_string() reporting.  See kfree() comment above. *    - Added Umax Astra 2000U. Thanks to Doug Alcorn <doug@lathi.net>. *    - Updated the printk()'s to use the info/warn/dbg macros. *    - Updated usb_bulk_msg() argument types to fix gcc warnings. * * *  0.4  2/4/2000 * *    - Removed usb_string() from probe_scanner since the core now does a *      good job of reporting what was connnected.   *    - Finally, simultaneous multiple device attachment! *    - Fixed some potential memory freeing issues should memory allocation *      fail in probe_scanner(); *    - Some fixes to disconnect_scanner(). *    - Added interrupt endpoint support. *    - Added Agfa SnapScan Touch. Thanks to Jan Van den Bergh *      <jan.vandenbergh@cs.kuleuven.ac.be>. *    - Added Umax 1220U ID's. Thanks to Maciek Klimkowski *      <mac@nexus.carleton.ca>. *    - Fixed bug in write_scanner(). The buffer was not being properly *      updated for writes larger than OBUF_SIZE. Thanks to Henrik  *      Johansson <henrikjo@post.utfors.se> for identifying it. *    - Added Microtek X6 ID's. Thanks to Oliver Neukum *      <Oliver.Neukum@lrz.uni-muenchen.de>. * *  *  0.4.1  2/15/2000 *   *    - Fixed 'count' bug in read_scanner(). Thanks to Henrik *      Johansson <henrikjo@post.utfors.se> for identifying it.  Amazing *      it has worked this long. *    - Fixed '>=' bug in both read/write_scanner methods. *    - Cleaned up both read/write_scanner() methods so that they are  *      a little more readable. *    - Added a lot of Microtek ID's.  Thanks to Adrian Perez Jorge. *    - Adopted the __initcall(). *    - Added #include <linux/init.h> to scanner.h for __initcall(). *    - Added one liner in irq_scanner() to keep gcc from complaining  *      about an unused variable (data) if debugging was disabled *      in scanner.c. *    - Increased the timeout parameter in read_scanner() to 120 Secs. * * *  0.4.2  3/23/2000 * *    - Added Umax 1236U ID.  Thanks to Philipp Baer <ph_baer@npw.net>. *    - Added Primax, ReadyScan, Visioneer, Colorado, and Genius ID's. *      Thanks to Adrian Perez Jorge <adrianpj@easynews.com>. *    - Fixed error number reported for non-existant devices.  Thanks to *      Spyridon Papadimitriou <Spyridon_Papadimitriou@gs91.sp.cs.cmu.edu>. *    - Added Acer Prisascan 620U ID's.  Thanks to Joao <joey@knoware.nl>. *    - Replaced __initcall() with module_init()/module_exit(). Updates *      from patch-2.3.48. *    - Replaced file_operations structure with new syntax.  Updates *      from patch-2.3.49. *    - Changed #include "usb.h" to #include <linux/usb.h> *    - Added #define SCN_IOCTL to exclude development areas  *      since 2.4.x is about to be released. This mainly affects the  *      ioctl() stuff.  See scanner.h for more details. *    - Changed the return value for signal_pending() from -ERESTARTSYS to *      -EINTR. * * * 0.4.3  4/30/2000 * *    - Added Umax Astra 2200 ID.  Thanks to Flynn Marquardt  *      <flynn@isr.uni-stuttgart.de>. *    - Added iVina 1200U ID. Thanks to Dyson Lin <dyson@avision.com.tw>. *    - Added access time update for the device file courtesy of Paul *      Mackerras <paulus@samba.org>.  This allows a user space daemon *      to turn the lamp off for a Umax 1220U scanner after a prescribed *      time. *    - Fixed HP S20 ID's.  Thanks to Ruud Linders <rlinders@xs4all.nl>. *    - Added Acer ScanPrisa 620U ID. Thanks to Oliver *      Schwartz <Oliver.Schwartz@gmx.de> via sane-devel mail list. *    - Fixed bug in read_scanner for copy_to_user() function.  The returned *      value should be 'partial' not 'this_read'. *    - Fixed bug in read_scanner. 'count' should be decremented  *      by 'this_read' and not by 'partial'.  This resulted in twice as many *      calls to read_scanner() for small amounts of data and possibly *      unexpected returns of '0'.  Thanks to Karl Heinz  *      Kremer <khk@khk.net> and Alain Knaff <Alain.Knaff@ltnb.lu> *      for discovering this. *    - Integrated Randy Dunlap's <randy.dunlap@intel.com> patch for a *      scanner lookup/ident table. Thanks Randy. *    - Documentation updates. *    - Added wait queues to read_scanner(). * * * 0.4.3.1 * *    - Fixed HP S20 ID's...again..sigh.  Thanks to Ruud *      Linders <rlinders@xs4all.nl>. * * 0.4.4 *    - Added addtional Mustek ID's (BearPaw 1200, 600 CU, 1200 USB, *      and 1200 UB.  Thanks to Henning Meier-Geinitz <henningmg@gmx.de>. *    - Added the Vuego Scan Brisa 340U ID's.  Apparently this scanner is *      marketed by Acer Peripherals as a cheap 300 dpi model. Thanks to *      David Gundersen <gundersd@paradise.net.nz>. *    - Added the Epson Expression1600 ID's. Thanks to Karl Heinz *      Kremer <khk@khk.net>. * * 0.4.5  2/28/2001 *    - Added Mustek ID's (BearPaw 2400, 1200 CU Plus, BearPaw 1200F). *      Thanks to Henning Meier-Geinitz <henningmg@gmx.de>. *    - Added read_timeout module parameter to override RD_NAK_TIMEOUT *      when read()'ing from devices. *    - Stalled pipes are now checked and cleared with *      usb_clear_halt() for the read_scanner() function. This should *      address the "funky result: -32" error messages. *    - Removed Microtek scanner ID's.  Microtek scanners are now *      supported via the drivers/usb/microtek.c driver. *    - Added scanner specific read timeout's. *    - Return status errors are NEGATIVE!!!  This should address the *      "funky result: -110" error messages. *    - Replaced USB_ST_TIMEOUT with ETIMEDOUT. *    - rd_nak was still defined in MODULE_PARM.  It's been updated with *      read_timeout.  Thanks to Mark W. Webb <markwebb@adelphia.net> for *      reporting this bug. *    - Added Epson Perfection 1640SU and 1640SU Photo.  Thanks to *      Jean-Luc <f5ibh@db0bm.ampr.org> and Manuel *      Pelayo <Manuel.Pelayo@sesips.org>. Reported to work fine by Manuel. * * 0.4.6  9/27/2001 *    - Added IOCTL's to report back scanner USB ID's.  Thanks to *      Karl Heinz <khk@lynx.phpwebhosting.com> *    - Added Umax Astra 2100U ID's.  Thanks to Ron *      Wellsted <ron@wellsted.org.uk>. *      and Manuel Pelayo <Manuel.Pelayo@sesips.org>. *    - Added HP 3400 ID's. Thanks to Harald Hannelius <harald@iki.fi> *      and Bertrik Sikken <bertrik@zonnet.nl>.  Reported to work at *      htpp://home.zonnet.nl/bertrik/hp3300c/hp3300c.htm. *    - Added Minolta Dimage Scan Dual II ID's.  Thanks to Jose Paulo *      Moitinho de Almeida <moitinho@civil.ist.utl.pt> *    - Confirmed addition for SnapScan E20.  Thanks to Steffen H黚ner *      <hueb_s@gmx.de>. *    - Added Lifetec LT9385 ID's.  Thanks to Van Bruwaene Kris *      <krvbr@yahoo.co.uk> *    - Added Agfa SnapScan e26 ID's.  Reported to work with SANE *      1.0.5.  Thanks to Falk Sauer <falk@mgnkatze.franken.de>. *    - Added HP 4300 ID's.  Thanks to Stefan Schlosser *      <castla@grmmbl.org>. *    - Added Relisis Episode ID's.  Thanks to Manfred *      Morgner <odb-devel@gmx.net>. *    - Added many Acer ID's. Thanks to Oliver *      Schwartz <Oliver.Schwartz@gmx.de>. *    - Added Snapscan e40 ID's.  Thanks to Oliver *      Schwartz <Oliver.Schwartz@gmx.de>. *    - Thanks to Oliver Neukum <Oliver.Neukum@lrz.uni-muenchen.de> *      for helping with races. *    - Added Epson Perfection 1650 ID's. Thanks to Karl Heinz *      Kremer <khk@khk.net>. *    - Added Epson Perfection 2450 ID's (aka GT-9700 for the Japanese *      market).  Thanks to Karl Heinz Kremer <khk@khk.net>. *    - Added Mustek 600 USB ID's.  Thanks to Marcus *      Alanen <maalanen@ra.abo.fi>. *    - Added Acer ScanPrisa 1240UT ID's.  Thanks to Morgan *      Collins <sirmorcant@morcant.org>. *    - Incorporated devfs patches!! Thanks to Tom Rini *      <trini@kernel.crashing.org>, Pavel Roskin <proski@gnu.org>, *      Greg KH <greg@kroah.com>, Yves Duret <yduret@mandrakesoft.com>, *      Flavio Stanchina <flavio.stanchina@tin.it>. *    - Removed Minolta ScanImage II.  This scanner uses USB SCSI.  Thanks *      to Oliver Neukum <Oliver.Neukum@lrz.uni-muenchen.de> for pointing *      this out. *    - Added additional SMP locking.  Thanks to David Brownell and  *      Oliver Neukum for their help. *    - Added version reporting - reports for both module load and modinfo *    - Started path to hopefully straighten/clean out ioctl()'s. *    - Users are now notified to consult the Documentation/usb/scanner.txt *      for common error messages rather than the maintainer. * * 0.4.7  11/28/2001 *    - Fixed typo in Documentation/scanner.txt.  Thanks to *      Karel <karel.vervaeke@pandora.be> for pointing it out. *    - Added ID's for a Memorex 6136u. Thanks to 羖varo Gaspar de *      Valenzuela" <agaspard@utsi.edu>. *    - Added ID's for Agfa e25.  Thanks to Heinrich  *      Rust <Heinrich.Rust@gmx.de>.  Also reported to work with *      Linux and SANE (?). *    - Added Canon FB620U, D646U, and 1220U ID's.  Thanks to Paul *      Rensing <Paul_Rensing@StanfordAlumni.org>.  For more info *      on Linux support for these models, contact  *      salvestrini@users.sourceforge.net. *    - Added Plustek OpticPro UT12, OpticPro U24, KYE/Genius *      ColorPage-HR6 V2 ID's in addition to many "Unknown" models *      under those vendors.  Thanks to *      Jaeger, Gerhard" <g.jaeger@earthling.net>.  These scanner are *      apparently based upon the LM983x IC's. *    - Applied Frank's patch that addressed some locking and module *      referencing counts.  Thanks to both *      Frank Zago <fzago@greshamstorage.com> and *      Oliver Neukum <520047054719-0001@t-online.de> for reviewing/testing. * * TODO *    - Performance *    - Select/poll methods *    - More testing *    - Proper registry/assignment for LM9830 ioctl's * * *  Thanks to: * *    - All the folks on the linux-usb list who put up with me. :)  This  *      has been a great learning experience for me. *    - To Linus Torvalds for this great OS. *    - The GNU folks. *    - The folks that forwarded Vendor:Product ID's to me. *    - Johannes Erdfelt for the loaning of a USB analyzer for tracking an *      issue with HP-4100 and uhci. *    - Adolfo Montero for his assistance. *    - All the folks who chimed in with reports and suggestions. *    - All the developers that are working on USB SANE backends or other *      applications to use USB scanners. * *  Performance: * *    System: Pentium 120, 80 MB RAM, OHCI, Linux 2.3.23, HP 4100C USB Scanner *            300 dpi scan of the entire bed *      24 Bit Color ~ 70 secs - 3.6 Mbit/sec *       8 Bit Gray ~ 17 secs - 4.2 Mbit/sec *//*  * Scanner definitions, macros, module info,  * debug/ioctl/data_dump enable, and other constants. */ #include "scanner.h"static voidirq_scanner(struct urb *urb){/* * For the meantime, this is just a placeholder until I figure out what * all I want to do with it -- or somebody else for that matter. */	struct scn_usb_data *scn;	unsigned char *data;	scn = urb->context;	data = &scn->button;	data += 0;		/* Keep gcc from complaining about unused var */	if (urb->status) {		return;	}	dbg("irq_scanner(%d): data:%x", scn->scn_minor, *data);	return;}static intopen_scanner(struct inode * inode, struct file * file){	struct scn_usb_data *scn;	struct usb_device *dev;	kdev_t scn_minor;	int err=0;	MOD_INC_USE_COUNT;