struct usb_mouse {
char name[128];///USB鼠标设备名称
char phys[64];///路径
struct usb_device *usbdev;///USB设备
struct input_dev *dev;///Input 设备
struct urb *irq; ///urb结构体
signed char *data;///数据传输缓冲区指针
dma_addr_t data_dma;///
};
1 static int usb_mouse_probe(struct usb_interface *intf, const struct usb_device_id *id)
2 {
3 struct usb_device *dev = interface_to_usbdev(intf);///通过 USB 接口来获得 usb 设备
4 struct usb_host_interface *interface;
5 struct usb_endpoint_descriptor *endpoint;
6 struct usb_mouse *mouse;
7 struct input_dev *input_dev;
8 int pipe, maxp;
9 int error = -ENOMEM;
10
11 interface = intf->cur_altsetting;///获取 usb_host_interface
12
13 if (interface->desc.bNumEndpoints != 1)/// usb鼠标端点有且只有一个控制端点，否则返回 ENODEV
14 return -ENODEV;
15
16 endpoint = &interface->endpoint[0].desc; ///usb鼠标只有一个端点，获取端点描述符
17 if (!usb_endpoint_is_int_in(endpoint))///检查端点是不是中断类型的输入端点
18 return -ENODEV;
19
20 pipe = usb_rcvintpipe(dev, endpoint->bEndpointAddress);////获取 pipe()，根据端点地址bEndpointAddress，中断方式，IN端点就可以得到一个pipe，然后主机就知道跟谁去通信，该如何通信
21 maxp = usb_maxpacket(dev, pipe, usb_pipeout(pipe));///获取主机和设备一次通讯的最大字节数
22
23 mouse = kzalloc(sizeof(struct usb_mouse), GFP_KERNEL);///分配一个usb_mouse
24 input_dev = input_allocate_device();///初始化 input 设备
25 if (!mouse || !input_dev)
26 goto fail1;
27
28 mouse->data = usb_alloc_coherent(dev, 8, GFP_ATOMIC, &mouse->data_dma);///为usbmouse的data 分配8个字节的空间
29 if (!mouse->data)
30 goto fail1;
31
32 mouse->irq = usb_alloc_urb(0, GFP_KERNEL);///申请分配 urb ，赋值给 usb_mouse 的 urb
33 if (!mouse->irq)
34 goto fail2;
35
36 mouse->usbdev = dev; //设置usb鼠标设备的usb设备对象
37 mouse->dev = input_dev;//设备usb鼠标设备的input设备对象
38
39 if (dev->manufacturer)///枚举时候有获取到有效的厂商名
40 strlcpy(mouse->name, dev->manufacturer, sizeof(mouse->name));///复制厂商名到 name
41
42 if (dev->product) { //枚举时候有获取到有效的产品名
43 if (dev->manufacturer) //如果也有厂商名
44 strlcat(mouse->name, " ", sizeof(mouse->name)); //则用空格将厂商名和产品名隔开
45 strlcat(mouse->name, dev->product, sizeof(mouse->name));//追加产品名到name
46 }
47
48 if (!strlen(mouse->name)) //如果厂商和产品名都没有
49 snprintf(mouse->name, sizeof(mouse->name), //则直接根据厂商id和产品id给name赋值
50 "USB HIDBP Mouse %04x:%04x",
51 le16_to_cpu(dev->descriptor.idVendor),
52 le16_to_cpu(dev->descriptor.idProduct));
53
54 usb_make_path(dev, mouse->phys, sizeof(mouse->phys)); //设置设备路径名
55 strlcat(mouse->phys, "/input0", sizeof(mouse->phys)); //追加/input0
56
57 input_dev->name = mouse->name; //输入设备的名字设置成usb鼠标的名字
58 input_dev->phys = mouse->phys; //输入设备的路径设置成usb鼠标的路径
59 usb_to_input_id(dev, &input_dev->id); //设置输入设备的bustype,vendor,product,version
60 input_dev->dev.parent = &intf->dev; //usb接口设备为输入设备的父设备
61
62 ////evbit 关于设备支持事件类型的 bitmap
63 input_dev->evbit[0] = BIT_MASK(EV_KEY) | BIT_MASK(EV_REL); ///BIT_MASK 找到参数值所在的 bit位,输入事件按键类型 + 相对位移
64 input_dev->keybit[BIT_WORD(BTN_MOUSE)