Merge git://git.skbuff.net/gitroot/yoshfuji/linux-2.6.14+advapi-fix/
[linux-2.6] / 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 driver
14  * 
15  * (09/07/2001) gkh
16  *      cleaned up the Xircom support.  Added ids for Entregra device which is
17  *      the same as the Xircom device.  Enabled the code to be compiled for
18  *      either Xircom or Keyspan devices.
19  *
20  * (08/11/2001) Cristian M. Craciunescu
21  *      support for Xircom PGSDB9
22  *
23  * (05/31/2001) gkh
24  *      switched from using spinlock to a semaphore, which fixes lots of problems.
25  *
26  * (04/08/2001) gb
27  *      Identify version on module load.
28  * 
29  * (11/01/2000) Adam J. Richter
30  *      usb_device_id table support
31  * 
32  * (10/05/2000) gkh
33  *      Fixed bug with urb->dev not being set properly, now that the usb
34  *      core needs it.
35  * 
36  * (08/28/2000) gkh
37  *      Added locks for SMP safeness.
38  *      Fixed MOD_INC and MOD_DEC logic and the ability to open a port more 
39  *      than once.
40  * 
41  * (07/20/2000) borchers
42  *      - keyspan_pda_write no longer sleeps if it is called on interrupt time;
43  *        PPP and the line discipline with stty echo on can call write on
44  *        interrupt time and this would cause an oops if write slept
45  *      - if keyspan_pda_write is in an interrupt, it will not call
46  *        usb_control_msg (which sleeps) to query the room in the device
47  *        buffer, it simply uses the current room value it has
48  *      - if the urb is busy or if it is throttled keyspan_pda_write just
49  *        returns 0, rather than sleeping to wait for this to change; the
50  *        write_chan code in n_tty.c will sleep if needed before calling
51  *        keyspan_pda_write again
52  *      - if the device needs to be unthrottled, write now queues up the
53  *        call to usb_control_msg (which sleeps) to unthrottle the device
54  *      - the wakeups from keyspan_pda_write_bulk_callback are queued rather
55  *        than done directly from the callback to avoid the race in write_chan
56  *      - keyspan_pda_chars_in_buffer also indicates its buffer is full if the
57  *        urb status is -EINPROGRESS, meaning it cannot write at the moment
58  *      
59  * (07/19/2000) gkh
60  *      Added module_init and module_exit functions to handle the fact that this
61  *      driver is a loadable module now.
62  *
63  * (03/26/2000) gkh
64  *      Split driver up into device specific pieces.
65  * 
66  */
67
68
69 #include <linux/config.h>
70 #include <linux/kernel.h>
71 #include <linux/errno.h>
72 #include <linux/init.h>
73 #include <linux/slab.h>
74 #include <linux/tty.h>
75 #include <linux/tty_driver.h>
76 #include <linux/tty_flip.h>
77 #include <linux/module.h>
78 #include <linux/spinlock.h>
79 #include <linux/workqueue.h>
80 #include <asm/uaccess.h>
81 #include <linux/usb.h>
82
83 static int debug;
84
85 struct ezusb_hex_record {
86         __u16 address;
87         __u8 data_size;
88         __u8 data[16];
89 };
90
91 /* make a simple define to handle if we are compiling keyspan_pda or xircom support */
92 #if defined(CONFIG_USB_SERIAL_KEYSPAN_PDA) || defined(CONFIG_USB_SERIAL_KEYSPAN_PDA_MODULE)
93         #define KEYSPAN
94 #else
95         #undef KEYSPAN
96 #endif
97 #if defined(CONFIG_USB_SERIAL_XIRCOM) || defined(CONFIG_USB_SERIAL_XIRCOM_MODULE)
98         #define XIRCOM
99 #else
100         #undef XIRCOM
101 #endif
102
103 #ifdef KEYSPAN
104 #include "keyspan_pda_fw.h"
105 #endif
106
107 #ifdef XIRCOM
108 #include "xircom_pgs_fw.h"
109 #endif
110
111 #include "usb-serial.h"
112
113 /*
114  * Version Information
115  */
116 #define DRIVER_VERSION "v1.1"
117 #define DRIVER_AUTHOR "Brian Warner <warner@lothar.com>"
118 #define DRIVER_DESC "USB Keyspan PDA Converter driver"
119
120 struct keyspan_pda_private {
121         int                     tx_room;
122         int                     tx_throttled;
123         struct work_struct                      wakeup_work;
124         struct work_struct                      unthrottle_work;
125 };
126
127
128 #define KEYSPAN_VENDOR_ID               0x06cd
129 #define KEYSPAN_PDA_FAKE_ID             0x0103
130 #define KEYSPAN_PDA_ID                  0x0104 /* no clue */
131
132 /* For Xircom PGSDB9 and older Entregra version of the same device */
133 #define XIRCOM_VENDOR_ID                0x085a
134 #define XIRCOM_FAKE_ID                  0x8027
135 #define ENTREGRA_VENDOR_ID              0x1645
136 #define ENTREGRA_FAKE_ID                0x8093
137
138 static struct usb_device_id id_table_combined [] = {
139 #ifdef KEYSPAN
140         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_FAKE_ID) },
141 #endif
142 #ifdef XIRCOM
143         { USB_DEVICE(XIRCOM_VENDOR_ID, XIRCOM_FAKE_ID) },
144         { USB_DEVICE(ENTREGRA_VENDOR_ID, ENTREGRA_FAKE_ID) },
145 #endif
146         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_ID) },
147         { }                                             /* Terminating entry */
148 };
149
150 MODULE_DEVICE_TABLE (usb, id_table_combined);
151
152 static struct usb_driver keyspan_pda_driver = {
153         .owner =        THIS_MODULE,
154         .name =         "keyspan_pda",
155         .probe =        usb_serial_probe,
156         .disconnect =   usb_serial_disconnect,
157         .id_table =     id_table_combined,
158 };
159
160 static struct usb_device_id id_table_std [] = {
161         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_ID) },
162         { }                                             /* Terminating entry */
163 };
164
165 #ifdef KEYSPAN
166 static struct usb_device_id id_table_fake [] = {
167         { USB_DEVICE(KEYSPAN_VENDOR_ID, KEYSPAN_PDA_FAKE_ID) },
168         { }                                             /* Terminating entry */
169 };
170 #endif
171
172 #ifdef XIRCOM
173 static struct usb_device_id id_table_fake_xircom [] = {
174         { USB_DEVICE(XIRCOM_VENDOR_ID, XIRCOM_FAKE_ID) },
175         { USB_DEVICE(ENTREGRA_VENDOR_ID, ENTREGRA_FAKE_ID) },
176         { }                                             
177 };
178 #endif
179
180 static void keyspan_pda_wakeup_write( struct usb_serial_port *port )
181 {
182
183         struct tty_struct *tty = port->tty;
184
185         /* wake up port processes */
186         wake_up_interruptible( &port->write_wait );
187
188         /* wake up line discipline */
189         tty_wakeup(tty);
190 }
191
192 static void keyspan_pda_request_unthrottle( struct usb_serial *serial )
193 {
194         int result;
195
196         dbg(" request_unthrottle");
197         /* ask the device to tell us when the tx buffer becomes
198            sufficiently empty */
199         result = usb_control_msg(serial->dev, 
200                                  usb_sndctrlpipe(serial->dev, 0),
201                                  7, /* request_unthrottle */
202                                  USB_TYPE_VENDOR | USB_RECIP_INTERFACE
203                                  | USB_DIR_OUT,
204                                  16, /* value: threshold */
205                                  0, /* index */
206                                  NULL,
207                                  0,
208                                  2000);
209         if (result < 0)
210                 dbg("%s - error %d from usb_control_msg", 
211                     __FUNCTION__, result);
212 }
213
214
215 static void keyspan_pda_rx_interrupt (struct urb *urb, struct pt_regs *regs)
216 {
217         struct usb_serial_port *port = (struct usb_serial_port *)urb->context;
218         struct tty_struct *tty = port->tty;
219         unsigned char *data = urb->transfer_buffer;
220         int i;
221         int status;
222         struct keyspan_pda_private *priv;
223         priv = usb_get_serial_port_data(port);
224
225         switch (urb->status) {
226         case 0:
227                 /* success */
228                 break;
229         case -ECONNRESET:
230         case -ENOENT:
231         case -ESHUTDOWN:
232                 /* this urb is terminated, clean up */
233                 dbg("%s - urb shutting down with status: %d", __FUNCTION__, urb->status);
234                 return;
235         default:
236                 dbg("%s - nonzero urb status received: %d", __FUNCTION__, urb->status);
237                 goto exit;
238         }
239
240         /* see if the message is data or a status interrupt */
241         switch (data[0]) {
242         case 0:
243                 /* rest of message is rx data */
244                 if (urb->actual_length) {
245                         for (i = 1; i < urb->actual_length ; ++i) {
246                                 tty_insert_flip_char(tty, data[i], 0);
247                         }
248                         tty_flip_buffer_push(tty);
249                 }
250                 break;
251         case 1:
252                 /* status interrupt */
253                 dbg(" rx int, d1=%d, d2=%d", data[1], data[2]);
254                 switch (data[1]) {
255                 case 1: /* modemline change */
256                         break;
257                 case 2: /* tx unthrottle interrupt */
258                         priv->tx_throttled = 0;
259                         /* queue up a wakeup at scheduler time */
260                         schedule_work(&priv->wakeup_work);
261                         break;
262                 default:
263                         break;
264                 }
265                 break;
266         default:
267                 break;
268         }
269
270 exit:
271         status = usb_submit_urb (urb, GFP_ATOMIC);
272         if (status)
273                 err ("%s - usb_submit_urb failed with result %d",
274                      __FUNCTION__, status);
275 }
276
277
278 static void keyspan_pda_rx_throttle (struct usb_serial_port *port)
279 {
280         /* stop receiving characters. We just turn off the URB request, and
281            let chars pile up in the device. If we're doing hardware
282            flowcontrol, the device will signal the other end when its buffer
283            fills up. If we're doing XON/XOFF, this would be a good time to
284            send an XOFF, although it might make sense to foist that off
285            upon the device too. */
286
287         dbg("keyspan_pda_rx_throttle port %d", port->number);
288         usb_kill_urb(port->interrupt_in_urb);
289 }
290
291
292 static void keyspan_pda_rx_unthrottle (struct usb_serial_port *port)
293 {
294         /* just restart the receive interrupt URB */
295         dbg("keyspan_pda_rx_unthrottle port %d", port->number);
296         port->interrupt_in_urb->dev = port->serial->dev;
297         if (usb_submit_urb(port->interrupt_in_urb, GFP_ATOMIC))
298                 dbg(" usb_submit_urb(read urb) failed");
299         return;
300 }
301
302
303 static int keyspan_pda_setbaud (struct usb_serial *serial, int baud)
304 {
305         int rc;
306         int bindex;
307
308         switch(baud) {
309                 case 110: bindex = 0; break;
310                 case 300: bindex = 1; break;
311                 case 1200: bindex = 2; break;
312                 case 2400: bindex = 3; break;
313                 case 4800: bindex = 4; break;
314                 case 9600: bindex = 5; break;
315                 case 19200: bindex = 6; break;
316                 case 38400: bindex = 7; break;
317                 case 57600: bindex = 8; break;
318                 case 115200: bindex = 9; break;
319                 default: return -EINVAL;
320         }
321
322         /* rather than figure out how to sleep while waiting for this
323            to complete, I just use the "legacy" API. */
324         rc = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
325                              0, /* set baud */
326                              USB_TYPE_VENDOR 
327                              | USB_RECIP_INTERFACE
328                              | USB_DIR_OUT, /* type */
329                              bindex, /* value */
330                              0, /* index */
331                              NULL, /* &data */
332                              0, /* size */
333                              2000); /* timeout */
334         return(rc);
335 }
336
337
338 static void keyspan_pda_break_ctl (struct usb_serial_port *port, int break_state)
339 {
340         struct usb_serial *serial = port->serial;
341         int value;
342         int result;
343
344         if (break_state == -1)
345                 value = 1; /* start break */
346         else
347                 value = 0; /* clear break */
348         result = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
349                                 4, /* set break */
350                                 USB_TYPE_VENDOR | USB_RECIP_INTERFACE | USB_DIR_OUT,
351                                 value, 0, NULL, 0, 2000);
352         if (result < 0)
353                 dbg("%s - error %d from usb_control_msg", 
354                     __FUNCTION__, result);
355         /* there is something funky about this.. the TCSBRK that 'cu' performs
356            ought to translate into a break_ctl(-1),break_ctl(0) pair HZ/4
357            seconds apart, but it feels like the break sent isn't as long as it
358            is on /dev/ttyS0 */
359 }
360
361
362 static void keyspan_pda_set_termios (struct usb_serial_port *port, 
363                                      struct termios *old_termios)
364 {
365         struct usb_serial *serial = port->serial;
366         unsigned int cflag = port->tty->termios->c_cflag;
367
368         /* cflag specifies lots of stuff: number of stop bits, parity, number
369            of data bits, baud. What can the device actually handle?:
370            CSTOPB (1 stop bit or 2)
371            PARENB (parity)
372            CSIZE (5bit .. 8bit)
373            There is minimal hw support for parity (a PSW bit seems to hold the
374            parity of whatever is in the accumulator). The UART either deals
375            with 10 bits (start, 8 data, stop) or 11 bits (start, 8 data,
376            1 special, stop). So, with firmware changes, we could do:
377            8N1: 10 bit
378            8N2: 11 bit, extra bit always (mark?)
379            8[EOMS]1: 11 bit, extra bit is parity
380            7[EOMS]1: 10 bit, b0/b7 is parity
381            7[EOMS]2: 11 bit, b0/b7 is parity, extra bit always (mark?)
382
383            HW flow control is dictated by the tty->termios->c_cflags & CRTSCTS
384            bit.
385
386            For now, just do baud. */
387
388         switch (cflag & CBAUD) {
389                 /* we could support more values here, just need to calculate
390                    the necessary divisors in the firmware. <asm/termbits.h>
391                    has the Bnnn constants. */
392                 case B110: keyspan_pda_setbaud(serial, 110); break;
393                 case B300: keyspan_pda_setbaud(serial, 300); break;
394                 case B1200: keyspan_pda_setbaud(serial, 1200); break;
395                 case B2400: keyspan_pda_setbaud(serial, 2400); break;
396                 case B4800: keyspan_pda_setbaud(serial, 4800); break;
397                 case B9600: keyspan_pda_setbaud(serial, 9600); break;
398                 case B19200: keyspan_pda_setbaud(serial, 19200); break;
399                 case B38400: keyspan_pda_setbaud(serial, 38400); break;
400                 case B57600: keyspan_pda_setbaud(serial, 57600); break;
401                 case B115200: keyspan_pda_setbaud(serial, 115200); break;
402                 default: dbg("can't handle requested baud rate"); break;
403         }
404 }
405
406
407 /* modem control pins: DTR and RTS are outputs and can be controlled.
408    DCD, RI, DSR, CTS are inputs and can be read. All outputs can also be
409    read. The byte passed is: DTR(b7) DCD RI DSR CTS RTS(b2) unused unused */
410
411 static int keyspan_pda_get_modem_info(struct usb_serial *serial,
412                                       unsigned char *value)
413 {
414         int rc;
415         unsigned char data;
416         rc = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
417                              3, /* get pins */
418                              USB_TYPE_VENDOR|USB_RECIP_INTERFACE|USB_DIR_IN,
419                              0, 0, &data, 1, 2000);
420         if (rc > 0)
421                 *value = data;
422         return rc;
423 }
424
425
426 static int keyspan_pda_set_modem_info(struct usb_serial *serial,
427                                       unsigned char value)
428 {
429         int rc;
430         rc = usb_control_msg(serial->dev, usb_sndctrlpipe(serial->dev, 0),
431                              3, /* set pins */
432                              USB_TYPE_VENDOR|USB_RECIP_INTERFACE|USB_DIR_OUT,
433                              value, 0, NULL, 0, 2000);
434         return rc;
435 }
436
437 static int keyspan_pda_tiocmget(struct usb_serial_port *port, struct file *file)
438 {
439         struct usb_serial *serial = port->serial;
440         int rc;
441         unsigned char status;
442         int value;
443
444         rc = keyspan_pda_get_modem_info(serial, &status);
445         if (rc < 0)
446                 return rc;
447         value =
448                 ((status & (1<<7)) ? TIOCM_DTR : 0) |
449                 ((status & (1<<6)) ? TIOCM_CAR : 0) |
450                 ((status & (1<<5)) ? TIOCM_RNG : 0) |
451                 ((status & (1<<4)) ? TIOCM_DSR : 0) |
452                 ((status & (1<<3)) ? TIOCM_CTS : 0) |
453                 ((status & (1<<2)) ? TIOCM_RTS : 0);
454         return value;
455 }
456
457 static int keyspan_pda_tiocmset(struct usb_serial_port *port, struct file *file,
458                                 unsigned int set, unsigned int clear)
459 {
460         struct usb_serial *serial = port->serial;
461         int rc;
462         unsigned char status;
463
464         rc = keyspan_pda_get_modem_info(serial, &status);
465         if (rc < 0)
466                 return rc;
467
468         if (set & TIOCM_RTS)
469                 status |= (1<<2);
470         if (set & TIOCM_DTR)
471                 status |= (1<<7);
472
473         if (clear & TIOCM_RTS)
474                 status &= ~(1<<2);
475         if (clear & TIOCM_DTR)
476                 status &= ~(1<<7);
477         rc = keyspan_pda_set_modem_info(serial, status);
478         return rc;
479 }
480
481 static int keyspan_pda_ioctl(struct usb_serial_port *port, struct file *file,
482                              unsigned int cmd, unsigned long arg)
483 {
484         switch (cmd) {
485         case TIOCMIWAIT:
486                 /* wait for any of the 4 modem inputs (DCD,RI,DSR,CTS)*/
487                 /* TODO */
488         case TIOCGICOUNT:
489                 /* return count of modemline transitions */
490                 return 0; /* TODO */
491         }
492         
493         return -ENOIOCTLCMD;
494 }
495
496 static int keyspan_pda_write(struct usb_serial_port *port, 
497                              const unsigned char *buf, int count)
498 {
499         struct usb_serial *serial = port->serial;
500         int request_unthrottle = 0;
501         int rc = 0;
502         struct keyspan_pda_private *priv;
503
504         priv = usb_get_serial_port_data(port);
505         /* guess how much room is left in the device's ring buffer, and if we
506            want to send more than that, check first, updating our notion of
507            what is left. If our write will result in no room left, ask the
508            device to give us an interrupt when the room available rises above
509            a threshold, and hold off all writers (eventually, those using
510            select() or poll() too) until we receive that unthrottle interrupt.
511            Block if we can't write anything at all, otherwise write as much as
512            we can. */
513         dbg("keyspan_pda_write(%d)",count);
514         if (count == 0) {
515                 dbg(" write request of 0 bytes");
516                 return (0);
517         }
518
519         /* we might block because of:
520            the TX urb is in-flight (wait until it completes)
521            the device is full (wait until it says there is room)
522         */
523         spin_lock(&port->lock);
524         if (port->write_urb_busy || priv->tx_throttled) {
525                 spin_unlock(&port->lock);
526                 return 0;
527         }
528         port->write_urb_busy = 1;
529         spin_unlock(&port->lock);
530
531         /* At this point the URB is in our control, nobody else can submit it
532            again (the only sudden transition was the one from EINPROGRESS to
533            finished).  Also, the tx process is not throttled. So we are
534            ready to write. */
535
536         count = (count > port->bulk_out_size) ? port->bulk_out_size : count;
537
538         /* Check if we might overrun the Tx buffer.   If so, ask the
539            device how much room it really has.  This is done only on
540            scheduler time, since usb_control_msg() sleeps. */
541         if (count > priv->tx_room && !in_interrupt()) {
542                 unsigned char room;
543                 rc = usb_control_msg(serial->dev, 
544                                      usb_rcvctrlpipe(serial->dev, 0),
545                                      6, /* write_room */
546                                      USB_TYPE_VENDOR | USB_RECIP_INTERFACE
547                                      | USB_DIR_IN,
548                                      0, /* value: 0 means "remaining room" */
549                                      0, /* index */
550                                      &room,
551                                      1,
552                                      2000);
553                 if (rc < 0) {
554                         dbg(" roomquery failed");
555                         goto exit;
556                 }
557                 if (rc == 0) {
558                         dbg(" roomquery returned 0 bytes");
559                         rc = -EIO; /* device didn't return any data */
560                         goto exit;
561                 }
562                 dbg(" roomquery says %d", room);
563                 priv->tx_room = room;
564         }
565         if (count > priv->tx_room) {
566                 /* we're about to completely fill the Tx buffer, so
567                    we'll be throttled afterwards. */
568                 count = priv->tx_room;
569                 request_unthrottle = 1;
570         }
571
572         if (count) {
573                 /* now transfer data */
574                 memcpy (port->write_urb->transfer_buffer, buf, count);
575                 /* send the data out the bulk port */
576                 port->write_urb->transfer_buffer_length = count;
577
578                 priv->tx_room -= count;
579
580                 port->write_urb->dev = port->serial->dev;
581                 rc = usb_submit_urb(port->write_urb, GFP_ATOMIC);
582                 if (rc) {
583                         dbg(" usb_submit_urb(write bulk) failed");
584                         goto exit;
585                 }
586         }
587         else {
588                 /* There wasn't any room left, so we are throttled until
589                    the buffer empties a bit */
590                 request_unthrottle = 1;
591         }
592
593         if (request_unthrottle) {
594                 priv->tx_throttled = 1; /* block writers */
595                 schedule_work(&priv->unthrottle_work);
596         }
597
598         rc = count;
599 exit:
600         if (rc < 0)
601                 port->write_urb_busy = 0;
602         return rc;
603 }
604
605
606 static void keyspan_pda_write_bulk_callback (struct urb *urb, struct pt_regs *regs)
607 {
608         struct usb_serial_port *port = (struct usb_serial_port *)urb->context;
609         struct keyspan_pda_private *priv;
610
611         port->write_urb_busy = 0;
612         priv = usb_get_serial_port_data(port);
613
614         /* queue up a wakeup at scheduler time */
615         schedule_work(&priv->wakeup_work);
616 }
617
618
619 static int keyspan_pda_write_room (struct usb_serial_port *port)
620 {
621         struct keyspan_pda_private *priv;
622
623         priv = usb_get_serial_port_data(port);
624
625         /* used by n_tty.c for processing of tabs and such. Giving it our
626            conservative guess is probably good enough, but needs testing by
627            running a console through the device. */
628
629         return (priv->tx_room);
630 }
631
632
633 static int keyspan_pda_chars_in_buffer (struct usb_serial_port *port)
634 {
635         struct keyspan_pda_private *priv;
636
637         priv = usb_get_serial_port_data(port);
638
639         /* when throttled, return at least WAKEUP_CHARS to tell select() (via
640            n_tty.c:normal_poll() ) that we're not writeable. */
641         if (port->write_urb_busy || priv->tx_throttled)
642                 return 256;
643         return 0;
644 }
645
646
647 static int keyspan_pda_open (struct usb_serial_port *port, struct file *filp)
648 {
649         struct usb_serial *serial = port->serial;
650         unsigned char room;
651         int rc = 0;
652         struct keyspan_pda_private *priv;
653
654         /* find out how much room is in the Tx ring */
655         rc = usb_control_msg(serial->dev, usb_rcvctrlpipe(serial->dev, 0),
656                              6, /* write_room */
657                              USB_TYPE_VENDOR | USB_RECIP_INTERFACE
658                              | USB_DIR_IN,
659                              0, /* value */
660                              0, /* index */
661                              &room,
662                              1,
663                              2000);
664         if (rc < 0) {
665                 dbg("%s - roomquery failed", __FUNCTION__);
666                 goto error;
667         }
668         if (rc == 0) {
669                 dbg("%s - roomquery returned 0 bytes", __FUNCTION__);
670                 rc = -EIO;
671                 goto error;
672         }
673         priv = usb_get_serial_port_data(port);
674         priv->tx_room = room;
675         priv->tx_throttled = room ? 0 : 1;
676
677         /* the normal serial device seems to always turn on DTR and RTS here,
678            so do the same */
679         if (port->tty->termios->c_cflag & CBAUD)
680                 keyspan_pda_set_modem_info(serial, (1<<7) | (1<<2) );
681         else
682                 keyspan_pda_set_modem_info(serial, 0);
683
684         /*Start reading from the device*/
685         port->interrupt_in_urb->dev = serial->dev;
686         rc = usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL);
687         if (rc) {
688                 dbg("%s - usb_submit_urb(read int) failed", __FUNCTION__);
689                 goto error;
690         }
691
692 error:
693         return rc;
694 }
695
696
697 static void keyspan_pda_close(struct usb_serial_port *port, struct file *filp)
698 {
699         struct usb_serial *serial = port->serial;
700
701         if (serial->dev) {
702                 /* the normal serial device seems to always shut off DTR and RTS now */
703                 if (port->tty->termios->c_cflag & HUPCL)
704                         keyspan_pda_set_modem_info(serial, 0);
705
706                 /* shutdown our bulk reads and writes */
707                 usb_kill_urb(port->write_urb);
708                 usb_kill_urb(port->interrupt_in_urb);
709         }
710 }
711
712
713 /* download the firmware to a "fake" device (pre-renumeration) */
714 static int keyspan_pda_fake_startup (struct usb_serial *serial)
715 {
716         int response;
717         const struct ezusb_hex_record *record = NULL;
718
719         /* download the firmware here ... */
720         response = ezusb_set_reset(serial, 1);
721
722 #ifdef KEYSPAN
723         if (le16_to_cpu(serial->dev->descriptor.idVendor) == KEYSPAN_VENDOR_ID)
724                 record = &keyspan_pda_firmware[0];
725 #endif
726 #ifdef XIRCOM
727         if ((le16_to_cpu(serial->dev->descriptor.idVendor) == XIRCOM_VENDOR_ID) ||
728             (le16_to_cpu(serial->dev->descriptor.idVendor) == ENTREGRA_VENDOR_ID))
729                 record = &xircom_pgs_firmware[0];
730 #endif
731         if (record == NULL) {
732                 err("%s: unknown vendor, aborting.", __FUNCTION__);
733                 return -ENODEV;
734         }
735
736         while(record->address != 0xffff) {
737                 response = ezusb_writememory(serial, record->address,
738                                              (unsigned char *)record->data,
739                                              record->data_size, 0xa0);
740                 if (response < 0) {
741                         err("ezusb_writememory failed for Keyspan PDA "
742                             "firmware (%d %04X %p %d)",
743                             response, 
744                             record->address, record->data, record->data_size);
745                         break;
746                 }
747                 record++;
748         }
749         /* bring device out of reset. Renumeration will occur in a moment
750            and the new device will bind to the real driver */
751         response = ezusb_set_reset(serial, 0);
752
753         /* we want this device to fail to have a driver assigned to it. */
754         return (1);
755 }
756
757 static int keyspan_pda_startup (struct usb_serial *serial)
758 {
759
760         struct keyspan_pda_private *priv;
761
762         /* allocate the private data structures for all ports. Well, for all
763            one ports. */
764
765         priv = kmalloc(sizeof(struct keyspan_pda_private), GFP_KERNEL);
766         if (!priv)
767                 return (1); /* error */
768         usb_set_serial_port_data(serial->port[0], priv);
769         init_waitqueue_head(&serial->port[0]->write_wait);
770         INIT_WORK(&priv->wakeup_work, (void *)keyspan_pda_wakeup_write,
771                         (void *)(serial->port[0]));
772         INIT_WORK(&priv->unthrottle_work,
773                         (void *)keyspan_pda_request_unthrottle,
774                         (void *)(serial));
775         return (0);
776 }
777
778 static void keyspan_pda_shutdown (struct usb_serial *serial)
779 {
780         dbg("%s", __FUNCTION__);
781         
782         kfree(usb_get_serial_port_data(serial->port[0]));
783 }
784
785 #ifdef KEYSPAN
786 static struct usb_serial_driver keyspan_pda_fake_device = {
787         .driver = {
788                 .owner =        THIS_MODULE,
789                 .name =         "keyspan_pda_pre",
790         },
791         .description =          "Keyspan PDA - (prerenumeration)",
792         .id_table =             id_table_fake,
793         .num_interrupt_in =     NUM_DONT_CARE,
794         .num_bulk_in =          NUM_DONT_CARE,
795         .num_bulk_out =         NUM_DONT_CARE,
796         .num_ports =            1,
797         .attach =               keyspan_pda_fake_startup,
798 };
799 #endif
800
801 #ifdef XIRCOM
802 static struct usb_serial_driver xircom_pgs_fake_device = {
803         .driver = {
804                 .owner =        THIS_MODULE,
805                 .name =         "xircom_no_firm",
806         },
807         .description =          "Xircom / Entregra PGS - (prerenumeration)",
808         .id_table =             id_table_fake_xircom,
809         .num_interrupt_in =     NUM_DONT_CARE,
810         .num_bulk_in =          NUM_DONT_CARE,
811         .num_bulk_out =         NUM_DONT_CARE,
812         .num_ports =            1,
813         .attach =               keyspan_pda_fake_startup,
814 };
815 #endif
816
817 static struct usb_serial_driver keyspan_pda_device = {
818         .driver = {
819                 .owner =        THIS_MODULE,
820                 .name =         "keyspan_pda",
821         },
822         .description =          "Keyspan PDA",
823         .id_table =             id_table_std,
824         .num_interrupt_in =     1,
825         .num_bulk_in =          0,
826         .num_bulk_out =         1,
827         .num_ports =            1,
828         .open =                 keyspan_pda_open,
829         .close =                keyspan_pda_close,
830         .write =                keyspan_pda_write,
831         .write_room =           keyspan_pda_write_room,
832         .write_bulk_callback =  keyspan_pda_write_bulk_callback,
833         .read_int_callback =    keyspan_pda_rx_interrupt,
834         .chars_in_buffer =      keyspan_pda_chars_in_buffer,
835         .throttle =             keyspan_pda_rx_throttle,
836         .unthrottle =           keyspan_pda_rx_unthrottle,
837         .ioctl =                keyspan_pda_ioctl,
838         .set_termios =          keyspan_pda_set_termios,
839         .break_ctl =            keyspan_pda_break_ctl,
840         .tiocmget =             keyspan_pda_tiocmget,
841         .tiocmset =             keyspan_pda_tiocmset,
842         .attach =               keyspan_pda_startup,
843         .shutdown =             keyspan_pda_shutdown,
844 };
845
846
847 static int __init keyspan_pda_init (void)
848 {
849         int retval;
850         retval = usb_serial_register(&keyspan_pda_device);
851         if (retval)
852                 goto failed_pda_register;
853 #ifdef KEYSPAN
854         retval = usb_serial_register(&keyspan_pda_fake_device);
855         if (retval)
856                 goto failed_pda_fake_register;
857 #endif
858 #ifdef XIRCOM
859         retval = usb_serial_register(&xircom_pgs_fake_device);
860         if (retval)
861                 goto failed_xircom_register;
862 #endif
863         retval = usb_register(&keyspan_pda_driver);
864         if (retval)
865                 goto failed_usb_register;
866         info(DRIVER_DESC " " DRIVER_VERSION);
867         return 0;
868 failed_usb_register:    
869 #ifdef XIRCOM
870         usb_serial_deregister(&xircom_pgs_fake_device);
871 failed_xircom_register:
872 #endif /* XIRCOM */
873 #ifdef KEYSPAN
874         usb_serial_deregister(&keyspan_pda_fake_device);
875 #endif
876 #ifdef KEYSPAN
877 failed_pda_fake_register:
878 #endif
879         usb_serial_deregister(&keyspan_pda_device);
880 failed_pda_register:
881         return retval;
882 }
883
884
885 static void __exit keyspan_pda_exit (void)
886 {
887         usb_deregister (&keyspan_pda_driver);
888         usb_serial_deregister (&keyspan_pda_device);
889 #ifdef KEYSPAN
890         usb_serial_deregister (&keyspan_pda_fake_device);
891 #endif
892 #ifdef XIRCOM
893         usb_serial_deregister (&xircom_pgs_fake_device);
894 #endif
895 }
896
897
898 module_init(keyspan_pda_init);
899 module_exit(keyspan_pda_exit);
900
901 MODULE_AUTHOR( DRIVER_AUTHOR );
902 MODULE_DESCRIPTION( DRIVER_DESC );
903 MODULE_LICENSE("GPL");
904
905 module_param(debug, bool, S_IRUGO | S_IWUSR);
906 MODULE_PARM_DESC(debug, "Debug enabled or not");
907