]> Pileus Git - ~andy/linux/blob - drivers/usb/serial/whiteheat.c
USB: serial: clean up ioctl debugging
[~andy/linux] / drivers / usb / serial / whiteheat.c
1 /*
2  * USB ConnectTech WhiteHEAT driver
3  *
4  *      Copyright (C) 2002
5  *          Connect Tech Inc.
6  *
7  *      Copyright (C) 1999 - 2001
8  *          Greg Kroah-Hartman (greg@kroah.com)
9  *
10  *      This program is free software; you can redistribute it and/or modify
11  *      it under the terms of the GNU General Public License as published by
12  *      the Free Software Foundation; either version 2 of the License, or
13  *      (at your option) any later version.
14  *
15  * See Documentation/usb/usb-serial.txt for more information on using this
16  * driver
17  */
18
19 #include <linux/kernel.h>
20 #include <linux/errno.h>
21 #include <linux/init.h>
22 #include <linux/slab.h>
23 #include <linux/tty.h>
24 #include <linux/tty_driver.h>
25 #include <linux/tty_flip.h>
26 #include <linux/module.h>
27 #include <linux/spinlock.h>
28 #include <linux/mutex.h>
29 #include <linux/uaccess.h>
30 #include <asm/termbits.h>
31 #include <linux/usb.h>
32 #include <linux/serial_reg.h>
33 #include <linux/serial.h>
34 #include <linux/usb/serial.h>
35 #include <linux/usb/ezusb.h>
36 #include "whiteheat.h"                  /* WhiteHEAT specific commands */
37
38 #ifndef CMSPAR
39 #define CMSPAR 0
40 #endif
41
42 /*
43  * Version Information
44  */
45 #define DRIVER_AUTHOR "Greg Kroah-Hartman <greg@kroah.com>, Stuart MacDonald <stuartm@connecttech.com>"
46 #define DRIVER_DESC "USB ConnectTech WhiteHEAT driver"
47
48 #define CONNECT_TECH_VENDOR_ID          0x0710
49 #define CONNECT_TECH_FAKE_WHITE_HEAT_ID 0x0001
50 #define CONNECT_TECH_WHITE_HEAT_ID      0x8001
51
52 /*
53    ID tables for whiteheat are unusual, because we want to different
54    things for different versions of the device.  Eventually, this
55    will be doable from a single table.  But, for now, we define two
56    separate ID tables, and then a third table that combines them
57    just for the purpose of exporting the autoloading information.
58 */
59 static const struct usb_device_id id_table_std[] = {
60         { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_WHITE_HEAT_ID) },
61         { }                                             /* Terminating entry */
62 };
63
64 static const struct usb_device_id id_table_prerenumeration[] = {
65         { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_FAKE_WHITE_HEAT_ID) },
66         { }                                             /* Terminating entry */
67 };
68
69 static const struct usb_device_id id_table_combined[] = {
70         { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_WHITE_HEAT_ID) },
71         { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_FAKE_WHITE_HEAT_ID) },
72         { }                                             /* Terminating entry */
73 };
74
75 MODULE_DEVICE_TABLE(usb, id_table_combined);
76
77
78 /* function prototypes for the Connect Tech WhiteHEAT prerenumeration device */
79 static int  whiteheat_firmware_download(struct usb_serial *serial,
80                                         const struct usb_device_id *id);
81 static int  whiteheat_firmware_attach(struct usb_serial *serial);
82
83 /* function prototypes for the Connect Tech WhiteHEAT serial converter */
84 static int  whiteheat_attach(struct usb_serial *serial);
85 static void whiteheat_release(struct usb_serial *serial);
86 static int  whiteheat_port_probe(struct usb_serial_port *port);
87 static int  whiteheat_port_remove(struct usb_serial_port *port);
88 static int  whiteheat_open(struct tty_struct *tty,
89                         struct usb_serial_port *port);
90 static void whiteheat_close(struct usb_serial_port *port);
91 static int  whiteheat_ioctl(struct tty_struct *tty,
92                         unsigned int cmd, unsigned long arg);
93 static void whiteheat_set_termios(struct tty_struct *tty,
94                         struct usb_serial_port *port, struct ktermios *old);
95 static int  whiteheat_tiocmget(struct tty_struct *tty);
96 static int  whiteheat_tiocmset(struct tty_struct *tty,
97                         unsigned int set, unsigned int clear);
98 static void whiteheat_break_ctl(struct tty_struct *tty, int break_state);
99
100 static struct usb_serial_driver whiteheat_fake_device = {
101         .driver = {
102                 .owner =        THIS_MODULE,
103                 .name =         "whiteheatnofirm",
104         },
105         .description =          "Connect Tech - WhiteHEAT - (prerenumeration)",
106         .id_table =             id_table_prerenumeration,
107         .num_ports =            1,
108         .probe =                whiteheat_firmware_download,
109         .attach =               whiteheat_firmware_attach,
110 };
111
112 static struct usb_serial_driver whiteheat_device = {
113         .driver = {
114                 .owner =        THIS_MODULE,
115                 .name =         "whiteheat",
116         },
117         .description =          "Connect Tech - WhiteHEAT",
118         .id_table =             id_table_std,
119         .num_ports =            4,
120         .attach =               whiteheat_attach,
121         .release =              whiteheat_release,
122         .port_probe =           whiteheat_port_probe,
123         .port_remove =          whiteheat_port_remove,
124         .open =                 whiteheat_open,
125         .close =                whiteheat_close,
126         .ioctl =                whiteheat_ioctl,
127         .set_termios =          whiteheat_set_termios,
128         .break_ctl =            whiteheat_break_ctl,
129         .tiocmget =             whiteheat_tiocmget,
130         .tiocmset =             whiteheat_tiocmset,
131         .throttle =             usb_serial_generic_throttle,
132         .unthrottle =           usb_serial_generic_unthrottle,
133 };
134
135 static struct usb_serial_driver * const serial_drivers[] = {
136         &whiteheat_fake_device, &whiteheat_device, NULL
137 };
138
139 struct whiteheat_command_private {
140         struct mutex            mutex;
141         __u8                    port_running;
142         __u8                    command_finished;
143         wait_queue_head_t       wait_command; /* for handling sleeping whilst
144                                                  waiting for a command to
145                                                  finish */
146         __u8                    result_buffer[64];
147 };
148
149 struct whiteheat_private {
150         __u8                    mcr;            /* FIXME: no locking on mcr */
151 };
152
153
154 /* local function prototypes */
155 static int start_command_port(struct usb_serial *serial);
156 static void stop_command_port(struct usb_serial *serial);
157 static void command_port_write_callback(struct urb *urb);
158 static void command_port_read_callback(struct urb *urb);
159
160 static int firm_send_command(struct usb_serial_port *port, __u8 command,
161                                                 __u8 *data, __u8 datasize);
162 static int firm_open(struct usb_serial_port *port);
163 static int firm_close(struct usb_serial_port *port);
164 static void firm_setup_port(struct tty_struct *tty);
165 static int firm_set_rts(struct usb_serial_port *port, __u8 onoff);
166 static int firm_set_dtr(struct usb_serial_port *port, __u8 onoff);
167 static int firm_set_break(struct usb_serial_port *port, __u8 onoff);
168 static int firm_purge(struct usb_serial_port *port, __u8 rxtx);
169 static int firm_get_dtr_rts(struct usb_serial_port *port);
170 static int firm_report_tx_done(struct usb_serial_port *port);
171
172
173 #define COMMAND_PORT            4
174 #define COMMAND_TIMEOUT         (2*HZ)  /* 2 second timeout for a command */
175 #define COMMAND_TIMEOUT_MS      2000
176 #define CLOSING_DELAY           (30 * HZ)
177
178
179 /*****************************************************************************
180  * Connect Tech's White Heat prerenumeration driver functions
181  *****************************************************************************/
182
183 /* steps to download the firmware to the WhiteHEAT device:
184  - hold the reset (by writing to the reset bit of the CPUCS register)
185  - download the VEND_AX.HEX file to the chip using VENDOR_REQUEST-ANCHOR_LOAD
186  - release the reset (by writing to the CPUCS register)
187  - download the WH.HEX file for all addresses greater than 0x1b3f using
188    VENDOR_REQUEST-ANCHOR_EXTERNAL_RAM_LOAD
189  - hold the reset
190  - download the WH.HEX file for all addresses less than 0x1b40 using
191    VENDOR_REQUEST_ANCHOR_LOAD
192  - release the reset
193  - device renumerated itself and comes up as new device id with all
194    firmware download completed.
195 */
196 static int whiteheat_firmware_download(struct usb_serial *serial,
197                                         const struct usb_device_id *id)
198 {
199         int response;
200
201         response = ezusb_fx1_ihex_firmware_download(serial->dev, "whiteheat_loader.fw");
202         if (response >= 0) {
203                 response = ezusb_fx1_ihex_firmware_download(serial->dev, "whiteheat.fw");
204                 if (response >= 0)
205                         return 0;
206         }
207         return -ENOENT;
208 }
209
210
211 static int whiteheat_firmware_attach(struct usb_serial *serial)
212 {
213         /* We want this device to fail to have a driver assigned to it */
214         return 1;
215 }
216
217
218 /*****************************************************************************
219  * Connect Tech's White Heat serial driver functions
220  *****************************************************************************/
221 static int whiteheat_attach(struct usb_serial *serial)
222 {
223         struct usb_serial_port *command_port;
224         struct whiteheat_command_private *command_info;
225         struct whiteheat_hw_info *hw_info;
226         int pipe;
227         int ret;
228         int alen;
229         __u8 *command;
230         __u8 *result;
231
232         command_port = serial->port[COMMAND_PORT];
233
234         pipe = usb_sndbulkpipe(serial->dev,
235                         command_port->bulk_out_endpointAddress);
236         command = kmalloc(2, GFP_KERNEL);
237         if (!command)
238                 goto no_command_buffer;
239         command[0] = WHITEHEAT_GET_HW_INFO;
240         command[1] = 0;
241
242         result = kmalloc(sizeof(*hw_info) + 1, GFP_KERNEL);
243         if (!result)
244                 goto no_result_buffer;
245         /*
246          * When the module is reloaded the firmware is still there and
247          * the endpoints are still in the usb core unchanged. This is the
248          * unlinking bug in disguise. Same for the call below.
249          */
250         usb_clear_halt(serial->dev, pipe);
251         ret = usb_bulk_msg(serial->dev, pipe, command, 2,
252                                                 &alen, COMMAND_TIMEOUT_MS);
253         if (ret) {
254                 dev_err(&serial->dev->dev, "%s: Couldn't send command [%d]\n",
255                         serial->type->description, ret);
256                 goto no_firmware;
257         } else if (alen != 2) {
258                 dev_err(&serial->dev->dev, "%s: Send command incomplete [%d]\n",
259                         serial->type->description, alen);
260                 goto no_firmware;
261         }
262
263         pipe = usb_rcvbulkpipe(serial->dev,
264                                 command_port->bulk_in_endpointAddress);
265         /* See the comment on the usb_clear_halt() above */
266         usb_clear_halt(serial->dev, pipe);
267         ret = usb_bulk_msg(serial->dev, pipe, result,
268                         sizeof(*hw_info) + 1, &alen, COMMAND_TIMEOUT_MS);
269         if (ret) {
270                 dev_err(&serial->dev->dev, "%s: Couldn't get results [%d]\n",
271                         serial->type->description, ret);
272                 goto no_firmware;
273         } else if (alen != sizeof(*hw_info) + 1) {
274                 dev_err(&serial->dev->dev, "%s: Get results incomplete [%d]\n",
275                         serial->type->description, alen);
276                 goto no_firmware;
277         } else if (result[0] != command[0]) {
278                 dev_err(&serial->dev->dev, "%s: Command failed [%d]\n",
279                         serial->type->description, result[0]);
280                 goto no_firmware;
281         }
282
283         hw_info = (struct whiteheat_hw_info *)&result[1];
284
285         dev_info(&serial->dev->dev, "%s: Firmware v%d.%02d\n",
286                  serial->type->description,
287                  hw_info->sw_major_rev, hw_info->sw_minor_rev);
288
289         command_info = kmalloc(sizeof(struct whiteheat_command_private),
290                                                                 GFP_KERNEL);
291         if (command_info == NULL) {
292                 dev_err(&serial->dev->dev,
293                         "%s: Out of memory for port structures\n",
294                         serial->type->description);
295                 goto no_command_private;
296         }
297
298         mutex_init(&command_info->mutex);
299         command_info->port_running = 0;
300         init_waitqueue_head(&command_info->wait_command);
301         usb_set_serial_port_data(command_port, command_info);
302         command_port->write_urb->complete = command_port_write_callback;
303         command_port->read_urb->complete = command_port_read_callback;
304         kfree(result);
305         kfree(command);
306
307         return 0;
308
309 no_firmware:
310         /* Firmware likely not running */
311         dev_err(&serial->dev->dev,
312                 "%s: Unable to retrieve firmware version, try replugging\n",
313                 serial->type->description);
314         dev_err(&serial->dev->dev,
315                 "%s: If the firmware is not running (status led not blinking)\n",
316                 serial->type->description);
317         dev_err(&serial->dev->dev,
318                 "%s: please contact support@connecttech.com\n",
319                 serial->type->description);
320         kfree(result);
321         kfree(command);
322         return -ENODEV;
323
324 no_command_private:
325         kfree(result);
326 no_result_buffer:
327         kfree(command);
328 no_command_buffer:
329         return -ENOMEM;
330 }
331
332 static void whiteheat_release(struct usb_serial *serial)
333 {
334         struct usb_serial_port *command_port;
335
336         /* free up our private data for our command port */
337         command_port = serial->port[COMMAND_PORT];
338         kfree(usb_get_serial_port_data(command_port));
339 }
340
341 static int whiteheat_port_probe(struct usb_serial_port *port)
342 {
343         struct whiteheat_private *info;
344
345         info = kzalloc(sizeof(*info), GFP_KERNEL);
346         if (!info)
347                 return -ENOMEM;
348
349         usb_set_serial_port_data(port, info);
350
351         return 0;
352 }
353
354 static int whiteheat_port_remove(struct usb_serial_port *port)
355 {
356         struct whiteheat_private *info;
357
358         info = usb_get_serial_port_data(port);
359         kfree(info);
360
361         return 0;
362 }
363
364 static int whiteheat_open(struct tty_struct *tty, struct usb_serial_port *port)
365 {
366         int retval;
367
368         retval = start_command_port(port->serial);
369         if (retval)
370                 goto exit;
371
372         /* send an open port command */
373         retval = firm_open(port);
374         if (retval) {
375                 stop_command_port(port->serial);
376                 goto exit;
377         }
378
379         retval = firm_purge(port, WHITEHEAT_PURGE_RX | WHITEHEAT_PURGE_TX);
380         if (retval) {
381                 firm_close(port);
382                 stop_command_port(port->serial);
383                 goto exit;
384         }
385
386         if (tty)
387                 firm_setup_port(tty);
388
389         /* Work around HCD bugs */
390         usb_clear_halt(port->serial->dev, port->read_urb->pipe);
391         usb_clear_halt(port->serial->dev, port->write_urb->pipe);
392
393         retval = usb_serial_generic_open(tty, port);
394         if (retval) {
395                 firm_close(port);
396                 stop_command_port(port->serial);
397                 goto exit;
398         }
399 exit:
400         return retval;
401 }
402
403
404 static void whiteheat_close(struct usb_serial_port *port)
405 {
406         firm_report_tx_done(port);
407         firm_close(port);
408
409         usb_serial_generic_close(port);
410
411         stop_command_port(port->serial);
412 }
413
414 static int whiteheat_tiocmget(struct tty_struct *tty)
415 {
416         struct usb_serial_port *port = tty->driver_data;
417         struct whiteheat_private *info = usb_get_serial_port_data(port);
418         unsigned int modem_signals = 0;
419
420         firm_get_dtr_rts(port);
421         if (info->mcr & UART_MCR_DTR)
422                 modem_signals |= TIOCM_DTR;
423         if (info->mcr & UART_MCR_RTS)
424                 modem_signals |= TIOCM_RTS;
425
426         return modem_signals;
427 }
428
429 static int whiteheat_tiocmset(struct tty_struct *tty,
430                                unsigned int set, unsigned int clear)
431 {
432         struct usb_serial_port *port = tty->driver_data;
433         struct whiteheat_private *info = usb_get_serial_port_data(port);
434
435         if (set & TIOCM_RTS)
436                 info->mcr |= UART_MCR_RTS;
437         if (set & TIOCM_DTR)
438                 info->mcr |= UART_MCR_DTR;
439
440         if (clear & TIOCM_RTS)
441                 info->mcr &= ~UART_MCR_RTS;
442         if (clear & TIOCM_DTR)
443                 info->mcr &= ~UART_MCR_DTR;
444
445         firm_set_dtr(port, info->mcr & UART_MCR_DTR);
446         firm_set_rts(port, info->mcr & UART_MCR_RTS);
447         return 0;
448 }
449
450
451 static int whiteheat_ioctl(struct tty_struct *tty,
452                                         unsigned int cmd, unsigned long arg)
453 {
454         struct usb_serial_port *port = tty->driver_data;
455         struct serial_struct serstruct;
456         void __user *user_arg = (void __user *)arg;
457
458         switch (cmd) {
459         case TIOCGSERIAL:
460                 memset(&serstruct, 0, sizeof(serstruct));
461                 serstruct.type = PORT_16654;
462                 serstruct.line = port->minor;
463                 serstruct.port = port->port_number;
464                 serstruct.flags = ASYNC_SKIP_TEST | ASYNC_AUTO_IRQ;
465                 serstruct.xmit_fifo_size = kfifo_size(&port->write_fifo);
466                 serstruct.custom_divisor = 0;
467                 serstruct.baud_base = 460800;
468                 serstruct.close_delay = CLOSING_DELAY;
469                 serstruct.closing_wait = CLOSING_DELAY;
470
471                 if (copy_to_user(user_arg, &serstruct, sizeof(serstruct)))
472                         return -EFAULT;
473                 break;
474         default:
475                 break;
476         }
477
478         return -ENOIOCTLCMD;
479 }
480
481
482 static void whiteheat_set_termios(struct tty_struct *tty,
483         struct usb_serial_port *port, struct ktermios *old_termios)
484 {
485         firm_setup_port(tty);
486 }
487
488 static void whiteheat_break_ctl(struct tty_struct *tty, int break_state)
489 {
490         struct usb_serial_port *port = tty->driver_data;
491         firm_set_break(port, break_state);
492 }
493
494
495 /*****************************************************************************
496  * Connect Tech's White Heat callback routines
497  *****************************************************************************/
498 static void command_port_write_callback(struct urb *urb)
499 {
500         int status = urb->status;
501
502         if (status) {
503                 dev_dbg(&urb->dev->dev, "nonzero urb status: %d\n", status);
504                 return;
505         }
506 }
507
508
509 static void command_port_read_callback(struct urb *urb)
510 {
511         struct usb_serial_port *command_port = urb->context;
512         struct whiteheat_command_private *command_info;
513         int status = urb->status;
514         unsigned char *data = urb->transfer_buffer;
515         int result;
516
517         command_info = usb_get_serial_port_data(command_port);
518         if (!command_info) {
519                 dev_dbg(&urb->dev->dev, "%s - command_info is NULL, exiting.\n", __func__);
520                 return;
521         }
522         if (status) {
523                 dev_dbg(&urb->dev->dev, "%s - nonzero urb status: %d\n", __func__, status);
524                 if (status != -ENOENT)
525                         command_info->command_finished = WHITEHEAT_CMD_FAILURE;
526                 wake_up(&command_info->wait_command);
527                 return;
528         }
529
530         usb_serial_debug_data(&command_port->dev, __func__, urb->actual_length, data);
531
532         if (data[0] == WHITEHEAT_CMD_COMPLETE) {
533                 command_info->command_finished = WHITEHEAT_CMD_COMPLETE;
534                 wake_up(&command_info->wait_command);
535         } else if (data[0] == WHITEHEAT_CMD_FAILURE) {
536                 command_info->command_finished = WHITEHEAT_CMD_FAILURE;
537                 wake_up(&command_info->wait_command);
538         } else if (data[0] == WHITEHEAT_EVENT) {
539                 /* These are unsolicited reports from the firmware, hence no
540                    waiting command to wakeup */
541                 dev_dbg(&urb->dev->dev, "%s - event received\n", __func__);
542         } else if (data[0] == WHITEHEAT_GET_DTR_RTS) {
543                 memcpy(command_info->result_buffer, &data[1],
544                                                 urb->actual_length - 1);
545                 command_info->command_finished = WHITEHEAT_CMD_COMPLETE;
546                 wake_up(&command_info->wait_command);
547         } else
548                 dev_dbg(&urb->dev->dev, "%s - bad reply from firmware\n", __func__);
549
550         /* Continue trying to always read */
551         result = usb_submit_urb(command_port->read_urb, GFP_ATOMIC);
552         if (result)
553                 dev_dbg(&urb->dev->dev, "%s - failed resubmitting read urb, error %d\n",
554                         __func__, result);
555 }
556
557
558 /*****************************************************************************
559  * Connect Tech's White Heat firmware interface
560  *****************************************************************************/
561 static int firm_send_command(struct usb_serial_port *port, __u8 command,
562                                                 __u8 *data, __u8 datasize)
563 {
564         struct usb_serial_port *command_port;
565         struct whiteheat_command_private *command_info;
566         struct whiteheat_private *info;
567         struct device *dev = &port->dev;
568         __u8 *transfer_buffer;
569         int retval = 0;
570         int t;
571
572         dev_dbg(dev, "%s - command %d\n", __func__, command);
573
574         command_port = port->serial->port[COMMAND_PORT];
575         command_info = usb_get_serial_port_data(command_port);
576         mutex_lock(&command_info->mutex);
577         command_info->command_finished = false;
578
579         transfer_buffer = (__u8 *)command_port->write_urb->transfer_buffer;
580         transfer_buffer[0] = command;
581         memcpy(&transfer_buffer[1], data, datasize);
582         command_port->write_urb->transfer_buffer_length = datasize + 1;
583         retval = usb_submit_urb(command_port->write_urb, GFP_NOIO);
584         if (retval) {
585                 dev_dbg(dev, "%s - submit urb failed\n", __func__);
586                 goto exit;
587         }
588
589         /* wait for the command to complete */
590         t = wait_event_timeout(command_info->wait_command,
591                 (bool)command_info->command_finished, COMMAND_TIMEOUT);
592         if (!t)
593                 usb_kill_urb(command_port->write_urb);
594
595         if (command_info->command_finished == false) {
596                 dev_dbg(dev, "%s - command timed out.\n", __func__);
597                 retval = -ETIMEDOUT;
598                 goto exit;
599         }
600
601         if (command_info->command_finished == WHITEHEAT_CMD_FAILURE) {
602                 dev_dbg(dev, "%s - command failed.\n", __func__);
603                 retval = -EIO;
604                 goto exit;
605         }
606
607         if (command_info->command_finished == WHITEHEAT_CMD_COMPLETE) {
608                 dev_dbg(dev, "%s - command completed.\n", __func__);
609                 switch (command) {
610                 case WHITEHEAT_GET_DTR_RTS:
611                         info = usb_get_serial_port_data(port);
612                         memcpy(&info->mcr, command_info->result_buffer,
613                                         sizeof(struct whiteheat_dr_info));
614                                 break;
615                 }
616         }
617 exit:
618         mutex_unlock(&command_info->mutex);
619         return retval;
620 }
621
622
623 static int firm_open(struct usb_serial_port *port)
624 {
625         struct whiteheat_simple open_command;
626
627         open_command.port = port->port_number + 1;
628         return firm_send_command(port, WHITEHEAT_OPEN,
629                 (__u8 *)&open_command, sizeof(open_command));
630 }
631
632
633 static int firm_close(struct usb_serial_port *port)
634 {
635         struct whiteheat_simple close_command;
636
637         close_command.port = port->port_number + 1;
638         return firm_send_command(port, WHITEHEAT_CLOSE,
639                         (__u8 *)&close_command, sizeof(close_command));
640 }
641
642
643 static void firm_setup_port(struct tty_struct *tty)
644 {
645         struct usb_serial_port *port = tty->driver_data;
646         struct device *dev = &port->dev;
647         struct whiteheat_port_settings port_settings;
648         unsigned int cflag = tty->termios.c_cflag;
649
650         port_settings.port = port->port_number + 1;
651
652         /* get the byte size */
653         switch (cflag & CSIZE) {
654         case CS5:       port_settings.bits = 5;   break;
655         case CS6:       port_settings.bits = 6;   break;
656         case CS7:       port_settings.bits = 7;   break;
657         default:
658         case CS8:       port_settings.bits = 8;   break;
659         }
660         dev_dbg(dev, "%s - data bits = %d\n", __func__, port_settings.bits);
661
662         /* determine the parity */
663         if (cflag & PARENB)
664                 if (cflag & CMSPAR)
665                         if (cflag & PARODD)
666                                 port_settings.parity = WHITEHEAT_PAR_MARK;
667                         else
668                                 port_settings.parity = WHITEHEAT_PAR_SPACE;
669                 else
670                         if (cflag & PARODD)
671                                 port_settings.parity = WHITEHEAT_PAR_ODD;
672                         else
673                                 port_settings.parity = WHITEHEAT_PAR_EVEN;
674         else
675                 port_settings.parity = WHITEHEAT_PAR_NONE;
676         dev_dbg(dev, "%s - parity = %c\n", __func__, port_settings.parity);
677
678         /* figure out the stop bits requested */
679         if (cflag & CSTOPB)
680                 port_settings.stop = 2;
681         else
682                 port_settings.stop = 1;
683         dev_dbg(dev, "%s - stop bits = %d\n", __func__, port_settings.stop);
684
685         /* figure out the flow control settings */
686         if (cflag & CRTSCTS)
687                 port_settings.hflow = (WHITEHEAT_HFLOW_CTS |
688                                                 WHITEHEAT_HFLOW_RTS);
689         else
690                 port_settings.hflow = WHITEHEAT_HFLOW_NONE;
691         dev_dbg(dev, "%s - hardware flow control = %s %s %s %s\n", __func__,
692             (port_settings.hflow & WHITEHEAT_HFLOW_CTS) ? "CTS" : "",
693             (port_settings.hflow & WHITEHEAT_HFLOW_RTS) ? "RTS" : "",
694             (port_settings.hflow & WHITEHEAT_HFLOW_DSR) ? "DSR" : "",
695             (port_settings.hflow & WHITEHEAT_HFLOW_DTR) ? "DTR" : "");
696
697         /* determine software flow control */
698         if (I_IXOFF(tty))
699                 port_settings.sflow = WHITEHEAT_SFLOW_RXTX;
700         else
701                 port_settings.sflow = WHITEHEAT_SFLOW_NONE;
702         dev_dbg(dev, "%s - software flow control = %c\n", __func__, port_settings.sflow);
703
704         port_settings.xon = START_CHAR(tty);
705         port_settings.xoff = STOP_CHAR(tty);
706         dev_dbg(dev, "%s - XON = %2x, XOFF = %2x\n", __func__, port_settings.xon, port_settings.xoff);
707
708         /* get the baud rate wanted */
709         port_settings.baud = tty_get_baud_rate(tty);
710         dev_dbg(dev, "%s - baud rate = %d\n", __func__, port_settings.baud);
711
712         /* fixme: should set validated settings */
713         tty_encode_baud_rate(tty, port_settings.baud, port_settings.baud);
714         /* handle any settings that aren't specified in the tty structure */
715         port_settings.lloop = 0;
716
717         /* now send the message to the device */
718         firm_send_command(port, WHITEHEAT_SETUP_PORT,
719                         (__u8 *)&port_settings, sizeof(port_settings));
720 }
721
722
723 static int firm_set_rts(struct usb_serial_port *port, __u8 onoff)
724 {
725         struct whiteheat_set_rdb rts_command;
726
727         rts_command.port = port->port_number + 1;
728         rts_command.state = onoff;
729         return firm_send_command(port, WHITEHEAT_SET_RTS,
730                         (__u8 *)&rts_command, sizeof(rts_command));
731 }
732
733
734 static int firm_set_dtr(struct usb_serial_port *port, __u8 onoff)
735 {
736         struct whiteheat_set_rdb dtr_command;
737
738         dtr_command.port = port->port_number + 1;
739         dtr_command.state = onoff;
740         return firm_send_command(port, WHITEHEAT_SET_DTR,
741                         (__u8 *)&dtr_command, sizeof(dtr_command));
742 }
743
744
745 static int firm_set_break(struct usb_serial_port *port, __u8 onoff)
746 {
747         struct whiteheat_set_rdb break_command;
748
749         break_command.port = port->port_number + 1;
750         break_command.state = onoff;
751         return firm_send_command(port, WHITEHEAT_SET_BREAK,
752                         (__u8 *)&break_command, sizeof(break_command));
753 }
754
755
756 static int firm_purge(struct usb_serial_port *port, __u8 rxtx)
757 {
758         struct whiteheat_purge purge_command;
759
760         purge_command.port = port->port_number + 1;
761         purge_command.what = rxtx;
762         return firm_send_command(port, WHITEHEAT_PURGE,
763                         (__u8 *)&purge_command, sizeof(purge_command));
764 }
765
766
767 static int firm_get_dtr_rts(struct usb_serial_port *port)
768 {
769         struct whiteheat_simple get_dr_command;
770
771         get_dr_command.port = port->port_number + 1;
772         return firm_send_command(port, WHITEHEAT_GET_DTR_RTS,
773                         (__u8 *)&get_dr_command, sizeof(get_dr_command));
774 }
775
776
777 static int firm_report_tx_done(struct usb_serial_port *port)
778 {
779         struct whiteheat_simple close_command;
780
781         close_command.port = port->port_number + 1;
782         return firm_send_command(port, WHITEHEAT_REPORT_TX_DONE,
783                         (__u8 *)&close_command, sizeof(close_command));
784 }
785
786
787 /*****************************************************************************
788  * Connect Tech's White Heat utility functions
789  *****************************************************************************/
790 static int start_command_port(struct usb_serial *serial)
791 {
792         struct usb_serial_port *command_port;
793         struct whiteheat_command_private *command_info;
794         int retval = 0;
795
796         command_port = serial->port[COMMAND_PORT];
797         command_info = usb_get_serial_port_data(command_port);
798         mutex_lock(&command_info->mutex);
799         if (!command_info->port_running) {
800                 /* Work around HCD bugs */
801                 usb_clear_halt(serial->dev, command_port->read_urb->pipe);
802
803                 retval = usb_submit_urb(command_port->read_urb, GFP_KERNEL);
804                 if (retval) {
805                         dev_err(&serial->dev->dev,
806                                 "%s - failed submitting read urb, error %d\n",
807                                 __func__, retval);
808                         goto exit;
809                 }
810         }
811         command_info->port_running++;
812
813 exit:
814         mutex_unlock(&command_info->mutex);
815         return retval;
816 }
817
818
819 static void stop_command_port(struct usb_serial *serial)
820 {
821         struct usb_serial_port *command_port;
822         struct whiteheat_command_private *command_info;
823
824         command_port = serial->port[COMMAND_PORT];
825         command_info = usb_get_serial_port_data(command_port);
826         mutex_lock(&command_info->mutex);
827         command_info->port_running--;
828         if (!command_info->port_running)
829                 usb_kill_urb(command_port->read_urb);
830         mutex_unlock(&command_info->mutex);
831 }
832
833 module_usb_serial_driver(serial_drivers, id_table_combined);
834
835 MODULE_AUTHOR(DRIVER_AUTHOR);
836 MODULE_DESCRIPTION(DRIVER_DESC);
837 MODULE_LICENSE("GPL");
838
839 MODULE_FIRMWARE("whiteheat.fw");
840 MODULE_FIRMWARE("whiteheat_loader.fw");