Bluetooth: ath3k: Add support for Fujitsu Lifebook UH5x2 [04c5:1330]
[pandora-kernel.git] / drivers / bluetooth / btusb.c
1 /*
2  *
3  *  Generic Bluetooth USB driver
4  *
5  *  Copyright (C) 2005-2008  Marcel Holtmann <marcel@holtmann.org>
6  *
7  *
8  *  This program is free software; you can redistribute it and/or modify
9  *  it under the terms of the GNU General Public License as published by
10  *  the Free Software Foundation; either version 2 of the License, or
11  *  (at your option) any later version.
12  *
13  *  This program is distributed in the hope that it will be useful,
14  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
15  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16  *  GNU General Public License for more details.
17  *
18  *  You should have received a copy of the GNU General Public License
19  *  along with this program; if not, write to the Free Software
20  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
21  *
22  */
23
24 #include <linux/kernel.h>
25 #include <linux/module.h>
26 #include <linux/init.h>
27 #include <linux/slab.h>
28 #include <linux/types.h>
29 #include <linux/sched.h>
30 #include <linux/errno.h>
31 #include <linux/skbuff.h>
32
33 #include <linux/usb.h>
34
35 #include <net/bluetooth/bluetooth.h>
36 #include <net/bluetooth/hci_core.h>
37
38 #define VERSION "0.6"
39
40 static int ignore_dga;
41 static int ignore_csr;
42 static int ignore_sniffer;
43 static int disable_scofix;
44 static int force_scofix;
45
46 static int reset = 1;
47
48 static struct usb_driver btusb_driver;
49
50 #define BTUSB_IGNORE            0x01
51 #define BTUSB_DIGIANSWER        0x02
52 #define BTUSB_CSR               0x04
53 #define BTUSB_SNIFFER           0x08
54 #define BTUSB_BCM92035          0x10
55 #define BTUSB_BROKEN_ISOC       0x20
56 #define BTUSB_WRONG_SCO_MTU     0x40
57 #define BTUSB_ATH3012           0x80
58
59 static struct usb_device_id btusb_table[] = {
60         /* Generic Bluetooth USB device */
61         { USB_DEVICE_INFO(0xe0, 0x01, 0x01) },
62
63         /* Apple-specific (Broadcom) devices */
64         { USB_VENDOR_AND_INTERFACE_INFO(0x05ac, 0xff, 0x01, 0x01) },
65
66         /* MediaTek MT76x0E */
67         { USB_DEVICE(0x0e8d, 0x763f) },
68
69         /* Broadcom SoftSailing reporting vendor specific */
70         { USB_DEVICE(0x0a5c, 0x21e1) },
71
72         /* Apple MacBookPro 7,1 */
73         { USB_DEVICE(0x05ac, 0x8213) },
74
75         /* Apple iMac11,1 */
76         { USB_DEVICE(0x05ac, 0x8215) },
77
78         /* Apple MacBookPro6,2 */
79         { USB_DEVICE(0x05ac, 0x8218) },
80
81         /* Apple MacBookAir3,1, MacBookAir3,2 */
82         { USB_DEVICE(0x05ac, 0x821b) },
83
84         /* Apple MacBookAir4,1 */
85         { USB_DEVICE(0x05ac, 0x821f) },
86
87         /* Apple MacBookPro8,2 */
88         { USB_DEVICE(0x05ac, 0x821a) },
89
90         /* Apple MacMini5,1 */
91         { USB_DEVICE(0x05ac, 0x8281) },
92
93         /* AVM BlueFRITZ! USB v2.0 */
94         { USB_DEVICE(0x057c, 0x3800) },
95
96         /* Bluetooth Ultraport Module from IBM */
97         { USB_DEVICE(0x04bf, 0x030a) },
98
99         /* ALPS Modules with non-standard id */
100         { USB_DEVICE(0x044e, 0x3001) },
101         { USB_DEVICE(0x044e, 0x3002) },
102
103         /* Ericsson with non-standard id */
104         { USB_DEVICE(0x0bdb, 0x1002) },
105
106         /* Canyon CN-BTU1 with HID interfaces */
107         { USB_DEVICE(0x0c10, 0x0000) },
108
109         /* Broadcom BCM20702A0 */
110         { USB_DEVICE(0x0b05, 0x17b5) },
111         { USB_DEVICE(0x04ca, 0x2003) },
112         { USB_DEVICE(0x0489, 0xe042) },
113         { USB_DEVICE(0x413c, 0x8197) },
114
115         /* Foxconn - Hon Hai */
116         { USB_VENDOR_AND_INTERFACE_INFO(0x0489, 0xff, 0x01, 0x01) },
117
118         /*Broadcom devices with vendor specific id */
119         { USB_VENDOR_AND_INTERFACE_INFO(0x0a5c, 0xff, 0x01, 0x01) },
120
121         { }     /* Terminating entry */
122 };
123
124 MODULE_DEVICE_TABLE(usb, btusb_table);
125
126 static struct usb_device_id blacklist_table[] = {
127         /* CSR BlueCore devices */
128         { USB_DEVICE(0x0a12, 0x0001), .driver_info = BTUSB_CSR },
129
130         /* Broadcom BCM2033 without firmware */
131         { USB_DEVICE(0x0a5c, 0x2033), .driver_info = BTUSB_IGNORE },
132
133         /* Atheros 3011 with sflash firmware */
134         { USB_DEVICE(0x0cf3, 0x3002), .driver_info = BTUSB_IGNORE },
135         { USB_DEVICE(0x0cf3, 0xe019), .driver_info = BTUSB_IGNORE },
136         { USB_DEVICE(0x13d3, 0x3304), .driver_info = BTUSB_IGNORE },
137         { USB_DEVICE(0x0930, 0x0215), .driver_info = BTUSB_IGNORE },
138         { USB_DEVICE(0x0489, 0xe03d), .driver_info = BTUSB_IGNORE },
139         { USB_DEVICE(0x0489, 0xe027), .driver_info = BTUSB_IGNORE },
140
141         /* Atheros AR9285 Malbec with sflash firmware */
142         { USB_DEVICE(0x03f0, 0x311d), .driver_info = BTUSB_IGNORE },
143
144         /* Atheros 3012 with sflash firmware */
145         { USB_DEVICE(0x0cf3, 0x0036), .driver_info = BTUSB_ATH3012 },
146         { USB_DEVICE(0x0cf3, 0x3004), .driver_info = BTUSB_ATH3012 },
147         { USB_DEVICE(0x0cf3, 0x3008), .driver_info = BTUSB_ATH3012 },
148         { USB_DEVICE(0x0cf3, 0x311d), .driver_info = BTUSB_ATH3012 },
149         { USB_DEVICE(0x0cf3, 0x817a), .driver_info = BTUSB_ATH3012 },
150         { USB_DEVICE(0x13d3, 0x3375), .driver_info = BTUSB_ATH3012 },
151         { USB_DEVICE(0x04ca, 0x3004), .driver_info = BTUSB_ATH3012 },
152         { USB_DEVICE(0x04ca, 0x3005), .driver_info = BTUSB_ATH3012 },
153         { USB_DEVICE(0x04ca, 0x3006), .driver_info = BTUSB_ATH3012 },
154         { USB_DEVICE(0x04ca, 0x3008), .driver_info = BTUSB_ATH3012 },
155         { USB_DEVICE(0x13d3, 0x3362), .driver_info = BTUSB_ATH3012 },
156         { USB_DEVICE(0x0cf3, 0xe004), .driver_info = BTUSB_ATH3012 },
157         { USB_DEVICE(0x0930, 0x0219), .driver_info = BTUSB_ATH3012 },
158         { USB_DEVICE(0x0489, 0xe057), .driver_info = BTUSB_ATH3012 },
159         { USB_DEVICE(0x13d3, 0x3393), .driver_info = BTUSB_ATH3012 },
160         { USB_DEVICE(0x0489, 0xe04e), .driver_info = BTUSB_ATH3012 },
161         { USB_DEVICE(0x0489, 0xe056), .driver_info = BTUSB_ATH3012 },
162         { USB_DEVICE(0x0489, 0xe04d), .driver_info = BTUSB_ATH3012 },
163         { USB_DEVICE(0x04c5, 0x1330), .driver_info = BTUSB_ATH3012 },
164
165         /* Atheros AR5BBU12 with sflash firmware */
166         { USB_DEVICE(0x0489, 0xe02c), .driver_info = BTUSB_IGNORE },
167
168         /* Atheros AR5BBU12 with sflash firmware */
169         { USB_DEVICE(0x0489, 0xe03c), .driver_info = BTUSB_ATH3012 },
170         { USB_DEVICE(0x0489, 0xe036), .driver_info = BTUSB_ATH3012 },
171
172         /* Broadcom BCM2035 */
173         { USB_DEVICE(0x0a5c, 0x2035), .driver_info = BTUSB_WRONG_SCO_MTU },
174         { USB_DEVICE(0x0a5c, 0x200a), .driver_info = BTUSB_WRONG_SCO_MTU },
175         { USB_DEVICE(0x0a5c, 0x2009), .driver_info = BTUSB_BCM92035 },
176
177         /* Broadcom BCM2045 */
178         { USB_DEVICE(0x0a5c, 0x2039), .driver_info = BTUSB_WRONG_SCO_MTU },
179         { USB_DEVICE(0x0a5c, 0x2101), .driver_info = BTUSB_WRONG_SCO_MTU },
180
181         /* IBM/Lenovo ThinkPad with Broadcom chip */
182         { USB_DEVICE(0x0a5c, 0x201e), .driver_info = BTUSB_WRONG_SCO_MTU },
183         { USB_DEVICE(0x0a5c, 0x2110), .driver_info = BTUSB_WRONG_SCO_MTU },
184
185         /* HP laptop with Broadcom chip */
186         { USB_DEVICE(0x03f0, 0x171d), .driver_info = BTUSB_WRONG_SCO_MTU },
187
188         /* Dell laptop with Broadcom chip */
189         { USB_DEVICE(0x413c, 0x8126), .driver_info = BTUSB_WRONG_SCO_MTU },
190
191         /* Dell Wireless 370 and 410 devices */
192         { USB_DEVICE(0x413c, 0x8152), .driver_info = BTUSB_WRONG_SCO_MTU },
193         { USB_DEVICE(0x413c, 0x8156), .driver_info = BTUSB_WRONG_SCO_MTU },
194
195         /* Belkin F8T012 and F8T013 devices */
196         { USB_DEVICE(0x050d, 0x0012), .driver_info = BTUSB_WRONG_SCO_MTU },
197         { USB_DEVICE(0x050d, 0x0013), .driver_info = BTUSB_WRONG_SCO_MTU },
198
199         /* Asus WL-BTD202 device */
200         { USB_DEVICE(0x0b05, 0x1715), .driver_info = BTUSB_WRONG_SCO_MTU },
201
202         /* Kensington Bluetooth USB adapter */
203         { USB_DEVICE(0x047d, 0x105e), .driver_info = BTUSB_WRONG_SCO_MTU },
204
205         /* RTX Telecom based adapters with buggy SCO support */
206         { USB_DEVICE(0x0400, 0x0807), .driver_info = BTUSB_BROKEN_ISOC },
207         { USB_DEVICE(0x0400, 0x080a), .driver_info = BTUSB_BROKEN_ISOC },
208
209         /* CONWISE Technology based adapters with buggy SCO support */
210         { USB_DEVICE(0x0e5e, 0x6622), .driver_info = BTUSB_BROKEN_ISOC },
211
212         /* Digianswer devices */
213         { USB_DEVICE(0x08fd, 0x0001), .driver_info = BTUSB_DIGIANSWER },
214         { USB_DEVICE(0x08fd, 0x0002), .driver_info = BTUSB_IGNORE },
215
216         /* CSR BlueCore Bluetooth Sniffer */
217         { USB_DEVICE(0x0a12, 0x0002), .driver_info = BTUSB_SNIFFER },
218
219         /* Frontline ComProbe Bluetooth Sniffer */
220         { USB_DEVICE(0x16d3, 0x0002), .driver_info = BTUSB_SNIFFER },
221
222         { }     /* Terminating entry */
223 };
224
225 #define BTUSB_MAX_ISOC_FRAMES   10
226
227 #define BTUSB_INTR_RUNNING      0
228 #define BTUSB_BULK_RUNNING      1
229 #define BTUSB_ISOC_RUNNING      2
230 #define BTUSB_SUSPENDING        3
231 #define BTUSB_DID_ISO_RESUME    4
232
233 struct btusb_data {
234         struct hci_dev       *hdev;
235         struct usb_device    *udev;
236         struct usb_interface *intf;
237         struct usb_interface *isoc;
238
239         spinlock_t lock;
240
241         unsigned long flags;
242
243         struct work_struct work;
244         struct work_struct waker;
245
246         struct usb_anchor tx_anchor;
247         struct usb_anchor intr_anchor;
248         struct usb_anchor bulk_anchor;
249         struct usb_anchor isoc_anchor;
250         struct usb_anchor deferred;
251         int tx_in_flight;
252         spinlock_t txlock;
253
254         struct usb_endpoint_descriptor *intr_ep;
255         struct usb_endpoint_descriptor *bulk_tx_ep;
256         struct usb_endpoint_descriptor *bulk_rx_ep;
257         struct usb_endpoint_descriptor *isoc_tx_ep;
258         struct usb_endpoint_descriptor *isoc_rx_ep;
259
260         __u8 cmdreq_type;
261
262         unsigned int sco_num;
263         int isoc_altsetting;
264         int suspend_count;
265 };
266
267 static int inc_tx(struct btusb_data *data)
268 {
269         unsigned long flags;
270         int rv;
271
272         spin_lock_irqsave(&data->txlock, flags);
273         rv = test_bit(BTUSB_SUSPENDING, &data->flags);
274         if (!rv)
275                 data->tx_in_flight++;
276         spin_unlock_irqrestore(&data->txlock, flags);
277
278         return rv;
279 }
280
281 static void btusb_intr_complete(struct urb *urb)
282 {
283         struct hci_dev *hdev = urb->context;
284         struct btusb_data *data = hdev->driver_data;
285         int err;
286
287         BT_DBG("%s urb %p status %d count %d", hdev->name,
288                                         urb, urb->status, urb->actual_length);
289
290         if (!test_bit(HCI_RUNNING, &hdev->flags))
291                 return;
292
293         if (urb->status == 0) {
294                 hdev->stat.byte_rx += urb->actual_length;
295
296                 if (hci_recv_fragment(hdev, HCI_EVENT_PKT,
297                                                 urb->transfer_buffer,
298                                                 urb->actual_length) < 0) {
299                         BT_ERR("%s corrupted event packet", hdev->name);
300                         hdev->stat.err_rx++;
301                 }
302         }
303
304         if (!test_bit(BTUSB_INTR_RUNNING, &data->flags))
305                 return;
306
307         usb_mark_last_busy(data->udev);
308         usb_anchor_urb(urb, &data->intr_anchor);
309
310         err = usb_submit_urb(urb, GFP_ATOMIC);
311         if (err < 0) {
312                 /* -EPERM: urb is being killed;
313                  * -ENODEV: device got disconnected */
314                 if (err != -EPERM && err != -ENODEV)
315                         BT_ERR("%s urb %p failed to resubmit (%d)",
316                                                 hdev->name, urb, -err);
317                 usb_unanchor_urb(urb);
318         }
319 }
320
321 static int btusb_submit_intr_urb(struct hci_dev *hdev, gfp_t mem_flags)
322 {
323         struct btusb_data *data = hdev->driver_data;
324         struct urb *urb;
325         unsigned char *buf;
326         unsigned int pipe;
327         int err, size;
328
329         BT_DBG("%s", hdev->name);
330
331         if (!data->intr_ep)
332                 return -ENODEV;
333
334         urb = usb_alloc_urb(0, mem_flags);
335         if (!urb)
336                 return -ENOMEM;
337
338         size = le16_to_cpu(data->intr_ep->wMaxPacketSize);
339
340         buf = kmalloc(size, mem_flags);
341         if (!buf) {
342                 usb_free_urb(urb);
343                 return -ENOMEM;
344         }
345
346         pipe = usb_rcvintpipe(data->udev, data->intr_ep->bEndpointAddress);
347
348         usb_fill_int_urb(urb, data->udev, pipe, buf, size,
349                                                 btusb_intr_complete, hdev,
350                                                 data->intr_ep->bInterval);
351
352         urb->transfer_flags |= URB_FREE_BUFFER;
353
354         usb_anchor_urb(urb, &data->intr_anchor);
355
356         err = usb_submit_urb(urb, mem_flags);
357         if (err < 0) {
358                 BT_ERR("%s urb %p submission failed (%d)",
359                                                 hdev->name, urb, -err);
360                 usb_unanchor_urb(urb);
361         }
362
363         usb_free_urb(urb);
364
365         return err;
366 }
367
368 static void btusb_bulk_complete(struct urb *urb)
369 {
370         struct hci_dev *hdev = urb->context;
371         struct btusb_data *data = hdev->driver_data;
372         int err;
373
374         BT_DBG("%s urb %p status %d count %d", hdev->name,
375                                         urb, urb->status, urb->actual_length);
376
377         if (!test_bit(HCI_RUNNING, &hdev->flags))
378                 return;
379
380         if (urb->status == 0) {
381                 hdev->stat.byte_rx += urb->actual_length;
382
383                 if (hci_recv_fragment(hdev, HCI_ACLDATA_PKT,
384                                                 urb->transfer_buffer,
385                                                 urb->actual_length) < 0) {
386                         BT_ERR("%s corrupted ACL packet", hdev->name);
387                         hdev->stat.err_rx++;
388                 }
389         }
390
391         if (!test_bit(BTUSB_BULK_RUNNING, &data->flags))
392                 return;
393
394         usb_anchor_urb(urb, &data->bulk_anchor);
395         usb_mark_last_busy(data->udev);
396
397         err = usb_submit_urb(urb, GFP_ATOMIC);
398         if (err < 0) {
399                 /* -EPERM: urb is being killed;
400                  * -ENODEV: device got disconnected */
401                 if (err != -EPERM && err != -ENODEV)
402                         BT_ERR("%s urb %p failed to resubmit (%d)",
403                                                 hdev->name, urb, -err);
404                 usb_unanchor_urb(urb);
405         }
406 }
407
408 static int btusb_submit_bulk_urb(struct hci_dev *hdev, gfp_t mem_flags)
409 {
410         struct btusb_data *data = hdev->driver_data;
411         struct urb *urb;
412         unsigned char *buf;
413         unsigned int pipe;
414         int err, size = HCI_MAX_FRAME_SIZE;
415
416         BT_DBG("%s", hdev->name);
417
418         if (!data->bulk_rx_ep)
419                 return -ENODEV;
420
421         urb = usb_alloc_urb(0, mem_flags);
422         if (!urb)
423                 return -ENOMEM;
424
425         buf = kmalloc(size, mem_flags);
426         if (!buf) {
427                 usb_free_urb(urb);
428                 return -ENOMEM;
429         }
430
431         pipe = usb_rcvbulkpipe(data->udev, data->bulk_rx_ep->bEndpointAddress);
432
433         usb_fill_bulk_urb(urb, data->udev, pipe,
434                                         buf, size, btusb_bulk_complete, hdev);
435
436         urb->transfer_flags |= URB_FREE_BUFFER;
437
438         usb_mark_last_busy(data->udev);
439         usb_anchor_urb(urb, &data->bulk_anchor);
440
441         err = usb_submit_urb(urb, mem_flags);
442         if (err < 0) {
443                 BT_ERR("%s urb %p submission failed (%d)",
444                                                 hdev->name, urb, -err);
445                 usb_unanchor_urb(urb);
446         }
447
448         usb_free_urb(urb);
449
450         return err;
451 }
452
453 static void btusb_isoc_complete(struct urb *urb)
454 {
455         struct hci_dev *hdev = urb->context;
456         struct btusb_data *data = hdev->driver_data;
457         int i, err;
458
459         BT_DBG("%s urb %p status %d count %d", hdev->name,
460                                         urb, urb->status, urb->actual_length);
461
462         if (!test_bit(HCI_RUNNING, &hdev->flags))
463                 return;
464
465         if (urb->status == 0) {
466                 for (i = 0; i < urb->number_of_packets; i++) {
467                         unsigned int offset = urb->iso_frame_desc[i].offset;
468                         unsigned int length = urb->iso_frame_desc[i].actual_length;
469
470                         if (urb->iso_frame_desc[i].status)
471                                 continue;
472
473                         hdev->stat.byte_rx += length;
474
475                         if (hci_recv_fragment(hdev, HCI_SCODATA_PKT,
476                                                 urb->transfer_buffer + offset,
477                                                                 length) < 0) {
478                                 BT_ERR("%s corrupted SCO packet", hdev->name);
479                                 hdev->stat.err_rx++;
480                         }
481                 }
482         }
483
484         if (!test_bit(BTUSB_ISOC_RUNNING, &data->flags))
485                 return;
486
487         usb_anchor_urb(urb, &data->isoc_anchor);
488
489         err = usb_submit_urb(urb, GFP_ATOMIC);
490         if (err < 0) {
491                 /* -EPERM: urb is being killed;
492                  * -ENODEV: device got disconnected */
493                 if (err != -EPERM && err != -ENODEV)
494                         BT_ERR("%s urb %p failed to resubmit (%d)",
495                                                 hdev->name, urb, -err);
496                 usb_unanchor_urb(urb);
497         }
498 }
499
500 static inline void __fill_isoc_descriptor(struct urb *urb, int len, int mtu)
501 {
502         int i, offset = 0;
503
504         BT_DBG("len %d mtu %d", len, mtu);
505
506         for (i = 0; i < BTUSB_MAX_ISOC_FRAMES && len >= mtu;
507                                         i++, offset += mtu, len -= mtu) {
508                 urb->iso_frame_desc[i].offset = offset;
509                 urb->iso_frame_desc[i].length = mtu;
510         }
511
512         if (len && i < BTUSB_MAX_ISOC_FRAMES) {
513                 urb->iso_frame_desc[i].offset = offset;
514                 urb->iso_frame_desc[i].length = len;
515                 i++;
516         }
517
518         urb->number_of_packets = i;
519 }
520
521 static int btusb_submit_isoc_urb(struct hci_dev *hdev, gfp_t mem_flags)
522 {
523         struct btusb_data *data = hdev->driver_data;
524         struct urb *urb;
525         unsigned char *buf;
526         unsigned int pipe;
527         int err, size;
528
529         BT_DBG("%s", hdev->name);
530
531         if (!data->isoc_rx_ep)
532                 return -ENODEV;
533
534         urb = usb_alloc_urb(BTUSB_MAX_ISOC_FRAMES, mem_flags);
535         if (!urb)
536                 return -ENOMEM;
537
538         size = le16_to_cpu(data->isoc_rx_ep->wMaxPacketSize) *
539                                                 BTUSB_MAX_ISOC_FRAMES;
540
541         buf = kmalloc(size, mem_flags);
542         if (!buf) {
543                 usb_free_urb(urb);
544                 return -ENOMEM;
545         }
546
547         pipe = usb_rcvisocpipe(data->udev, data->isoc_rx_ep->bEndpointAddress);
548
549         usb_fill_int_urb(urb, data->udev, pipe, buf, size, btusb_isoc_complete,
550                                 hdev, data->isoc_rx_ep->bInterval);
551
552         urb->transfer_flags  = URB_FREE_BUFFER | URB_ISO_ASAP;
553
554         __fill_isoc_descriptor(urb, size,
555                         le16_to_cpu(data->isoc_rx_ep->wMaxPacketSize));
556
557         usb_anchor_urb(urb, &data->isoc_anchor);
558
559         err = usb_submit_urb(urb, mem_flags);
560         if (err < 0) {
561                 BT_ERR("%s urb %p submission failed (%d)",
562                                                 hdev->name, urb, -err);
563                 usb_unanchor_urb(urb);
564         }
565
566         usb_free_urb(urb);
567
568         return err;
569 }
570
571 static void btusb_tx_complete(struct urb *urb)
572 {
573         struct sk_buff *skb = urb->context;
574         struct hci_dev *hdev = (struct hci_dev *) skb->dev;
575         struct btusb_data *data = hdev->driver_data;
576
577         BT_DBG("%s urb %p status %d count %d", hdev->name,
578                                         urb, urb->status, urb->actual_length);
579
580         if (!test_bit(HCI_RUNNING, &hdev->flags))
581                 goto done;
582
583         if (!urb->status)
584                 hdev->stat.byte_tx += urb->transfer_buffer_length;
585         else
586                 hdev->stat.err_tx++;
587
588 done:
589         spin_lock(&data->txlock);
590         data->tx_in_flight--;
591         spin_unlock(&data->txlock);
592
593         kfree(urb->setup_packet);
594
595         kfree_skb(skb);
596 }
597
598 static void btusb_isoc_tx_complete(struct urb *urb)
599 {
600         struct sk_buff *skb = urb->context;
601         struct hci_dev *hdev = (struct hci_dev *) skb->dev;
602
603         BT_DBG("%s urb %p status %d count %d", hdev->name,
604                                         urb, urb->status, urb->actual_length);
605
606         if (!test_bit(HCI_RUNNING, &hdev->flags))
607                 goto done;
608
609         if (!urb->status)
610                 hdev->stat.byte_tx += urb->transfer_buffer_length;
611         else
612                 hdev->stat.err_tx++;
613
614 done:
615         kfree(urb->setup_packet);
616
617         kfree_skb(skb);
618 }
619
620 static int btusb_open(struct hci_dev *hdev)
621 {
622         struct btusb_data *data = hdev->driver_data;
623         int err;
624
625         BT_DBG("%s", hdev->name);
626
627         err = usb_autopm_get_interface(data->intf);
628         if (err < 0)
629                 return err;
630
631         data->intf->needs_remote_wakeup = 1;
632
633         if (test_and_set_bit(HCI_RUNNING, &hdev->flags))
634                 goto done;
635
636         if (test_and_set_bit(BTUSB_INTR_RUNNING, &data->flags))
637                 goto done;
638
639         err = btusb_submit_intr_urb(hdev, GFP_KERNEL);
640         if (err < 0)
641                 goto failed;
642
643         err = btusb_submit_bulk_urb(hdev, GFP_KERNEL);
644         if (err < 0) {
645                 usb_kill_anchored_urbs(&data->intr_anchor);
646                 goto failed;
647         }
648
649         set_bit(BTUSB_BULK_RUNNING, &data->flags);
650         btusb_submit_bulk_urb(hdev, GFP_KERNEL);
651
652 done:
653         usb_autopm_put_interface(data->intf);
654         return 0;
655
656 failed:
657         clear_bit(BTUSB_INTR_RUNNING, &data->flags);
658         clear_bit(HCI_RUNNING, &hdev->flags);
659         usb_autopm_put_interface(data->intf);
660         return err;
661 }
662
663 static void btusb_stop_traffic(struct btusb_data *data)
664 {
665         usb_kill_anchored_urbs(&data->intr_anchor);
666         usb_kill_anchored_urbs(&data->bulk_anchor);
667         usb_kill_anchored_urbs(&data->isoc_anchor);
668 }
669
670 static int btusb_close(struct hci_dev *hdev)
671 {
672         struct btusb_data *data = hdev->driver_data;
673         int err;
674
675         BT_DBG("%s", hdev->name);
676
677         if (!test_and_clear_bit(HCI_RUNNING, &hdev->flags))
678                 return 0;
679
680         cancel_work_sync(&data->work);
681         cancel_work_sync(&data->waker);
682
683         clear_bit(BTUSB_ISOC_RUNNING, &data->flags);
684         clear_bit(BTUSB_BULK_RUNNING, &data->flags);
685         clear_bit(BTUSB_INTR_RUNNING, &data->flags);
686
687         btusb_stop_traffic(data);
688         err = usb_autopm_get_interface(data->intf);
689         if (err < 0)
690                 goto failed;
691
692         data->intf->needs_remote_wakeup = 0;
693         usb_autopm_put_interface(data->intf);
694
695 failed:
696         usb_scuttle_anchored_urbs(&data->deferred);
697         return 0;
698 }
699
700 static int btusb_flush(struct hci_dev *hdev)
701 {
702         struct btusb_data *data = hdev->driver_data;
703
704         BT_DBG("%s", hdev->name);
705
706         usb_kill_anchored_urbs(&data->tx_anchor);
707
708         return 0;
709 }
710
711 static int btusb_send_frame(struct sk_buff *skb)
712 {
713         struct hci_dev *hdev = (struct hci_dev *) skb->dev;
714         struct btusb_data *data = hdev->driver_data;
715         struct usb_ctrlrequest *dr;
716         struct urb *urb;
717         unsigned int pipe;
718         int err;
719
720         BT_DBG("%s", hdev->name);
721
722         if (!test_bit(HCI_RUNNING, &hdev->flags))
723                 return -EBUSY;
724
725         switch (bt_cb(skb)->pkt_type) {
726         case HCI_COMMAND_PKT:
727                 urb = usb_alloc_urb(0, GFP_ATOMIC);
728                 if (!urb)
729                         return -ENOMEM;
730
731                 dr = kmalloc(sizeof(*dr), GFP_ATOMIC);
732                 if (!dr) {
733                         usb_free_urb(urb);
734                         return -ENOMEM;
735                 }
736
737                 dr->bRequestType = data->cmdreq_type;
738                 dr->bRequest     = 0;
739                 dr->wIndex       = 0;
740                 dr->wValue       = 0;
741                 dr->wLength      = __cpu_to_le16(skb->len);
742
743                 pipe = usb_sndctrlpipe(data->udev, 0x00);
744
745                 usb_fill_control_urb(urb, data->udev, pipe, (void *) dr,
746                                 skb->data, skb->len, btusb_tx_complete, skb);
747
748                 hdev->stat.cmd_tx++;
749                 break;
750
751         case HCI_ACLDATA_PKT:
752                 if (!data->bulk_tx_ep)
753                         return -ENODEV;
754
755                 urb = usb_alloc_urb(0, GFP_ATOMIC);
756                 if (!urb)
757                         return -ENOMEM;
758
759                 pipe = usb_sndbulkpipe(data->udev,
760                                         data->bulk_tx_ep->bEndpointAddress);
761
762                 usb_fill_bulk_urb(urb, data->udev, pipe,
763                                 skb->data, skb->len, btusb_tx_complete, skb);
764
765                 hdev->stat.acl_tx++;
766                 break;
767
768         case HCI_SCODATA_PKT:
769                 if (!data->isoc_tx_ep || hdev->conn_hash.sco_num < 1)
770                         return -ENODEV;
771
772                 urb = usb_alloc_urb(BTUSB_MAX_ISOC_FRAMES, GFP_ATOMIC);
773                 if (!urb)
774                         return -ENOMEM;
775
776                 pipe = usb_sndisocpipe(data->udev,
777                                         data->isoc_tx_ep->bEndpointAddress);
778
779                 usb_fill_int_urb(urb, data->udev, pipe,
780                                 skb->data, skb->len, btusb_isoc_tx_complete,
781                                 skb, data->isoc_tx_ep->bInterval);
782
783                 urb->transfer_flags  = URB_ISO_ASAP;
784
785                 __fill_isoc_descriptor(urb, skb->len,
786                                 le16_to_cpu(data->isoc_tx_ep->wMaxPacketSize));
787
788                 hdev->stat.sco_tx++;
789                 goto skip_waking;
790
791         default:
792                 return -EILSEQ;
793         }
794
795         err = inc_tx(data);
796         if (err) {
797                 usb_anchor_urb(urb, &data->deferred);
798                 schedule_work(&data->waker);
799                 err = 0;
800                 goto done;
801         }
802
803 skip_waking:
804         usb_anchor_urb(urb, &data->tx_anchor);
805
806         err = usb_submit_urb(urb, GFP_ATOMIC);
807         if (err < 0) {
808                 BT_ERR("%s urb %p submission failed", hdev->name, urb);
809                 kfree(urb->setup_packet);
810                 usb_unanchor_urb(urb);
811         } else {
812                 usb_mark_last_busy(data->udev);
813         }
814
815 done:
816         usb_free_urb(urb);
817         return err;
818 }
819
820 static void btusb_destruct(struct hci_dev *hdev)
821 {
822         struct btusb_data *data = hdev->driver_data;
823
824         BT_DBG("%s", hdev->name);
825
826         kfree(data);
827 }
828
829 static void btusb_notify(struct hci_dev *hdev, unsigned int evt)
830 {
831         struct btusb_data *data = hdev->driver_data;
832
833         BT_DBG("%s evt %d", hdev->name, evt);
834
835         if (hdev->conn_hash.sco_num != data->sco_num) {
836                 data->sco_num = hdev->conn_hash.sco_num;
837                 schedule_work(&data->work);
838         }
839 }
840
841 static inline int __set_isoc_interface(struct hci_dev *hdev, int altsetting)
842 {
843         struct btusb_data *data = hdev->driver_data;
844         struct usb_interface *intf = data->isoc;
845         struct usb_endpoint_descriptor *ep_desc;
846         int i, err;
847
848         if (!data->isoc)
849                 return -ENODEV;
850
851         err = usb_set_interface(data->udev, 1, altsetting);
852         if (err < 0) {
853                 BT_ERR("%s setting interface failed (%d)", hdev->name, -err);
854                 return err;
855         }
856
857         data->isoc_altsetting = altsetting;
858
859         data->isoc_tx_ep = NULL;
860         data->isoc_rx_ep = NULL;
861
862         for (i = 0; i < intf->cur_altsetting->desc.bNumEndpoints; i++) {
863                 ep_desc = &intf->cur_altsetting->endpoint[i].desc;
864
865                 if (!data->isoc_tx_ep && usb_endpoint_is_isoc_out(ep_desc)) {
866                         data->isoc_tx_ep = ep_desc;
867                         continue;
868                 }
869
870                 if (!data->isoc_rx_ep && usb_endpoint_is_isoc_in(ep_desc)) {
871                         data->isoc_rx_ep = ep_desc;
872                         continue;
873                 }
874         }
875
876         if (!data->isoc_tx_ep || !data->isoc_rx_ep) {
877                 BT_ERR("%s invalid SCO descriptors", hdev->name);
878                 return -ENODEV;
879         }
880
881         return 0;
882 }
883
884 static void btusb_work(struct work_struct *work)
885 {
886         struct btusb_data *data = container_of(work, struct btusb_data, work);
887         struct hci_dev *hdev = data->hdev;
888         int err;
889
890         if (hdev->conn_hash.sco_num > 0) {
891                 if (!test_bit(BTUSB_DID_ISO_RESUME, &data->flags)) {
892                         err = usb_autopm_get_interface(data->isoc ? data->isoc : data->intf);
893                         if (err < 0) {
894                                 clear_bit(BTUSB_ISOC_RUNNING, &data->flags);
895                                 usb_kill_anchored_urbs(&data->isoc_anchor);
896                                 return;
897                         }
898
899                         set_bit(BTUSB_DID_ISO_RESUME, &data->flags);
900                 }
901                 if (data->isoc_altsetting != 2) {
902                         clear_bit(BTUSB_ISOC_RUNNING, &data->flags);
903                         usb_kill_anchored_urbs(&data->isoc_anchor);
904
905                         if (__set_isoc_interface(hdev, 2) < 0)
906                                 return;
907                 }
908
909                 if (!test_and_set_bit(BTUSB_ISOC_RUNNING, &data->flags)) {
910                         if (btusb_submit_isoc_urb(hdev, GFP_KERNEL) < 0)
911                                 clear_bit(BTUSB_ISOC_RUNNING, &data->flags);
912                         else
913                                 btusb_submit_isoc_urb(hdev, GFP_KERNEL);
914                 }
915         } else {
916                 clear_bit(BTUSB_ISOC_RUNNING, &data->flags);
917                 usb_kill_anchored_urbs(&data->isoc_anchor);
918
919                 __set_isoc_interface(hdev, 0);
920                 if (test_and_clear_bit(BTUSB_DID_ISO_RESUME, &data->flags))
921                         usb_autopm_put_interface(data->isoc ? data->isoc : data->intf);
922         }
923 }
924
925 static void btusb_waker(struct work_struct *work)
926 {
927         struct btusb_data *data = container_of(work, struct btusb_data, waker);
928         int err;
929
930         err = usb_autopm_get_interface(data->intf);
931         if (err < 0)
932                 return;
933
934         usb_autopm_put_interface(data->intf);
935 }
936
937 static int btusb_probe(struct usb_interface *intf,
938                                 const struct usb_device_id *id)
939 {
940         struct usb_endpoint_descriptor *ep_desc;
941         struct btusb_data *data;
942         struct hci_dev *hdev;
943         int i, err;
944
945         BT_DBG("intf %p id %p", intf, id);
946
947         /* interface numbers are hardcoded in the spec */
948         if (intf->cur_altsetting->desc.bInterfaceNumber != 0)
949                 return -ENODEV;
950
951         if (!id->driver_info) {
952                 const struct usb_device_id *match;
953                 match = usb_match_id(intf, blacklist_table);
954                 if (match)
955                         id = match;
956         }
957
958         if (id->driver_info == BTUSB_IGNORE)
959                 return -ENODEV;
960
961         if (ignore_dga && id->driver_info & BTUSB_DIGIANSWER)
962                 return -ENODEV;
963
964         if (ignore_csr && id->driver_info & BTUSB_CSR)
965                 return -ENODEV;
966
967         if (ignore_sniffer && id->driver_info & BTUSB_SNIFFER)
968                 return -ENODEV;
969
970         if (id->driver_info & BTUSB_ATH3012) {
971                 struct usb_device *udev = interface_to_usbdev(intf);
972
973                 /* Old firmware would otherwise let ath3k driver load
974                  * patch and sysconfig files */
975                 if (le16_to_cpu(udev->descriptor.bcdDevice) <= 0x0001)
976                         return -ENODEV;
977         }
978
979         data = kzalloc(sizeof(*data), GFP_KERNEL);
980         if (!data)
981                 return -ENOMEM;
982
983         for (i = 0; i < intf->cur_altsetting->desc.bNumEndpoints; i++) {
984                 ep_desc = &intf->cur_altsetting->endpoint[i].desc;
985
986                 if (!data->intr_ep && usb_endpoint_is_int_in(ep_desc)) {
987                         data->intr_ep = ep_desc;
988                         continue;
989                 }
990
991                 if (!data->bulk_tx_ep && usb_endpoint_is_bulk_out(ep_desc)) {
992                         data->bulk_tx_ep = ep_desc;
993                         continue;
994                 }
995
996                 if (!data->bulk_rx_ep && usb_endpoint_is_bulk_in(ep_desc)) {
997                         data->bulk_rx_ep = ep_desc;
998                         continue;
999                 }
1000         }
1001
1002         if (!data->intr_ep || !data->bulk_tx_ep || !data->bulk_rx_ep) {
1003                 kfree(data);
1004                 return -ENODEV;
1005         }
1006
1007         data->cmdreq_type = USB_TYPE_CLASS;
1008
1009         data->udev = interface_to_usbdev(intf);
1010         data->intf = intf;
1011
1012         spin_lock_init(&data->lock);
1013
1014         INIT_WORK(&data->work, btusb_work);
1015         INIT_WORK(&data->waker, btusb_waker);
1016         spin_lock_init(&data->txlock);
1017
1018         init_usb_anchor(&data->tx_anchor);
1019         init_usb_anchor(&data->intr_anchor);
1020         init_usb_anchor(&data->bulk_anchor);
1021         init_usb_anchor(&data->isoc_anchor);
1022         init_usb_anchor(&data->deferred);
1023
1024         hdev = hci_alloc_dev();
1025         if (!hdev) {
1026                 kfree(data);
1027                 return -ENOMEM;
1028         }
1029
1030         hdev->bus = HCI_USB;
1031         hdev->driver_data = data;
1032
1033         data->hdev = hdev;
1034
1035         SET_HCIDEV_DEV(hdev, &intf->dev);
1036
1037         hdev->open     = btusb_open;
1038         hdev->close    = btusb_close;
1039         hdev->flush    = btusb_flush;
1040         hdev->send     = btusb_send_frame;
1041         hdev->destruct = btusb_destruct;
1042         hdev->notify   = btusb_notify;
1043
1044         hdev->owner = THIS_MODULE;
1045
1046         /* Interface numbers are hardcoded in the specification */
1047         data->isoc = usb_ifnum_to_if(data->udev, 1);
1048
1049         if (!reset)
1050                 set_bit(HCI_QUIRK_NO_RESET, &hdev->quirks);
1051
1052         if (force_scofix || id->driver_info & BTUSB_WRONG_SCO_MTU) {
1053                 if (!disable_scofix)
1054                         set_bit(HCI_QUIRK_FIXUP_BUFFER_SIZE, &hdev->quirks);
1055         }
1056
1057         if (id->driver_info & BTUSB_BROKEN_ISOC)
1058                 data->isoc = NULL;
1059
1060         if (id->driver_info & BTUSB_DIGIANSWER) {
1061                 data->cmdreq_type = USB_TYPE_VENDOR;
1062                 set_bit(HCI_QUIRK_NO_RESET, &hdev->quirks);
1063         }
1064
1065         if (id->driver_info & BTUSB_CSR) {
1066                 struct usb_device *udev = data->udev;
1067
1068                 /* Old firmware would otherwise execute USB reset */
1069                 if (le16_to_cpu(udev->descriptor.bcdDevice) < 0x117)
1070                         set_bit(HCI_QUIRK_NO_RESET, &hdev->quirks);
1071         }
1072
1073         if (id->driver_info & BTUSB_SNIFFER) {
1074                 struct usb_device *udev = data->udev;
1075
1076                 /* New sniffer firmware has crippled HCI interface */
1077                 if (le16_to_cpu(udev->descriptor.bcdDevice) > 0x997)
1078                         set_bit(HCI_QUIRK_RAW_DEVICE, &hdev->quirks);
1079
1080                 data->isoc = NULL;
1081         }
1082
1083         if (id->driver_info & BTUSB_BCM92035) {
1084                 unsigned char cmd[] = { 0x3b, 0xfc, 0x01, 0x00 };
1085                 struct sk_buff *skb;
1086
1087                 skb = bt_skb_alloc(sizeof(cmd), GFP_KERNEL);
1088                 if (skb) {
1089                         memcpy(skb_put(skb, sizeof(cmd)), cmd, sizeof(cmd));
1090                         skb_queue_tail(&hdev->driver_init, skb);
1091                 }
1092         }
1093
1094         if (data->isoc) {
1095                 err = usb_driver_claim_interface(&btusb_driver,
1096                                                         data->isoc, data);
1097                 if (err < 0) {
1098                         hci_free_dev(hdev);
1099                         kfree(data);
1100                         return err;
1101                 }
1102         }
1103
1104         err = hci_register_dev(hdev);
1105         if (err < 0) {
1106                 hci_free_dev(hdev);
1107                 kfree(data);
1108                 return err;
1109         }
1110
1111         usb_set_intfdata(intf, data);
1112
1113         return 0;
1114 }
1115
1116 static void btusb_disconnect(struct usb_interface *intf)
1117 {
1118         struct btusb_data *data = usb_get_intfdata(intf);
1119         struct hci_dev *hdev;
1120
1121         BT_DBG("intf %p", intf);
1122
1123         if (!data)
1124                 return;
1125
1126         hdev = data->hdev;
1127
1128         __hci_dev_hold(hdev);
1129
1130         usb_set_intfdata(data->intf, NULL);
1131
1132         if (data->isoc)
1133                 usb_set_intfdata(data->isoc, NULL);
1134
1135         hci_unregister_dev(hdev);
1136
1137         if (intf == data->isoc)
1138                 usb_driver_release_interface(&btusb_driver, data->intf);
1139         else if (data->isoc)
1140                 usb_driver_release_interface(&btusb_driver, data->isoc);
1141
1142         __hci_dev_put(hdev);
1143
1144         hci_free_dev(hdev);
1145 }
1146
1147 #ifdef CONFIG_PM
1148 static int btusb_suspend(struct usb_interface *intf, pm_message_t message)
1149 {
1150         struct btusb_data *data = usb_get_intfdata(intf);
1151
1152         BT_DBG("intf %p", intf);
1153
1154         if (data->suspend_count++)
1155                 return 0;
1156
1157         spin_lock_irq(&data->txlock);
1158         if (!(PMSG_IS_AUTO(message) && data->tx_in_flight)) {
1159                 set_bit(BTUSB_SUSPENDING, &data->flags);
1160                 spin_unlock_irq(&data->txlock);
1161         } else {
1162                 spin_unlock_irq(&data->txlock);
1163                 data->suspend_count--;
1164                 return -EBUSY;
1165         }
1166
1167         cancel_work_sync(&data->work);
1168
1169         btusb_stop_traffic(data);
1170         usb_kill_anchored_urbs(&data->tx_anchor);
1171
1172         return 0;
1173 }
1174
1175 static void play_deferred(struct btusb_data *data)
1176 {
1177         struct urb *urb;
1178         int err;
1179
1180         while ((urb = usb_get_from_anchor(&data->deferred))) {
1181                 err = usb_submit_urb(urb, GFP_ATOMIC);
1182                 if (err < 0)
1183                         break;
1184
1185                 data->tx_in_flight++;
1186         }
1187         usb_scuttle_anchored_urbs(&data->deferred);
1188 }
1189
1190 static int btusb_resume(struct usb_interface *intf)
1191 {
1192         struct btusb_data *data = usb_get_intfdata(intf);
1193         struct hci_dev *hdev = data->hdev;
1194         int err = 0;
1195
1196         BT_DBG("intf %p", intf);
1197
1198         if (--data->suspend_count)
1199                 return 0;
1200
1201         if (!test_bit(HCI_RUNNING, &hdev->flags))
1202                 goto done;
1203
1204         if (test_bit(BTUSB_INTR_RUNNING, &data->flags)) {
1205                 err = btusb_submit_intr_urb(hdev, GFP_NOIO);
1206                 if (err < 0) {
1207                         clear_bit(BTUSB_INTR_RUNNING, &data->flags);
1208                         goto failed;
1209                 }
1210         }
1211
1212         if (test_bit(BTUSB_BULK_RUNNING, &data->flags)) {
1213                 err = btusb_submit_bulk_urb(hdev, GFP_NOIO);
1214                 if (err < 0) {
1215                         clear_bit(BTUSB_BULK_RUNNING, &data->flags);
1216                         goto failed;
1217                 }
1218
1219                 btusb_submit_bulk_urb(hdev, GFP_NOIO);
1220         }
1221
1222         if (test_bit(BTUSB_ISOC_RUNNING, &data->flags)) {
1223                 if (btusb_submit_isoc_urb(hdev, GFP_NOIO) < 0)
1224                         clear_bit(BTUSB_ISOC_RUNNING, &data->flags);
1225                 else
1226                         btusb_submit_isoc_urb(hdev, GFP_NOIO);
1227         }
1228
1229         spin_lock_irq(&data->txlock);
1230         play_deferred(data);
1231         clear_bit(BTUSB_SUSPENDING, &data->flags);
1232         spin_unlock_irq(&data->txlock);
1233         schedule_work(&data->work);
1234
1235         return 0;
1236
1237 failed:
1238         usb_scuttle_anchored_urbs(&data->deferred);
1239 done:
1240         spin_lock_irq(&data->txlock);
1241         clear_bit(BTUSB_SUSPENDING, &data->flags);
1242         spin_unlock_irq(&data->txlock);
1243
1244         return err;
1245 }
1246 #endif
1247
1248 static struct usb_driver btusb_driver = {
1249         .name           = "btusb",
1250         .probe          = btusb_probe,
1251         .disconnect     = btusb_disconnect,
1252 #ifdef CONFIG_PM
1253         .suspend        = btusb_suspend,
1254         .resume         = btusb_resume,
1255 #endif
1256         .id_table       = btusb_table,
1257         .supports_autosuspend = 1,
1258 };
1259
1260 static int __init btusb_init(void)
1261 {
1262         BT_INFO("Generic Bluetooth USB driver ver %s", VERSION);
1263
1264         return usb_register(&btusb_driver);
1265 }
1266
1267 static void __exit btusb_exit(void)
1268 {
1269         usb_deregister(&btusb_driver);
1270 }
1271
1272 module_init(btusb_init);
1273 module_exit(btusb_exit);
1274
1275 module_param(ignore_dga, bool, 0644);
1276 MODULE_PARM_DESC(ignore_dga, "Ignore devices with id 08fd:0001");
1277
1278 module_param(ignore_csr, bool, 0644);
1279 MODULE_PARM_DESC(ignore_csr, "Ignore devices with id 0a12:0001");
1280
1281 module_param(ignore_sniffer, bool, 0644);
1282 MODULE_PARM_DESC(ignore_sniffer, "Ignore devices with id 0a12:0002");
1283
1284 module_param(disable_scofix, bool, 0644);
1285 MODULE_PARM_DESC(disable_scofix, "Disable fixup of wrong SCO buffer size");
1286
1287 module_param(force_scofix, bool, 0644);
1288 MODULE_PARM_DESC(force_scofix, "Force fixup of wrong SCO buffers size");
1289
1290 module_param(reset, bool, 0644);
1291 MODULE_PARM_DESC(reset, "Send HCI reset command on initialization");
1292
1293 MODULE_AUTHOR("Marcel Holtmann <marcel@holtmann.org>");
1294 MODULE_DESCRIPTION("Generic Bluetooth USB driver ver " VERSION);
1295 MODULE_VERSION(VERSION);
1296 MODULE_LICENSE("GPL");