vserver 1.9.3
[linux-2.6.git] / drivers / usb / serial / ipaq.c
1 /*
2  * USB Compaq iPAQ driver
3  *
4  *      Copyright (C) 2001 - 2002
5  *          Ganesh Varadarajan <ganesh@veritas.com>
6  *
7  *      This program is free software; you can redistribute it and/or modify
8  *      it under the terms of the GNU General Public License as published by
9  *      the Free Software Foundation; either version 2 of the License, or
10  *      (at your option) any later version.
11  *
12  * (12/12/2002) ganesh
13  *      Added support for practically all devices supported by ActiveSync
14  *      on Windows. Thanks to Wes Cilldhaire <billybobjoehenrybob@hotmail.com>.
15  *
16  * (26/11/2002) ganesh
17  *      Added insmod options to specify product and vendor id.
18  *      Use modprobe ipaq vendor=0xfoo product=0xbar
19  *
20  * (26/7/2002) ganesh
21  *      Fixed up broken error handling in ipaq_open. Retry the "kickstart"
22  *      packet much harder - this drastically reduces connection failures.
23  *
24  * (30/4/2002) ganesh
25  *      Added support for the Casio EM500. Completely untested. Thanks
26  *      to info from Nathan <wfilardo@fuse.net>
27  *
28  * (19/3/2002) ganesh
29  *      Don't submit urbs while holding spinlocks. Not strictly necessary
30  *      in 2.5.x.
31  *
32  * (8/3/2002) ganesh
33  *      The ipaq sometimes emits a '\0' before the CLIENT string. At this
34  *      point of time, the ppp ldisc is not yet attached to the tty, so
35  *      n_tty echoes "^ " to the ipaq, which messes up the chat. In 2.5.6-pre2
36  *      this causes a panic because echo_char() tries to sleep in interrupt
37  *      context.
38  *      The fix is to tell the upper layers that this is a raw device so that
39  *      echoing is suppressed. Thanks to Lyle Lindholm for a detailed bug
40  *      report.
41  *
42  * (25/2/2002) ganesh
43  *      Added support for the HP Jornada 548 and 568. Completely untested.
44  *      Thanks to info from Heath Robinson and Arieh Davidoff.
45  */
46
47 #include <linux/config.h>
48 #include <linux/kernel.h>
49 #include <linux/errno.h>
50 #include <linux/init.h>
51 #include <linux/slab.h>
52 #include <linux/tty.h>
53 #include <linux/tty_driver.h>
54 #include <linux/tty_flip.h>
55 #include <linux/module.h>
56 #include <linux/spinlock.h>
57 #include <asm/uaccess.h>
58 #include <linux/usb.h>
59 #include "usb-serial.h"
60 #include "ipaq.h"
61
62 #define KP_RETRIES      100
63
64 /*
65  * Version Information
66  */
67
68 #define DRIVER_VERSION "v0.5"
69 #define DRIVER_AUTHOR "Ganesh Varadarajan <ganesh@veritas.com>"
70 #define DRIVER_DESC "USB PocketPC PDA driver"
71
72 static __u16 product, vendor;
73 static int debug;
74
75 /* Function prototypes for an ipaq */
76 static int  ipaq_open (struct usb_serial_port *port, struct file *filp);
77 static void ipaq_close (struct usb_serial_port *port, struct file *filp);
78 static int  ipaq_startup (struct usb_serial *serial);
79 static void ipaq_shutdown (struct usb_serial *serial);
80 static int ipaq_write(struct usb_serial_port *port, int from_user, const unsigned char *buf,
81                        int count);
82 static int ipaq_write_bulk(struct usb_serial_port *port, int from_user, const unsigned char *buf,
83                            int count);
84 static void ipaq_write_gather(struct usb_serial_port *port);
85 static void ipaq_read_bulk_callback (struct urb *urb, struct pt_regs *regs);
86 static void ipaq_write_bulk_callback(struct urb *urb, struct pt_regs *regs);
87 static int ipaq_write_room(struct usb_serial_port *port);
88 static int ipaq_chars_in_buffer(struct usb_serial_port *port);
89 static void ipaq_destroy_lists(struct usb_serial_port *port);
90
91
92 static struct usb_device_id ipaq_id_table [] = {
93         /* The first entry is a placeholder for the insmod-specified device */
94         { USB_DEVICE(COMPAQ_VENDOR_ID, COMPAQ_IPAQ_ID) },
95         { USB_DEVICE(ASKEY_VENDOR_ID, ASKEY_PRODUCT_ID) },
96         { USB_DEVICE(BCOM_VENDOR_ID, BCOM_0065_ID) },
97         { USB_DEVICE(BCOM_VENDOR_ID, BCOM_0066_ID) },
98         { USB_DEVICE(BCOM_VENDOR_ID, BCOM_0067_ID) },
99         { USB_DEVICE(CASIO_VENDOR_ID, CASIO_2001_ID) },
100         { USB_DEVICE(CASIO_VENDOR_ID, CASIO_EM500_ID) },
101         { USB_DEVICE(COMPAQ_VENDOR_ID, COMPAQ_IPAQ_ID) },
102         { USB_DEVICE(COMPAQ_VENDOR_ID, COMPAQ_0032_ID) },
103         { USB_DEVICE(DELL_VENDOR_ID, DELL_AXIM_ID) },
104         { USB_DEVICE(FSC_VENDOR_ID, FSC_LOOX_ID) },
105         { USB_DEVICE(HP_VENDOR_ID, HP_JORNADA_548_ID) },
106         { USB_DEVICE(HP_VENDOR_ID, HP_JORNADA_568_ID) },
107         { USB_DEVICE(HP_VENDOR_ID, HP_2016_ID) },
108         { USB_DEVICE(HP_VENDOR_ID, HP_2116_ID) },
109         { USB_DEVICE(HP_VENDOR_ID, HP_2216_ID) },
110         { USB_DEVICE(HP_VENDOR_ID, HP_3016_ID) },
111         { USB_DEVICE(HP_VENDOR_ID, HP_3116_ID) },
112         { USB_DEVICE(HP_VENDOR_ID, HP_3216_ID) },
113         { USB_DEVICE(HP_VENDOR_ID, HP_4016_ID) },
114         { USB_DEVICE(HP_VENDOR_ID, HP_4116_ID) },
115         { USB_DEVICE(HP_VENDOR_ID, HP_4216_ID) },
116         { USB_DEVICE(HP_VENDOR_ID, HP_5016_ID) },
117         { USB_DEVICE(HP_VENDOR_ID, HP_5116_ID) },
118         { USB_DEVICE(HP_VENDOR_ID, HP_5216_ID) },
119         { USB_DEVICE(LINKUP_VENDOR_ID, LINKUP_PRODUCT_ID) },
120         { USB_DEVICE(MICROSOFT_VENDOR_ID, MICROSOFT_00CE_ID) },
121         { USB_DEVICE(PORTATEC_VENDOR_ID, PORTATEC_PRODUCT_ID) },
122         { USB_DEVICE(ROVER_VENDOR_ID, ROVER_P5_ID) },
123         { USB_DEVICE(SAGEM_VENDOR_ID, SAGEM_WIRELESS_ID) },
124         { USB_DEVICE(SOCKET_VENDOR_ID, SOCKET_PRODUCT_ID) },
125         { USB_DEVICE(TOSHIBA_VENDOR_ID, TOSHIBA_PRODUCT_ID) },
126         { USB_DEVICE(TOSHIBA_VENDOR_ID, TOSHIBA_E310_ID) },
127         { USB_DEVICE(TOSHIBA_VENDOR_ID, TOSHIBA_E740_ID) },
128         { USB_DEVICE(TOSHIBA_VENDOR_ID, TOSHIBA_E335_ID) },
129         { USB_DEVICE(HTC_VENDOR_ID, HTC_PRODUCT_ID) },
130         { USB_DEVICE(HTC_VENDOR_ID, HTC_HIMALAYA_ID) },
131         { USB_DEVICE(NEC_VENDOR_ID, NEC_PRODUCT_ID) },
132         { USB_DEVICE(ASUS_VENDOR_ID, ASUS_A600_PRODUCT_ID) },
133         { USB_DEVICE(ASUS_VENDOR_ID, ASUS_A620_PRODUCT_ID) },
134         { }                                     /* Terminating entry */
135 };
136
137 MODULE_DEVICE_TABLE (usb, ipaq_id_table);
138
139 static struct usb_driver ipaq_driver = {
140         .owner =        THIS_MODULE,
141         .name =         "ipaq",
142         .probe =        usb_serial_probe,
143         .disconnect =   usb_serial_disconnect,
144         .id_table =     ipaq_id_table,
145 };
146
147
148 /* All of the device info needed for the Compaq iPAQ */
149 static struct usb_serial_device_type ipaq_device = {
150         .owner =                THIS_MODULE,
151         .name =                 "PocketPC PDA",
152         .id_table =             ipaq_id_table,
153         .num_interrupt_in =     NUM_DONT_CARE,
154         .num_bulk_in =          1,
155         .num_bulk_out =         1,
156         .num_ports =            1,
157         .open =                 ipaq_open,
158         .close =                ipaq_close,
159         .attach =               ipaq_startup,
160         .shutdown =             ipaq_shutdown,
161         .write =                ipaq_write,
162         .write_room =           ipaq_write_room,
163         .chars_in_buffer =      ipaq_chars_in_buffer,
164         .read_bulk_callback =   ipaq_read_bulk_callback,
165         .write_bulk_callback =  ipaq_write_bulk_callback,
166 };
167
168 static spinlock_t       write_list_lock;
169 static int              bytes_in;
170 static int              bytes_out;
171
172 static int ipaq_open(struct usb_serial_port *port, struct file *filp)
173 {
174         struct usb_serial       *serial = port->serial;
175         struct ipaq_private     *priv;
176         struct ipaq_packet      *pkt;
177         int                     i, result = 0;
178         int                     retries = KP_RETRIES;
179
180         dbg("%s - port %d", __FUNCTION__, port->number);
181
182         bytes_in = 0;
183         bytes_out = 0;
184         priv = (struct ipaq_private *)kmalloc(sizeof(struct ipaq_private), GFP_KERNEL);
185         if (priv == NULL) {
186                 err("%s - Out of memory", __FUNCTION__);
187                 return -ENOMEM;
188         }
189         usb_set_serial_port_data(port, priv);
190         priv->active = 0;
191         priv->queue_len = 0;
192         priv->free_len = 0;
193         INIT_LIST_HEAD(&priv->queue);
194         INIT_LIST_HEAD(&priv->freelist);
195
196         for (i = 0; i < URBDATA_QUEUE_MAX / PACKET_SIZE; i++) {
197                 pkt = kmalloc(sizeof(struct ipaq_packet), GFP_KERNEL);
198                 if (pkt == NULL) {
199                         goto enomem;
200                 }
201                 pkt->data = kmalloc(PACKET_SIZE, GFP_KERNEL);
202                 if (pkt->data == NULL) {
203                         kfree(pkt);
204                         goto enomem;
205                 }
206                 pkt->len = 0;
207                 pkt->written = 0;
208                 INIT_LIST_HEAD(&pkt->list);
209                 list_add(&pkt->list, &priv->freelist);
210                 priv->free_len += PACKET_SIZE;
211         }
212
213         /*
214          * Force low latency on. This will immediately push data to the line
215          * discipline instead of queueing.
216          */
217
218         port->tty->low_latency = 1;
219         port->tty->raw = 1;
220         port->tty->real_raw = 1;
221
222         /*
223          * Lose the small buffers usbserial provides. Make larger ones.
224          */
225
226         kfree(port->bulk_in_buffer);
227         kfree(port->bulk_out_buffer);
228         port->bulk_in_buffer = kmalloc(URBDATA_SIZE, GFP_KERNEL);
229         if (port->bulk_in_buffer == NULL) {
230                 goto enomem;
231         }
232         port->bulk_out_buffer = kmalloc(URBDATA_SIZE, GFP_KERNEL);
233         if (port->bulk_out_buffer == NULL) {
234                 kfree(port->bulk_in_buffer);
235                 goto enomem;
236         }
237         port->read_urb->transfer_buffer = port->bulk_in_buffer;
238         port->write_urb->transfer_buffer = port->bulk_out_buffer;
239         port->read_urb->transfer_buffer_length = URBDATA_SIZE;
240         port->bulk_out_size = port->write_urb->transfer_buffer_length = URBDATA_SIZE;
241         
242         /* Start reading from the device */
243         usb_fill_bulk_urb(port->read_urb, serial->dev, 
244                       usb_rcvbulkpipe(serial->dev, port->bulk_in_endpointAddress),
245                       port->read_urb->transfer_buffer, port->read_urb->transfer_buffer_length,
246                       ipaq_read_bulk_callback, port);
247         result = usb_submit_urb(port->read_urb, GFP_KERNEL);
248         if (result) {
249                 err("%s - failed submitting read urb, error %d", __FUNCTION__, result);
250                 goto error;
251         }
252
253         /*
254          * Send out control message observed in win98 sniffs. Not sure what
255          * it does, but from empirical observations, it seems that the device
256          * will start the chat sequence once one of these messages gets
257          * through. Since this has a reasonably high failure rate, we retry
258          * several times.
259          */
260
261         while (retries--) {
262                 result = usb_control_msg(serial->dev,
263                                 usb_sndctrlpipe(serial->dev, 0), 0x22, 0x21,
264                                 0x1, 0, NULL, 0, HZ / 10 + 1);
265                 if (result == 0) {
266                         return 0;
267                 }
268         }
269         err("%s - failed doing control urb, error %d", __FUNCTION__, result);
270         goto error;
271
272 enomem:
273         result = -ENOMEM;
274         err("%s - Out of memory", __FUNCTION__);
275 error:
276         ipaq_destroy_lists(port);
277         kfree(priv);
278         return result;
279 }
280
281
282 static void ipaq_close(struct usb_serial_port *port, struct file *filp)
283 {
284         struct ipaq_private     *priv = usb_get_serial_port_data(port);
285
286         dbg("%s - port %d", __FUNCTION__, port->number);
287                          
288         /*
289          * shut down bulk read and write
290          */
291         usb_unlink_urb(port->write_urb);
292         usb_unlink_urb(port->read_urb);
293         ipaq_destroy_lists(port);
294         kfree(priv);
295         usb_set_serial_port_data(port, NULL);
296
297         /* Uncomment the following line if you want to see some statistics in your syslog */
298         /* info ("Bytes In = %d  Bytes Out = %d", bytes_in, bytes_out); */
299 }
300
301 static void ipaq_read_bulk_callback(struct urb *urb, struct pt_regs *regs)
302 {
303         struct usb_serial_port  *port = (struct usb_serial_port *)urb->context;
304         struct tty_struct       *tty;
305         unsigned char           *data = urb->transfer_buffer;
306         int                     i, result;
307
308         dbg("%s - port %d", __FUNCTION__, port->number);
309
310         if (urb->status) {
311                 dbg("%s - nonzero read bulk status received: %d", __FUNCTION__, urb->status);
312                 return;
313         }
314
315         usb_serial_debug_data(debug, &port->dev, __FUNCTION__, urb->actual_length, data);
316
317         tty = port->tty;
318         if (tty && urb->actual_length) {
319                 for (i = 0; i < urb->actual_length ; ++i) {
320                         /* if we insert more than TTY_FLIPBUF_SIZE characters, we drop them. */
321                         if(tty->flip.count >= TTY_FLIPBUF_SIZE) {
322                                 tty_flip_buffer_push(tty);
323                         }
324                         /* this doesn't actually push the data through unless tty->low_latency is set */
325                         tty_insert_flip_char(tty, data[i], 0);
326                 }
327                 tty_flip_buffer_push(tty);
328                 bytes_in += urb->actual_length;
329         }
330
331         /* Continue trying to always read  */
332         usb_fill_bulk_urb(port->read_urb, port->serial->dev, 
333                       usb_rcvbulkpipe(port->serial->dev, port->bulk_in_endpointAddress),
334                       port->read_urb->transfer_buffer, port->read_urb->transfer_buffer_length,
335                       ipaq_read_bulk_callback, port);
336         result = usb_submit_urb(port->read_urb, GFP_ATOMIC);
337         if (result)
338                 err("%s - failed resubmitting read urb, error %d", __FUNCTION__, result);
339         return;
340 }
341
342 static int ipaq_write(struct usb_serial_port *port, int from_user, const unsigned char *buf,
343                        int count)
344 {
345         const unsigned char     *current_position = buf;
346         int                     bytes_sent = 0;
347         int                     transfer_size;
348
349         dbg("%s - port %d", __FUNCTION__, port->number);
350
351         while (count > 0) {
352                 transfer_size = min(count, PACKET_SIZE);
353                 if (ipaq_write_bulk(port, from_user, current_position, transfer_size)) {
354                         break;
355                 }
356                 current_position += transfer_size;
357                 bytes_sent += transfer_size;
358                 count -= transfer_size;
359                 bytes_out += transfer_size;
360         }
361
362         return bytes_sent;
363
364
365 static int ipaq_write_bulk(struct usb_serial_port *port, int from_user, const unsigned char *buf,
366                            int count)
367 {
368         struct ipaq_private     *priv = usb_get_serial_port_data(port);
369         struct ipaq_packet      *pkt = NULL;
370         int                     result = 0;
371         unsigned long           flags;
372
373         if (priv->free_len <= 0) {
374                 dbg("%s - we're stuffed", __FUNCTION__);
375                 return -EAGAIN;
376         }
377
378         spin_lock_irqsave(&write_list_lock, flags);
379         if (!list_empty(&priv->freelist)) {
380                 pkt = list_entry(priv->freelist.next, struct ipaq_packet, list);
381                 list_del(&pkt->list);
382                 priv->free_len -= PACKET_SIZE;
383         }
384         spin_unlock_irqrestore(&write_list_lock, flags);
385         if (pkt == NULL) {
386                 dbg("%s - we're stuffed", __FUNCTION__);
387                 return -EAGAIN;
388         }
389
390         if (from_user) {
391                 if (copy_from_user(pkt->data, buf, count))
392                         return -EFAULT;
393         } else {
394                 memcpy(pkt->data, buf, count);
395         }
396         usb_serial_debug_data(debug, &port->dev, __FUNCTION__, count, pkt->data);
397
398         pkt->len = count;
399         pkt->written = 0;
400         spin_lock_irqsave(&write_list_lock, flags);
401         list_add_tail(&pkt->list, &priv->queue);
402         priv->queue_len += count;
403         if (priv->active == 0) {
404                 priv->active = 1;
405                 ipaq_write_gather(port);
406                 spin_unlock_irqrestore(&write_list_lock, flags);
407                 result = usb_submit_urb(port->write_urb, GFP_ATOMIC);
408                 if (result) {
409                         err("%s - failed submitting write urb, error %d", __FUNCTION__, result);
410                 }
411         } else {
412                 spin_unlock_irqrestore(&write_list_lock, flags);
413         }
414         return result;
415 }
416
417 static void ipaq_write_gather(struct usb_serial_port *port)
418 {
419         struct ipaq_private     *priv = usb_get_serial_port_data(port);
420         struct usb_serial       *serial = port->serial;
421         int                     count, room;
422         struct ipaq_packet      *pkt;
423         struct urb              *urb = port->write_urb;
424         struct list_head        *tmp;
425
426         if (urb->status == -EINPROGRESS) {
427                 /* Should never happen */
428                 err("%s - flushing while urb is active !", __FUNCTION__);
429                 return;
430         }
431         room = URBDATA_SIZE;
432         for (tmp = priv->queue.next; tmp != &priv->queue;) {
433                 pkt = list_entry(tmp, struct ipaq_packet, list);
434                 tmp = tmp->next;
435                 count = min(room, (int)(pkt->len - pkt->written));
436                 memcpy(urb->transfer_buffer + (URBDATA_SIZE - room),
437                        pkt->data + pkt->written, count);
438                 room -= count;
439                 pkt->written += count;
440                 priv->queue_len -= count;
441                 if (pkt->written == pkt->len) {
442                         list_move(&pkt->list, &priv->freelist);
443                         priv->free_len += PACKET_SIZE;
444                 }
445                 if (room == 0) {
446                         break;
447                 }
448         }
449
450         count = URBDATA_SIZE - room;
451         usb_fill_bulk_urb(port->write_urb, serial->dev, 
452                       usb_sndbulkpipe(serial->dev, port->bulk_out_endpointAddress),
453                       port->write_urb->transfer_buffer, count, ipaq_write_bulk_callback,
454                       port);
455         return;
456 }
457
458 static void ipaq_write_bulk_callback(struct urb *urb, struct pt_regs *regs)
459 {
460         struct usb_serial_port  *port = (struct usb_serial_port *)urb->context;
461         struct ipaq_private     *priv = usb_get_serial_port_data(port);
462         unsigned long           flags;
463         int                     result;
464
465         dbg("%s - port %d", __FUNCTION__, port->number);
466         
467         if (urb->status) {
468                 dbg("%s - nonzero write bulk status received: %d", __FUNCTION__, urb->status);
469         }
470
471         spin_lock_irqsave(&write_list_lock, flags);
472         if (!list_empty(&priv->queue)) {
473                 ipaq_write_gather(port);
474                 spin_unlock_irqrestore(&write_list_lock, flags);
475                 result = usb_submit_urb(port->write_urb, GFP_ATOMIC);
476                 if (result) {
477                         err("%s - failed submitting write urb, error %d", __FUNCTION__, result);
478                 }
479         } else {
480                 priv->active = 0;
481                 spin_unlock_irqrestore(&write_list_lock, flags);
482         }
483
484         schedule_work(&port->work);
485 }
486
487 static int ipaq_write_room(struct usb_serial_port *port)
488 {
489         struct ipaq_private     *priv = usb_get_serial_port_data(port);
490
491         dbg("%s - freelen %d", __FUNCTION__, priv->free_len);
492         return priv->free_len;
493 }
494
495 static int ipaq_chars_in_buffer(struct usb_serial_port *port)
496 {
497         struct ipaq_private     *priv = usb_get_serial_port_data(port);
498
499         dbg("%s - queuelen %d", __FUNCTION__, priv->queue_len);
500         return priv->queue_len;
501 }
502
503 static void ipaq_destroy_lists(struct usb_serial_port *port)
504 {
505         struct ipaq_private     *priv = usb_get_serial_port_data(port);
506         struct list_head        *tmp;
507         struct ipaq_packet      *pkt;
508
509         for (tmp = priv->queue.next; tmp != &priv->queue;) {
510                 pkt = list_entry(tmp, struct ipaq_packet, list);
511                 tmp = tmp->next;
512                 kfree(pkt->data);
513                 kfree(pkt);
514         }
515         for (tmp = priv->freelist.next; tmp != &priv->freelist;) {
516                 pkt = list_entry(tmp, struct ipaq_packet, list);
517                 tmp = tmp->next;
518                 kfree(pkt->data);
519                 kfree(pkt);
520         }
521         return;
522 }
523
524
525 static int ipaq_startup(struct usb_serial *serial)
526 {
527         dbg("%s", __FUNCTION__);
528         if (serial->dev->actconfig->desc.bConfigurationValue != 1) {
529                 err("active config #%d != 1 ??",
530                         serial->dev->actconfig->desc.bConfigurationValue);
531                 return -ENODEV;
532         }
533         return usb_reset_configuration (serial->dev);
534 }
535
536 static void ipaq_shutdown(struct usb_serial *serial)
537 {
538         dbg("%s", __FUNCTION__);
539 }
540
541 static int __init ipaq_init(void)
542 {
543         int retval;
544         spin_lock_init(&write_list_lock);
545         retval = usb_serial_register(&ipaq_device);
546         if (retval) 
547                 goto failed_usb_serial_register;
548         info(DRIVER_DESC " " DRIVER_VERSION);
549         if (vendor) {
550                 ipaq_id_table[0].idVendor = vendor;
551                 ipaq_id_table[0].idProduct = product;
552         }
553         retval = usb_register(&ipaq_driver);
554         if (retval)
555                 goto failed_usb_register;
556                   
557         return 0;
558 failed_usb_register:
559         usb_serial_deregister(&ipaq_device);
560 failed_usb_serial_register:
561         return retval;
562 }
563
564
565 static void __exit ipaq_exit(void)
566 {
567         usb_deregister(&ipaq_driver);
568         usb_serial_deregister(&ipaq_device);
569 }
570
571
572 module_init(ipaq_init);
573 module_exit(ipaq_exit);
574
575 MODULE_AUTHOR( DRIVER_AUTHOR );
576 MODULE_DESCRIPTION( DRIVER_DESC );
577 MODULE_LICENSE("GPL");
578
579 module_param(debug, bool, S_IRUGO | S_IWUSR);
580 MODULE_PARM_DESC(debug, "Debug enabled or not");
581
582 module_param(vendor, ushort, 0);
583 MODULE_PARM_DESC(vendor, "User specified USB idVendor");
584
585 module_param(product, ushort, 0);
586 MODULE_PARM_DESC(product, "User specified USB idProduct");