/* * $Id: usbmouse.c,v 1.15 2001/12/27 10:37:41 vojtech Exp $ * *  Copyright (c) 1999-2001 Vojtech Pavlik * *  USB HIDBP Mouse support *//* * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * * Should you need to contact me, the author, you can do so either by * e-mail - mail your message to <vojtech@ucw.cz>, or by paper mail: * Vojtech Pavlik, Simunkova 1594, Prague 8, 182 00 Czech Republic */#include <linux/kernel.h>#include <linux/slab.h>#include <linux/input.h>#include <linux/module.h>#include <linux/init.h>#include <linux/usb.h>#include <linux/usb_input.h>/* * Version Information */#define DRIVER_VERSION "v1.6"#define DRIVER_AUTHOR "Vojtech Pavlik <vojtech@ucw.cz>"#define DRIVER_DESC "USB HID Boot Protocol mouse driver"#define DRIVER_LICENSE "GPL"MODULE_AUTHOR(DRIVER_AUTHOR);MODULE_DESCRIPTION(DRIVER_DESC);MODULE_LICENSE(DRIVER_LICENSE);struct usb_mouse {	char name[128];	char phys[64];	struct usb_device *usbdev;	struct input_dev *dev;	struct urb *irq;	signed char *data;	dma_addr_t data_dma;};static void usb_mouse_irq(struct urb *urb, struct pt_regs *regs) //{	struct usb_mouse *mouse = urb->context;	signed char *data = mouse->data;	struct input_dev *dev = mouse->dev;	int status;	switch (urb->status) {	case 0:			/* success */		break;	case -ECONNRESET:	/* unlink */	case -ENOENT:	case -ESHUTDOWN:		return;	/* -EPIPE:  should clear the halt */	default:		/* error */		goto resubmit;	}	input_regs(dev, regs);	input_report_key(dev, BTN_LEFT,   data[0] & 0x01);	input_report_key(dev, BTN_RIGHT,  data[0] & 0x02);	input_report_key(dev, BTN_MIDDLE, data[0] & 0x04);	input_report_key(dev, BTN_SIDE,   data[0] & 0x08);	input_report_key(dev, BTN_EXTRA,  data[0] & 0x10);	input_report_rel(dev, REL_X,     data[1]);	input_report_rel(dev, REL_Y,     data[2]);	input_report_rel(dev, REL_WHEEL, data[3]);	input_sync(dev);resubmit:	status = usb_submit_urb (urb, SLAB_ATOMIC);		   //再次向usb core提交urb   	if (status)		err ("can't resubmit intr, %s-%s/input0, status %d",				mouse->usbdev->bus->bus_name,				mouse->usbdev->devpath, status);}//打開鼠標static int usb_mouse_open(struct input_dev *dev){	struct usb_mouse *mouse = dev->private;	mouse->irq->dev = mouse->usbdev;	if (usb_submit_urb(mouse->irq, GFP_KERNEL))		  //向usb core提交urb		return -EIO;	return 0;}//關閉鼠標static void usb_mouse_close(struct input_dev *dev){	struct usb_mouse *mouse = dev->private;	usb_kill_urb(mouse->irq);	   //取消urb塊}static int usb_mouse_probe(			 //usb 接入事件回調函數	struct usb_interface *intf, 	 //usb 接口	const struct usb_device_id *id)  //usb 設備id{	struct usb_device *dev = interface_to_usbdev(intf);  //由接口得到設備	struct usb_host_interface *interface;	struct usb_endpoint_descriptor *endpoint;	  //usb端點描述符	struct usb_mouse *mouse;	  //自定義usb mouse	struct input_dev *input_dev;  //輸入設備	int pipe, maxp;	interface = intf->cur_altsetting;	if (interface->desc.bNumEndpoints != 1)		return -ENODEV;	endpoint = &interface->endpoint[0].desc;	if (!(endpoint->bEndpointAddress & USB_DIR_IN))		return -ENODEV;	if ((endpoint->bmAttributes & USB_ENDPOINT_XFERTYPE_MASK) != USB_ENDPOINT_XFER_INT)		return -ENODEV;	pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);	maxp = usb_maxpacket(dev, pipe, usb_pipeout(pipe));	mouse = kzalloc(sizeof(struct usb_mouse), GFP_KERNEL);	input_dev = input_allocate_device();	if (!mouse || !input_dev)		goto fail1;	mouse->data = usb_buffer_alloc(dev, 8, SLAB_ATOMIC, &mouse->data_dma);   //產生一個DMA buffer用以傳送數據到設備	if (!mouse->data)		goto fail1;	mouse->irq = usb_alloc_urb(0, GFP_KERNEL);  //生成urb塊	if (!mouse->irq)		goto fail2;	mouse->usbdev = dev;	mouse->dev = input_dev;	if (dev->manufacturer)		strlcpy(mouse->name, dev->manufacturer, sizeof(mouse->name));	if (dev->product) {		if (dev->manufacturer)			strlcat(mouse->name, " ", sizeof(mouse->name));		strlcat(mouse->name, dev->product, sizeof(mouse->name));	}	if (!strlen(mouse->name))		snprintf(mouse->name, sizeof(mouse->name),			 "USB HIDBP Mouse %04x:%04x",			 le16_to_cpu(dev->descriptor.idVendor),			 le16_to_cpu(dev->descriptor.idProduct));	usb_make_path(dev, mouse->phys, sizeof(mouse->phys));	strlcat(mouse->phys, "/input0", sizeof(mouse->phys));	input_dev->name = mouse->name;	input_dev->phys = mouse->phys;	usb_to_input_id(dev, &input_dev->id);	input_dev->cdev.dev = &intf->dev;	input_dev->evbit[0] = BIT(EV_KEY) | BIT(EV_REL);	input_dev->keybit[LONG(BTN_MOUSE)] = BIT(BTN_LEFT) | BIT(BTN_RIGHT) | BIT(BTN_MIDDLE);	input_dev->relbit[0] = BIT(REL_X) | BIT(REL_Y);	input_dev->keybit[LONG(BTN_MOUSE)] |= BIT(BTN_SIDE) | BIT(BTN_EXTRA);	input_dev->relbit[0] |= BIT(REL_WHEEL);	input_dev->private = mouse;	input_dev->open = usb_mouse_open;	input_dev->close = usb_mouse_close;	usb_fill_int_urb(mouse->irq, dev, pipe, mouse->data,	 //初始化urb塊			 (maxp > 8 ? 8 : maxp),			 usb_mouse_irq, mouse, endpoint->bInterval);	mouse->irq->transfer_dma = mouse->data_dma;	mouse->irq->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;	input_register_device(mouse->dev);	usb_set_intfdata(intf, mouse);	return 0;fail2:	usb_buffer_free(dev, 8, mouse->data, mouse->data_dma);fail1:	input_free_device(input_dev);	kfree(mouse);	return -ENOMEM;}static void usb_mouse_disconnect(struct usb_interface *intf){	struct usb_mouse *mouse = usb_get_intfdata (intf);	usb_set_intfdata(intf, NULL);	if (mouse) {		usb_kill_urb(mouse->irq);		//取消urb塊		input_unregister_device(mouse->dev);		usb_free_urb(mouse->irq);	  //釋放urb塊		usb_buffer_free(interface_to_usbdev(intf), 8, mouse->data, mouse->data_dma);		kfree(mouse);	}}static struct usb_device_id usb_mouse_id_table [] = {	{ USB_INTERFACE_INFO(3, 1, 2) },	//初始化  usb_mouse_id_table    { }						/* Terminating entry */};//export to user space to allow the hotplug and module loading systems know what module works with what hardware devices.  MODULE_DEVICE_TABLE (usb, usb_mouse_id_table);   static struct usb_driver usb_mouse_driver = {  //usb驅動的主結構體	.name		= "usbmouse",	.probe		= usb_mouse_probe,	.disconnect	= usb_mouse_disconnect,	.id_table	= usb_mouse_id_table,};static int __init usb_mouse_init(void){	int retval = usb_register(&usb_mouse_driver);  //To register the struct usb_driver with the USB core	if (retval == 0)		info(DRIVER_VERSION ":" DRIVER_DESC);	return retval;}static void __exit usb_mouse_exit(void){	usb_deregister(&usb_mouse_driver);  //unregistered from the kernel}module_init(usb_mouse_init);module_exit(usb_mouse_exit);