]> git.karo-electronics.de Git - karo-tx-linux.git/blob - drivers/usb/serial/keyspan_pda.c
Merge git://git.infradead.org/users/willy/linux-nvme
[karo-tx-linux.git] / drivers / usb / serial / keyspan_pda.c
1 /*
2  * USB Keyspan PDA / Xircom / Entregra Converter driver
3  *
4  * Copyright (C) 1999 - 2001 Greg Kroah-Hartman <greg@kroah.com>
5  * Copyright (C) 1999, 2000 Brian Warner        <warner@lothar.com>
6  * Copyright (C) 2000 Al Borchers               <borchers@steinerpoint.com>
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  * See Documentation/usb/usb-serial.txt for more information on using this
14  * driver
15  */
16
17
18 #include <linux/kernel.h>
19 #include <linux/errno.h>
20 #include <linux/init.h>
21 #include <linux/slab.h>
22 #include <linux/tty.h>
23 #include <linux/tty_driver.h>
24 #include <linux/tty_flip.h>
25 #include <linux/module.h>
26 #include <linux/spinlock.h>
27 #include <linux/workqueue.h>
28 #include <linux/uaccess.h>
29 #include <linux/usb.h>
30 #include <linux/usb/serial.h>
31 #include <linux/usb/ezusb.h>
32
33 /* make a simple define to handle if we are compiling keyspan_pda or xircom support */
34 #if defined(CONFIG_USB_SERIAL_KEYSPAN_PDA) || defined(CONFIG_USB_SERIAL_KEYSPAN_PDA_MODULE)
35         #define KEYSPAN
36 #else
37         #undef KEYSPAN
38 #endif
39 #if defined(CONFIG_USB_SERIAL_XIRCOM) || defined(CONFIG_USB_SERIAL_XIRCOM_MODULE)
40         #define XIRCOM
41 #else
42         #undef XIRCOM
43 #endif
44
45 #define DRIVER_AUTHOR "Brian Warner <warner@lothar.com>"
46 #define DRIVER_DESC "USB Keyspan PDA Converter driver"
47
48 struct keyspan_pda_private {
49         int                     tx_room;
50         int                     tx_throttled;
51         struct work_struct                      wakeup_work;
52         struct work_struct                      unthrottle_work;
53         struct usb_serial       *serial;
54         struct usb_serial_port  *port;
55 };
56
57
58 #define KEYSPAN_VENDOR_ID               0x06cd
59 #define KEYSPAN_PDA_FAKE_ID             0x0103
60 #define KEYSPAN_PDA_ID                  0x0104 /* no clue */
61
62 /* For Xircom PGSDB9 and older Entregra version of the same device */
63 #define XIRCOM_VENDOR_ID                0x085a
64 #define XIRCOM_FAKE_ID                  0x8027
65 #define ENTREGRA_VENDOR_ID              0x1645
66 #define ENTREGRA_FAKE_ID                0x8093
67
68 static const struct usb_device_id id_table_combined[] = {
69 #ifdef KEYSPAN
70         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_FAKE_ID) },
71 #endif
72 #ifdef XIRCOM
73         { USB_DEVICE(XIRCOM_VENDOR_ID, XIRCOM_FAKE_ID) },
74         { USB_DEVICE(ENTREGRA_VENDOR_ID, ENTREGRA_FAKE_ID) },
75 #endif
76         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_ID) },
77         { }                                             /* Terminating entry */
78 };
79
80 MODULE_DEVICE_TABLE(usb, id_table_combined);
81
82 static const struct usb_device_id id_table_std[] = {
83         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_ID) },
84         { }                                             /* Terminating entry */
85 };
86
87 #ifdef KEYSPAN
88 static const struct usb_device_id id_table_fake[] = {
89         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_FAKE_ID) },
90         { }                                             /* Terminating entry */
91 };
92 #endif
93
94 #ifdef XIRCOM
95 static const struct usb_device_id id_table_fake_xircom[] = {
96         { USB_DEVICE(XIRCOM_VENDOR_ID, XIRCOM_FAKE_ID) },
97         { USB_DEVICE(ENTREGRA_VENDOR_ID, ENTREGRA_FAKE_ID) },
98         { }
99 };
100 #endif
101
102 static void keyspan_pda_wakeup_write(struct work_struct *work)
103 {
104         struct keyspan_pda_private *priv =
105                 container_of(work, struct keyspan_pda_private, wakeup_work);
106         struct usb_serial_port *port = priv->port;
107         struct tty_struct *tty = tty_port_tty_get(&port->port);
108         if (tty)
109                 tty_wakeup(tty);
110         tty_kref_put(tty);
111 }
112
113 static void keyspan_pda_request_unthrottle(struct work_struct *work)
114 {
115         struct keyspan_pda_private *priv =
116                 container_of(work, struct keyspan_pda_private, unthrottle_work);
117         struct usb_serial *serial = priv->serial;
118         int result;
119
120         /* ask the device to tell us when the tx buffer becomes
121            sufficiently empty */
122         result = usb_control_msg(serial->dev,
123                                  usb_sndctrlpipe(serial->dev, 0),
124                                  7, /* request_unthrottle */
125                                  USB_TYPE_VENDOR | USB_RECIP_INTERFACE
126                                  | USB_DIR_OUT,
127                                  16, /* value: threshold */
128                                  0, /* index */
129                                  NULL,
130                                  0,
131                                  2000);
132         if (result < 0)
133                 dev_dbg(&serial->dev->dev, "%s - error %d from usb_control_msg\n",
134                         __func__, result);
135 }
136
137
138 static void keyspan_pda_rx_interrupt(struct urb *urb)
139 {
140         struct usb_serial_port *port = urb->context;
141         unsigned char *data = urb->transfer_buffer;
142         int retval;
143         int status = urb->status;
144         struct keyspan_pda_private *priv;
145         priv = usb_get_serial_port_data(port);
146
147         switch (status) {
148         case 0:
149                 /* success */
150                 break;
151         case -ECONNRESET:
152         case -ENOENT:
153         case -ESHUTDOWN:
154                 /* this urb is terminated, clean up */
155                 dev_dbg(&urb->dev->dev, "%s - urb shutting down with status: %d\n", __func__, status);
156                 return;
157         default:
158                 dev_dbg(&urb->dev->dev, "%s - nonzero urb status received: %d\n", __func__, status);
159                 goto exit;
160         }
161
162         /* see if the message is data or a status interrupt */
163         switch (data[0]) {
164         case 0:
165                  /* rest of message is rx data */
166                 if (urb->actual_length) {
167                         tty_insert_flip_string(&port->port, data + 1,
168                                                 urb->actual_length - 1);
169                         tty_flip_buffer_push(&port->port);
170                 }
171                 break;
172         case 1:
173                 /* status interrupt */
174                 dev_dbg(&port->dev, "rx int, d1=%d, d2=%d\n", data[1], data[2]);
175                 switch (data[1]) {
176                 case 1: /* modemline change */
177                         break;
178                 case 2: /* tx unthrottle interrupt */
179                         priv->tx_throttled = 0;
180                         /* queue up a wakeup at scheduler time */
181                         schedule_work(&priv->wakeup_work);
182                         break;
183                 default:
184                         break;
185                 }
186                 break;
187         default:
188                 break;
189         }
190
191 exit:
192         retval = usb_submit_urb(urb, GFP_ATOMIC);
193         if (retval)
194                 dev_err(&port->dev,
195                         "%s - usb_submit_urb failed with result %d",
196                         __func__, retval);
197 }
198
199
200 static void keyspan_pda_rx_throttle(struct tty_struct *tty)
201 {
202         /* stop receiving characters. We just turn off the URB request, and
203            let chars pile up in the device. If we're doing hardware
204            flowcontrol, the device will signal the other end when its buffer
205            fills up. If we're doing XON/XOFF, this would be a good time to
206            send an XOFF, although it might make sense to foist that off
207            upon the device too. */
208         struct usb_serial_port *port = tty->driver_data;
209
210         usb_kill_urb(port->interrupt_in_urb);
211 }
212
213
214 static void keyspan_pda_rx_unthrottle(struct tty_struct *tty)
215 {
216         struct usb_serial_port *port = tty->driver_data;
217         /* just restart the receive interrupt URB */
218
219         if (usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL))
220                 dev_dbg(&port->dev, "usb_submit_urb(read urb) failed\n");
221 }
222
223
224 static speed_t keyspan_pda_setbaud(struct usb_serial *serial, speed_t baud)
225 {
226         int rc;
227         int bindex;
228
229         switch (baud) {
230         case 110:
231                 bindex = 0;
232                 break;
233         case 300:
234                 bindex = 1;
235                 break;
236         case 1200:
237                 bindex = 2;
238                 break;
239         case 2400:
240                 bindex = 3;
241                 break;
242         case 4800:
243                 bindex = 4;
244                 break;
245         case 9600:
246                 bindex = 5;
247                 break;
248         case 19200:
249                 bindex = 6;
250                 break;
251         case 38400:
252                 bindex = 7;
253                 break;
254         case 57600:
255                 bindex = 8;
256                 break;
257         case 115200:
258                 bindex = 9;
259                 break;
260         default:
261                 bindex = 5;     /* Default to 9600 */
262                 baud = 9600;
263         }
264
265         /* rather than figure out how to sleep while waiting for this
266            to complete, I just use the "legacy" API. */
267         rc = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
268                              0, /* set baud */
269                              USB_TYPE_VENDOR
270                              | USB_RECIP_INTERFACE
271                              | USB_DIR_OUT, /* type */
272                              bindex, /* value */
273                              0, /* index */
274                              NULL, /* &data */
275                              0, /* size */
276                              2000); /* timeout */
277         if (rc < 0)
278                 return 0;
279         return baud;
280 }
281
282
283 static void keyspan_pda_break_ctl(struct tty_struct *tty, int break_state)
284 {
285         struct usb_serial_port *port = tty->driver_data;
286         struct usb_serial *serial = port->serial;
287         int value;
288         int result;
289
290         if (break_state == -1)
291                 value = 1; /* start break */
292         else
293                 value = 0; /* clear break */
294         result = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
295                         4, /* set break */
296                         USB_TYPE_VENDOR | USB_RECIP_INTERFACE | USB_DIR_OUT,
297                         value, 0, NULL, 0, 2000);
298         if (result < 0)
299                 dev_dbg(&port->dev, "%s - error %d from usb_control_msg\n",
300                         __func__, result);
301         /* there is something funky about this.. the TCSBRK that 'cu' performs
302            ought to translate into a break_ctl(-1),break_ctl(0) pair HZ/4
303            seconds apart, but it feels like the break sent isn't as long as it
304            is on /dev/ttyS0 */
305 }
306
307
308 static void keyspan_pda_set_termios(struct tty_struct *tty,
309                 struct usb_serial_port *port, struct ktermios *old_termios)
310 {
311         struct usb_serial *serial = port->serial;
312         speed_t speed;
313
314         /* cflag specifies lots of stuff: number of stop bits, parity, number
315            of data bits, baud. What can the device actually handle?:
316            CSTOPB (1 stop bit or 2)
317            PARENB (parity)
318            CSIZE (5bit .. 8bit)
319            There is minimal hw support for parity (a PSW bit seems to hold the
320            parity of whatever is in the accumulator). The UART either deals
321            with 10 bits (start, 8 data, stop) or 11 bits (start, 8 data,
322            1 special, stop). So, with firmware changes, we could do:
323            8N1: 10 bit
324            8N2: 11 bit, extra bit always (mark?)
325            8[EOMS]1: 11 bit, extra bit is parity
326            7[EOMS]1: 10 bit, b0/b7 is parity
327            7[EOMS]2: 11 bit, b0/b7 is parity, extra bit always (mark?)
328
329            HW flow control is dictated by the tty->termios.c_cflags & CRTSCTS
330            bit.
331
332            For now, just do baud. */
333
334         speed = tty_get_baud_rate(tty);
335         speed = keyspan_pda_setbaud(serial, speed);
336
337         if (speed == 0) {
338                 dev_dbg(&port->dev, "can't handle requested baud rate\n");
339                 /* It hasn't changed so.. */
340                 speed = tty_termios_baud_rate(old_termios);
341         }
342         /* Only speed can change so copy the old h/w parameters
343            then encode the new speed */
344         tty_termios_copy_hw(&tty->termios, old_termios);
345         tty_encode_baud_rate(tty, speed, speed);
346 }
347
348
349 /* modem control pins: DTR and RTS are outputs and can be controlled.
350    DCD, RI, DSR, CTS are inputs and can be read. All outputs can also be
351    read. The byte passed is: DTR(b7) DCD RI DSR CTS RTS(b2) unused unused */
352
353 static int keyspan_pda_get_modem_info(struct usb_serial *serial,
354                                       unsigned char *value)
355 {
356         int rc;
357         u8 *data;
358
359         data = kmalloc(1, GFP_KERNEL);
360         if (!data)
361                 return -ENOMEM;
362
363         rc = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
364                              3, /* get pins */
365                              USB_TYPE_VENDOR|USB_RECIP_INTERFACE|USB_DIR_IN,
366                              0, 0, data, 1, 2000);
367         if (rc >= 0)
368                 *value = *data;
369
370         kfree(data);
371         return rc;
372 }
373
374
375 static int keyspan_pda_set_modem_info(struct usb_serial *serial,
376                                       unsigned char value)
377 {
378         int rc;
379         rc = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
380                              3, /* set pins */
381                              USB_TYPE_VENDOR|USB_RECIP_INTERFACE|USB_DIR_OUT,
382                              value, 0, NULL, 0, 2000);
383         return rc;
384 }
385
386 static int keyspan_pda_tiocmget(struct tty_struct *tty)
387 {
388         struct usb_serial_port *port = tty->driver_data;
389         struct usb_serial *serial = port->serial;
390         int rc;
391         unsigned char status;
392         int value;
393
394         rc = keyspan_pda_get_modem_info(serial, &status);
395         if (rc < 0)
396                 return rc;
397         value =
398                 ((status & (1<<7)) ? TIOCM_DTR : 0) |
399                 ((status & (1<<6)) ? TIOCM_CAR : 0) |
400                 ((status & (1<<5)) ? TIOCM_RNG : 0) |
401                 ((status & (1<<4)) ? TIOCM_DSR : 0) |
402                 ((status & (1<<3)) ? TIOCM_CTS : 0) |
403                 ((status & (1<<2)) ? TIOCM_RTS : 0);
404         return value;
405 }
406
407 static int keyspan_pda_tiocmset(struct tty_struct *tty,
408                                 unsigned int set, unsigned int clear)
409 {
410         struct usb_serial_port *port = tty->driver_data;
411         struct usb_serial *serial = port->serial;
412         int rc;
413         unsigned char status;
414
415         rc = keyspan_pda_get_modem_info(serial, &status);
416         if (rc < 0)
417                 return rc;
418
419         if (set & TIOCM_RTS)
420                 status |= (1<<2);
421         if (set & TIOCM_DTR)
422                 status |= (1<<7);
423
424         if (clear & TIOCM_RTS)
425                 status &= ~(1<<2);
426         if (clear & TIOCM_DTR)
427                 status &= ~(1<<7);
428         rc = keyspan_pda_set_modem_info(serial, status);
429         return rc;
430 }
431
432 static int keyspan_pda_write(struct tty_struct *tty,
433         struct usb_serial_port *port, const unsigned char *buf, int count)
434 {
435         struct usb_serial *serial = port->serial;
436         int request_unthrottle = 0;
437         int rc = 0;
438         struct keyspan_pda_private *priv;
439
440         priv = usb_get_serial_port_data(port);
441         /* guess how much room is left in the device's ring buffer, and if we
442            want to send more than that, check first, updating our notion of
443            what is left. If our write will result in no room left, ask the
444            device to give us an interrupt when the room available rises above
445            a threshold, and hold off all writers (eventually, those using
446            select() or poll() too) until we receive that unthrottle interrupt.
447            Block if we can't write anything at all, otherwise write as much as
448            we can. */
449         if (count == 0) {
450                 dev_dbg(&port->dev, "write request of 0 bytes\n");
451                 return 0;
452         }
453
454         /* we might block because of:
455            the TX urb is in-flight (wait until it completes)
456            the device is full (wait until it says there is room)
457         */
458         spin_lock_bh(&port->lock);
459         if (!test_bit(0, &port->write_urbs_free) || priv->tx_throttled) {
460                 spin_unlock_bh(&port->lock);
461                 return 0;
462         }
463         clear_bit(0, &port->write_urbs_free);
464         spin_unlock_bh(&port->lock);
465
466         /* At this point the URB is in our control, nobody else can submit it
467            again (the only sudden transition was the one from EINPROGRESS to
468            finished).  Also, the tx process is not throttled. So we are
469            ready to write. */
470
471         count = (count > port->bulk_out_size) ? port->bulk_out_size : count;
472
473         /* Check if we might overrun the Tx buffer.   If so, ask the
474            device how much room it really has.  This is done only on
475            scheduler time, since usb_control_msg() sleeps. */
476         if (count > priv->tx_room && !in_interrupt()) {
477                 u8 *room;
478
479                 room = kmalloc(1, GFP_KERNEL);
480                 if (!room) {
481                         rc = -ENOMEM;
482                         goto exit;
483                 }
484
485                 rc = usb_control_msg(serial->dev,
486                                      usb_rcvctrlpipe(serial->dev, 0),
487                                      6, /* write_room */
488                                      USB_TYPE_VENDOR | USB_RECIP_INTERFACE
489                                      | USB_DIR_IN,
490                                      0, /* value: 0 means "remaining room" */
491                                      0, /* index */
492                                      room,
493                                      1,
494                                      2000);
495                 if (rc > 0) {
496                         dev_dbg(&port->dev, "roomquery says %d\n", *room);
497                         priv->tx_room = *room;
498                 }
499                 kfree(room);
500                 if (rc < 0) {
501                         dev_dbg(&port->dev, "roomquery failed\n");
502                         goto exit;
503                 }
504                 if (rc == 0) {
505                         dev_dbg(&port->dev, "roomquery returned 0 bytes\n");
506                         rc = -EIO; /* device didn't return any data */
507                         goto exit;
508                 }
509         }
510         if (count > priv->tx_room) {
511                 /* we're about to completely fill the Tx buffer, so
512                    we'll be throttled afterwards. */
513                 count = priv->tx_room;
514                 request_unthrottle = 1;
515         }
516
517         if (count) {
518                 /* now transfer data */
519                 memcpy(port->write_urb->transfer_buffer, buf, count);
520                 /* send the data out the bulk port */
521                 port->write_urb->transfer_buffer_length = count;
522
523                 priv->tx_room -= count;
524
525                 rc = usb_submit_urb(port->write_urb, GFP_ATOMIC);
526                 if (rc) {
527                         dev_dbg(&port->dev, "usb_submit_urb(write bulk) failed\n");
528                         goto exit;
529                 }
530         } else {
531                 /* There wasn't any room left, so we are throttled until
532                    the buffer empties a bit */
533                 request_unthrottle = 1;
534         }
535
536         if (request_unthrottle) {
537                 priv->tx_throttled = 1; /* block writers */
538                 schedule_work(&priv->unthrottle_work);
539         }
540
541         rc = count;
542 exit:
543         if (rc < 0)
544                 set_bit(0, &port->write_urbs_free);
545         return rc;
546 }
547
548
549 static void keyspan_pda_write_bulk_callback(struct urb *urb)
550 {
551         struct usb_serial_port *port = urb->context;
552         struct keyspan_pda_private *priv;
553
554         set_bit(0, &port->write_urbs_free);
555         priv = usb_get_serial_port_data(port);
556
557         /* queue up a wakeup at scheduler time */
558         schedule_work(&priv->wakeup_work);
559 }
560
561
562 static int keyspan_pda_write_room(struct tty_struct *tty)
563 {
564         struct usb_serial_port *port = tty->driver_data;
565         struct keyspan_pda_private *priv;
566         priv = usb_get_serial_port_data(port);
567         /* used by n_tty.c for processing of tabs and such. Giving it our
568            conservative guess is probably good enough, but needs testing by
569            running a console through the device. */
570         return priv->tx_room;
571 }
572
573
574 static int keyspan_pda_chars_in_buffer(struct tty_struct *tty)
575 {
576         struct usb_serial_port *port = tty->driver_data;
577         struct keyspan_pda_private *priv;
578         unsigned long flags;
579         int ret = 0;
580
581         priv = usb_get_serial_port_data(port);
582
583         /* when throttled, return at least WAKEUP_CHARS to tell select() (via
584            n_tty.c:normal_poll() ) that we're not writeable. */
585
586         spin_lock_irqsave(&port->lock, flags);
587         if (!test_bit(0, &port->write_urbs_free) || priv->tx_throttled)
588                 ret = 256;
589         spin_unlock_irqrestore(&port->lock, flags);
590         return ret;
591 }
592
593
594 static void keyspan_pda_dtr_rts(struct usb_serial_port *port, int on)
595 {
596         struct usb_serial *serial = port->serial;
597
598         if (serial->dev) {
599                 if (on)
600                         keyspan_pda_set_modem_info(serial, (1<<7) | (1<< 2));
601                 else
602                         keyspan_pda_set_modem_info(serial, 0);
603         }
604 }
605
606
607 static int keyspan_pda_open(struct tty_struct *tty,
608                                         struct usb_serial_port *port)
609 {
610         struct usb_serial *serial = port->serial;
611         u8 *room;
612         int rc = 0;
613         struct keyspan_pda_private *priv;
614
615         /* find out how much room is in the Tx ring */
616         room = kmalloc(1, GFP_KERNEL);
617         if (!room)
618                 return -ENOMEM;
619
620         rc = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
621                              6, /* write_room */
622                              USB_TYPE_VENDOR | USB_RECIP_INTERFACE
623                              | USB_DIR_IN,
624                              0, /* value */
625                              0, /* index */
626                              room,
627                              1,
628                              2000);
629         if (rc < 0) {
630                 dev_dbg(&port->dev, "%s - roomquery failed\n", __func__);
631                 goto error;
632         }
633         if (rc == 0) {
634                 dev_dbg(&port->dev, "%s - roomquery returned 0 bytes\n", __func__);
635                 rc = -EIO;
636                 goto error;
637         }
638         priv = usb_get_serial_port_data(port);
639         priv->tx_room = *room;
640         priv->tx_throttled = *room ? 0 : 1;
641
642         /*Start reading from the device*/
643         rc = usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL);
644         if (rc) {
645                 dev_dbg(&port->dev, "%s - usb_submit_urb(read int) failed\n", __func__);
646                 goto error;
647         }
648 error:
649         kfree(room);
650         return rc;
651 }
652 static void keyspan_pda_close(struct usb_serial_port *port)
653 {
654         struct usb_serial *serial = port->serial;
655
656         if (serial->dev) {
657                 /* shutdown our bulk reads and writes */
658                 usb_kill_urb(port->write_urb);
659                 usb_kill_urb(port->interrupt_in_urb);
660         }
661 }
662
663
664 /* download the firmware to a "fake" device (pre-renumeration) */
665 static int keyspan_pda_fake_startup(struct usb_serial *serial)
666 {
667         int response;
668         const char *fw_name;
669
670         /* download the firmware here ... */
671         response = ezusb_fx1_set_reset(serial->dev, 1);
672
673         if (0) { ; }
674 #ifdef KEYSPAN
675         else if (le16_to_cpu(serial->dev->descriptor.idVendor) == KEYSPAN_VENDOR_ID)
676                 fw_name = "keyspan_pda/keyspan_pda.fw";
677 #endif
678 #ifdef XIRCOM
679         else if ((le16_to_cpu(serial->dev->descriptor.idVendor) == XIRCOM_VENDOR_ID) ||
680                  (le16_to_cpu(serial->dev->descriptor.idVendor) == ENTREGRA_VENDOR_ID))
681                 fw_name = "keyspan_pda/xircom_pgs.fw";
682 #endif
683         else {
684                 dev_err(&serial->dev->dev, "%s: unknown vendor, aborting.\n",
685                         __func__);
686                 return -ENODEV;
687         }
688
689         if (ezusb_fx1_ihex_firmware_download(serial->dev, fw_name) < 0) {
690                 dev_err(&serial->dev->dev, "failed to load firmware \"%s\"\n",
691                         fw_name);
692                 return -ENOENT;
693         }
694
695         /* after downloading firmware Renumeration will occur in a
696           moment and the new device will bind to the real driver */
697
698         /* we want this device to fail to have a driver assigned to it. */
699         return 1;
700 }
701
702 #ifdef KEYSPAN
703 MODULE_FIRMWARE("keyspan_pda/keyspan_pda.fw");
704 #endif
705 #ifdef XIRCOM
706 MODULE_FIRMWARE("keyspan_pda/xircom_pgs.fw");
707 #endif
708
709 static int keyspan_pda_port_probe(struct usb_serial_port *port)
710 {
711
712         struct keyspan_pda_private *priv;
713
714         priv = kmalloc(sizeof(struct keyspan_pda_private), GFP_KERNEL);
715         if (!priv)
716                 return -ENOMEM;
717
718         INIT_WORK(&priv->wakeup_work, keyspan_pda_wakeup_write);
719         INIT_WORK(&priv->unthrottle_work, keyspan_pda_request_unthrottle);
720         priv->serial = port->serial;
721         priv->port = port;
722
723         usb_set_serial_port_data(port, priv);
724
725         return 0;
726 }
727
728 static int keyspan_pda_port_remove(struct usb_serial_port *port)
729 {
730         struct keyspan_pda_private *priv;
731
732         priv = usb_get_serial_port_data(port);
733         kfree(priv);
734
735         return 0;
736 }
737
738 #ifdef KEYSPAN
739 static struct usb_serial_driver keyspan_pda_fake_device = {
740         .driver = {
741                 .owner =        THIS_MODULE,
742                 .name =         "keyspan_pda_pre",
743         },
744         .description =          "Keyspan PDA - (prerenumeration)",
745         .id_table =             id_table_fake,
746         .num_ports =            1,
747         .attach =               keyspan_pda_fake_startup,
748 };
749 #endif
750
751 #ifdef XIRCOM
752 static struct usb_serial_driver xircom_pgs_fake_device = {
753         .driver = {
754                 .owner =        THIS_MODULE,
755                 .name =         "xircom_no_firm",
756         },
757         .description =          "Xircom / Entregra PGS - (prerenumeration)",
758         .id_table =             id_table_fake_xircom,
759         .num_ports =            1,
760         .attach =               keyspan_pda_fake_startup,
761 };
762 #endif
763
764 static struct usb_serial_driver keyspan_pda_device = {
765         .driver = {
766                 .owner =        THIS_MODULE,
767                 .name =         "keyspan_pda",
768         },
769         .description =          "Keyspan PDA",
770         .id_table =             id_table_std,
771         .num_ports =            1,
772         .dtr_rts =              keyspan_pda_dtr_rts,
773         .open =                 keyspan_pda_open,
774         .close =                keyspan_pda_close,
775         .write =                keyspan_pda_write,
776         .write_room =           keyspan_pda_write_room,
777         .write_bulk_callback =  keyspan_pda_write_bulk_callback,
778         .read_int_callback =    keyspan_pda_rx_interrupt,
779         .chars_in_buffer =      keyspan_pda_chars_in_buffer,
780         .throttle =             keyspan_pda_rx_throttle,
781         .unthrottle =           keyspan_pda_rx_unthrottle,
782         .set_termios =          keyspan_pda_set_termios,
783         .break_ctl =            keyspan_pda_break_ctl,
784         .tiocmget =             keyspan_pda_tiocmget,
785         .tiocmset =             keyspan_pda_tiocmset,
786         .port_probe =           keyspan_pda_port_probe,
787         .port_remove =          keyspan_pda_port_remove,
788 };
789
790 static struct usb_serial_driver * const serial_drivers[] = {
791         &keyspan_pda_device,
792 #ifdef KEYSPAN
793         &keyspan_pda_fake_device,
794 #endif
795 #ifdef XIRCOM
796         &xircom_pgs_fake_device,
797 #endif
798         NULL
799 };
800
801 module_usb_serial_driver(serial_drivers, id_table_combined);
802
803 MODULE_AUTHOR(DRIVER_AUTHOR);
804 MODULE_DESCRIPTION(DRIVER_DESC);
805 MODULE_LICENSE("GPL");