2 * USB ConnectTech WhiteHEAT driver
7 * Copyright (C) 1999 - 2001
8 * Greg Kroah-Hartman (greg@kroah.com)
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.
15 * See Documentation/usb/usb-serial.txt for more information on using this driver
17 * (10/09/2002) Stuart MacDonald (stuartm@connecttech.com)
18 * Upgrade to full working driver
21 * switched from using spinlock to a semaphore, which fixes lots of problems.
24 * Identify version on module load.
27 * Fixed MOD_INC and MOD_DEC logic, the ability to open a port more
28 * than once, and the got the proper usb_device_id table entries so
29 * the driver works again.
31 * (11/01/2000) Adam J. Richter
32 * usb_device_id table support
35 * Fixed bug with urb->dev not being set properly, now that the usb
39 * firmware is improved to guard against crap sent to device
40 * firmware now replies CMD_FAILURE on bad things
41 * read_callback fix you provided for private info struct
42 * command_finished now indicates success or fail
43 * setup_port struct now packed to avoid gcc padding
44 * firmware uses 1 based port numbering, driver now handles that
47 * Removed DEBUG #ifdefs with call to usb_serial_debug_data
50 * Added module_init and module_exit functions to handle the fact that this
51 * driver is a loadable module now.
52 * Fixed bug with port->minor that was found by Al Borchers
55 * Added support for port settings. Baud rate can now be changed. Line signals
56 * are not transferred to and from the tty layer yet, but things seem to be
60 * First cut at open and close commands. Data can flow through the ports at
64 * Split driver up into device specific pieces.
68 #include <linux/kernel.h>
69 #include <linux/errno.h>
70 #include <linux/init.h>
71 #include <linux/slab.h>
72 #include <linux/tty.h>
73 #include <linux/tty_driver.h>
74 #include <linux/tty_flip.h>
75 #include <linux/module.h>
76 #include <linux/spinlock.h>
77 #include <linux/mutex.h>
78 #include <asm/uaccess.h>
79 #include <asm/termbits.h>
80 #include <linux/usb.h>
81 #include <linux/serial_reg.h>
82 #include <linux/serial.h>
83 #include <linux/usb/serial.h>
84 #include <linux/firmware.h>
85 #include <linux/ihex.h>
86 #include "whiteheat.h" /* WhiteHEAT specific commands */
97 #define DRIVER_VERSION "v2.0"
98 #define DRIVER_AUTHOR "Greg Kroah-Hartman <greg@kroah.com>, Stuart MacDonald <stuartm@connecttech.com>"
99 #define DRIVER_DESC "USB ConnectTech WhiteHEAT driver"
101 #define CONNECT_TECH_VENDOR_ID 0x0710
102 #define CONNECT_TECH_FAKE_WHITE_HEAT_ID 0x0001
103 #define CONNECT_TECH_WHITE_HEAT_ID 0x8001
106 ID tables for whiteheat are unusual, because we want to different
107 things for different versions of the device. Eventually, this
108 will be doable from a single table. But, for now, we define two
109 separate ID tables, and then a third table that combines them
110 just for the purpose of exporting the autoloading information.
112 static struct usb_device_id id_table_std [] = {
113 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_WHITE_HEAT_ID) },
114 { } /* Terminating entry */
117 static struct usb_device_id id_table_prerenumeration [] = {
118 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_FAKE_WHITE_HEAT_ID) },
119 { } /* Terminating entry */
122 static struct usb_device_id id_table_combined [] = {
123 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_WHITE_HEAT_ID) },
124 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_FAKE_WHITE_HEAT_ID) },
125 { } /* Terminating entry */
128 MODULE_DEVICE_TABLE (usb, id_table_combined);
130 static struct usb_driver whiteheat_driver = {
132 .probe = usb_serial_probe,
133 .disconnect = usb_serial_disconnect,
134 .id_table = id_table_combined,
138 /* function prototypes for the Connect Tech WhiteHEAT prerenumeration device */
139 static int whiteheat_firmware_download (struct usb_serial *serial, const struct usb_device_id *id);
140 static int whiteheat_firmware_attach (struct usb_serial *serial);
142 /* function prototypes for the Connect Tech WhiteHEAT serial converter */
143 static int whiteheat_attach (struct usb_serial *serial);
144 static void whiteheat_shutdown (struct usb_serial *serial);
145 static int whiteheat_open (struct usb_serial_port *port, struct file *filp);
146 static void whiteheat_close (struct usb_serial_port *port, struct file *filp);
147 static int whiteheat_write (struct usb_serial_port *port, const unsigned char *buf, int count);
148 static int whiteheat_write_room (struct usb_serial_port *port);
149 static int whiteheat_ioctl (struct usb_serial_port *port, struct file * file, unsigned int cmd, unsigned long arg);
150 static void whiteheat_set_termios (struct usb_serial_port *port, struct ktermios * old);
151 static int whiteheat_tiocmget (struct usb_serial_port *port, struct file *file);
152 static int whiteheat_tiocmset (struct usb_serial_port *port, struct file *file, unsigned int set, unsigned int clear);
153 static void whiteheat_break_ctl (struct usb_serial_port *port, int break_state);
154 static int whiteheat_chars_in_buffer (struct usb_serial_port *port);
155 static void whiteheat_throttle (struct usb_serial_port *port);
156 static void whiteheat_unthrottle (struct usb_serial_port *port);
157 static void whiteheat_read_callback (struct urb *urb);
158 static void whiteheat_write_callback (struct urb *urb);
160 static struct usb_serial_driver whiteheat_fake_device = {
162 .owner = THIS_MODULE,
163 .name = "whiteheatnofirm",
165 .description = "Connect Tech - WhiteHEAT - (prerenumeration)",
166 .usb_driver = &whiteheat_driver,
167 .id_table = id_table_prerenumeration,
169 .probe = whiteheat_firmware_download,
170 .attach = whiteheat_firmware_attach,
173 static struct usb_serial_driver whiteheat_device = {
175 .owner = THIS_MODULE,
178 .description = "Connect Tech - WhiteHEAT",
179 .usb_driver = &whiteheat_driver,
180 .id_table = id_table_std,
182 .attach = whiteheat_attach,
183 .shutdown = whiteheat_shutdown,
184 .open = whiteheat_open,
185 .close = whiteheat_close,
186 .write = whiteheat_write,
187 .write_room = whiteheat_write_room,
188 .ioctl = whiteheat_ioctl,
189 .set_termios = whiteheat_set_termios,
190 .break_ctl = whiteheat_break_ctl,
191 .tiocmget = whiteheat_tiocmget,
192 .tiocmset = whiteheat_tiocmset,
193 .chars_in_buffer = whiteheat_chars_in_buffer,
194 .throttle = whiteheat_throttle,
195 .unthrottle = whiteheat_unthrottle,
196 .read_bulk_callback = whiteheat_read_callback,
197 .write_bulk_callback = whiteheat_write_callback,
201 struct whiteheat_command_private {
204 __u8 command_finished;
205 wait_queue_head_t wait_command; /* for handling sleeping while waiting for a command to finish */
206 __u8 result_buffer[64];
210 #define THROTTLED 0x01
211 #define ACTUALLY_THROTTLED 0x02
213 static int urb_pool_size = 8;
215 struct whiteheat_urb_wrap {
216 struct list_head list;
220 struct whiteheat_private {
223 __u8 mcr; /* FIXME: no locking on mcr */
224 struct list_head rx_urbs_free;
225 struct list_head rx_urbs_submitted;
226 struct list_head rx_urb_q;
227 struct work_struct rx_work;
228 struct usb_serial_port *port;
229 struct list_head tx_urbs_free;
230 struct list_head tx_urbs_submitted;
231 struct mutex deathwarrant;
235 /* local function prototypes */
236 static int start_command_port(struct usb_serial *serial);
237 static void stop_command_port(struct usb_serial *serial);
238 static void command_port_write_callback(struct urb *urb);
239 static void command_port_read_callback(struct urb *urb);
241 static int start_port_read(struct usb_serial_port *port);
242 static struct whiteheat_urb_wrap *urb_to_wrap(struct urb *urb, struct list_head *head);
243 static struct list_head *list_first(struct list_head *head);
244 static void rx_data_softint(struct work_struct *work);
246 static int firm_send_command(struct usb_serial_port *port, __u8 command, __u8 *data, __u8 datasize);
247 static int firm_open(struct usb_serial_port *port);
248 static int firm_close(struct usb_serial_port *port);
249 static int firm_setup_port(struct usb_serial_port *port);
250 static int firm_set_rts(struct usb_serial_port *port, __u8 onoff);
251 static int firm_set_dtr(struct usb_serial_port *port, __u8 onoff);
252 static int firm_set_break(struct usb_serial_port *port, __u8 onoff);
253 static int firm_purge(struct usb_serial_port *port, __u8 rxtx);
254 static int firm_get_dtr_rts(struct usb_serial_port *port);
255 static int firm_report_tx_done(struct usb_serial_port *port);
258 #define COMMAND_PORT 4
259 #define COMMAND_TIMEOUT (2*HZ) /* 2 second timeout for a command */
260 #define COMMAND_TIMEOUT_MS 2000
261 #define CLOSING_DELAY (30 * HZ)
264 /*****************************************************************************
265 * Connect Tech's White Heat prerenumeration driver functions
266 *****************************************************************************/
268 /* steps to download the firmware to the WhiteHEAT device:
269 - hold the reset (by writing to the reset bit of the CPUCS register)
270 - download the VEND_AX.HEX file to the chip using VENDOR_REQUEST-ANCHOR_LOAD
271 - release the reset (by writing to the CPUCS register)
272 - download the WH.HEX file for all addresses greater than 0x1b3f using
273 VENDOR_REQUEST-ANCHOR_EXTERNAL_RAM_LOAD
275 - download the WH.HEX file for all addresses less than 0x1b40 using
276 VENDOR_REQUEST_ANCHOR_LOAD
278 - device renumerated itself and comes up as new device id with all
279 firmware download completed.
281 static int whiteheat_firmware_download (struct usb_serial *serial, const struct usb_device_id *id)
283 int response, ret = -ENOENT;
284 const struct firmware *loader_fw = NULL, *firmware_fw = NULL;
285 const struct ihex_binrec *record;
289 if (request_ihex_firmware(&firmware_fw, "whiteheat.fw",
290 &serial->dev->dev)) {
291 err("%s - request \"whiteheat.fw\" failed", __func__);
294 if (request_ihex_firmware(&loader_fw, "whiteheat_loader.fw",
295 &serial->dev->dev)) {
296 err("%s - request \"whiteheat_loader.fw\" failed", __func__);
300 response = ezusb_set_reset (serial, 1);
302 record = (const struct ihex_binrec *)loader_fw->data;
304 response = ezusb_writememory (serial, be32_to_cpu(record->addr),
305 (unsigned char *)record->data,
306 be16_to_cpu(record->len), 0xa0);
308 err("%s - ezusb_writememory failed for loader (%d %04X %p %d)",
309 __func__, response, be32_to_cpu(record->addr),
310 record->data, be16_to_cpu(record->len));
313 record = ihex_next_binrec(record);
316 response = ezusb_set_reset (serial, 0);
318 record = (const struct ihex_binrec *)firmware_fw->data;
319 while (record && be32_to_cpu(record->addr) < 0x1b40)
320 record = ihex_next_binrec(record);
322 response = ezusb_writememory (serial, be32_to_cpu(record->addr),
323 (unsigned char *)record->data,
324 be16_to_cpu(record->len), 0xa3);
326 err("%s - ezusb_writememory failed for first firmware step (%d %04X %p %d)",
327 __func__, response, be32_to_cpu(record->addr),
328 record->data, be16_to_cpu(record->len));
334 response = ezusb_set_reset (serial, 1);
336 record = (const struct ihex_binrec *)firmware_fw->data;
337 while (record && be32_to_cpu(record->addr) < 0x1b40) {
338 response = ezusb_writememory (serial, be32_to_cpu(record->addr),
339 (unsigned char *)record->data,
340 be16_to_cpu(record->len), 0xa0);
342 err("%s - ezusb_writememory failed for second firmware step (%d %04X %p %d)",
343 __func__, response, be32_to_cpu(record->addr),
344 record->data, be16_to_cpu(record->len));
350 response = ezusb_set_reset (serial, 0);
352 release_firmware(loader_fw);
353 release_firmware(firmware_fw);
358 static int whiteheat_firmware_attach (struct usb_serial *serial)
360 /* We want this device to fail to have a driver assigned to it */
365 /*****************************************************************************
366 * Connect Tech's White Heat serial driver functions
367 *****************************************************************************/
368 static int whiteheat_attach (struct usb_serial *serial)
370 struct usb_serial_port *command_port;
371 struct whiteheat_command_private *command_info;
372 struct usb_serial_port *port;
373 struct whiteheat_private *info;
374 struct whiteheat_hw_info *hw_info;
384 struct whiteheat_urb_wrap *wrap;
385 struct list_head *tmp;
387 command_port = serial->port[COMMAND_PORT];
389 pipe = usb_sndbulkpipe (serial->dev, command_port->bulk_out_endpointAddress);
390 command = kmalloc(2, GFP_KERNEL);
392 goto no_command_buffer;
393 command[0] = WHITEHEAT_GET_HW_INFO;
396 result = kmalloc(sizeof(*hw_info) + 1, GFP_KERNEL);
398 goto no_result_buffer;
400 * When the module is reloaded the firmware is still there and
401 * the endpoints are still in the usb core unchanged. This is the
402 * unlinking bug in disguise. Same for the call below.
404 usb_clear_halt(serial->dev, pipe);
405 ret = usb_bulk_msg (serial->dev, pipe, command, 2, &alen, COMMAND_TIMEOUT_MS);
407 err("%s: Couldn't send command [%d]", serial->type->description, ret);
409 } else if (alen != 2) {
410 err("%s: Send command incomplete [%d]", serial->type->description, alen);
414 pipe = usb_rcvbulkpipe (serial->dev, command_port->bulk_in_endpointAddress);
415 /* See the comment on the usb_clear_halt() above */
416 usb_clear_halt(serial->dev, pipe);
417 ret = usb_bulk_msg (serial->dev, pipe, result, sizeof(*hw_info) + 1, &alen, COMMAND_TIMEOUT_MS);
419 err("%s: Couldn't get results [%d]", serial->type->description, ret);
421 } else if (alen != sizeof(*hw_info) + 1) {
422 err("%s: Get results incomplete [%d]", serial->type->description, alen);
424 } else if (result[0] != command[0]) {
425 err("%s: Command failed [%d]", serial->type->description, result[0]);
429 hw_info = (struct whiteheat_hw_info *)&result[1];
431 info("%s: Driver %s: Firmware v%d.%02d", serial->type->description,
432 DRIVER_VERSION, hw_info->sw_major_rev, hw_info->sw_minor_rev);
434 for (i = 0; i < serial->num_ports; i++) {
435 port = serial->port[i];
437 info = kmalloc(sizeof(struct whiteheat_private), GFP_KERNEL);
439 err("%s: Out of memory for port structures\n", serial->type->description);
443 spin_lock_init(&info->lock);
444 mutex_init(&info->deathwarrant);
447 INIT_WORK(&info->rx_work, rx_data_softint);
450 INIT_LIST_HEAD(&info->rx_urbs_free);
451 INIT_LIST_HEAD(&info->rx_urbs_submitted);
452 INIT_LIST_HEAD(&info->rx_urb_q);
453 INIT_LIST_HEAD(&info->tx_urbs_free);
454 INIT_LIST_HEAD(&info->tx_urbs_submitted);
456 for (j = 0; j < urb_pool_size; j++) {
457 urb = usb_alloc_urb(0, GFP_KERNEL);
459 err("No free urbs available");
462 buf_size = port->read_urb->transfer_buffer_length;
463 urb->transfer_buffer = kmalloc(buf_size, GFP_KERNEL);
464 if (!urb->transfer_buffer) {
465 err("Couldn't allocate urb buffer");
468 wrap = kmalloc(sizeof(*wrap), GFP_KERNEL);
470 err("Couldn't allocate urb wrapper");
473 usb_fill_bulk_urb(urb, serial->dev,
474 usb_rcvbulkpipe(serial->dev,
475 port->bulk_in_endpointAddress),
476 urb->transfer_buffer, buf_size,
477 whiteheat_read_callback, port);
479 list_add(&wrap->list, &info->rx_urbs_free);
481 urb = usb_alloc_urb(0, GFP_KERNEL);
483 err("No free urbs available");
486 buf_size = port->write_urb->transfer_buffer_length;
487 urb->transfer_buffer = kmalloc(buf_size, GFP_KERNEL);
488 if (!urb->transfer_buffer) {
489 err("Couldn't allocate urb buffer");
492 wrap = kmalloc(sizeof(*wrap), GFP_KERNEL);
494 err("Couldn't allocate urb wrapper");
497 usb_fill_bulk_urb(urb, serial->dev,
498 usb_sndbulkpipe(serial->dev,
499 port->bulk_out_endpointAddress),
500 urb->transfer_buffer, buf_size,
501 whiteheat_write_callback, port);
503 list_add(&wrap->list, &info->tx_urbs_free);
506 usb_set_serial_port_data(port, info);
509 command_info = kmalloc(sizeof(struct whiteheat_command_private), GFP_KERNEL);
510 if (command_info == NULL) {
511 err("%s: Out of memory for port structures\n", serial->type->description);
512 goto no_command_private;
515 mutex_init(&command_info->mutex);
516 command_info->port_running = 0;
517 init_waitqueue_head(&command_info->wait_command);
518 usb_set_serial_port_data(command_port, command_info);
519 command_port->write_urb->complete = command_port_write_callback;
520 command_port->read_urb->complete = command_port_read_callback;
527 /* Firmware likely not running */
528 err("%s: Unable to retrieve firmware version, try replugging\n", serial->type->description);
529 err("%s: If the firmware is not running (status led not blinking)\n", serial->type->description);
530 err("%s: please contact support@connecttech.com\n", serial->type->description);
535 for (i = serial->num_ports - 1; i >= 0; i--) {
536 port = serial->port[i];
537 info = usb_get_serial_port_data(port);
538 for (j = urb_pool_size - 1; j >= 0; j--) {
539 tmp = list_first(&info->tx_urbs_free);
541 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
545 kfree(urb->transfer_buffer);
549 tmp = list_first(&info->rx_urbs_free);
551 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
555 kfree(urb->transfer_buffer);
573 static void whiteheat_shutdown (struct usb_serial *serial)
575 struct usb_serial_port *command_port;
576 struct usb_serial_port *port;
577 struct whiteheat_private *info;
578 struct whiteheat_urb_wrap *wrap;
580 struct list_head *tmp;
581 struct list_head *tmp2;
586 /* free up our private data for our command port */
587 command_port = serial->port[COMMAND_PORT];
588 kfree (usb_get_serial_port_data(command_port));
590 for (i = 0; i < serial->num_ports; i++) {
591 port = serial->port[i];
592 info = usb_get_serial_port_data(port);
593 list_for_each_safe(tmp, tmp2, &info->rx_urbs_free) {
595 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
598 kfree(urb->transfer_buffer);
601 list_for_each_safe(tmp, tmp2, &info->tx_urbs_free) {
603 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
606 kfree(urb->transfer_buffer);
616 static int whiteheat_open (struct usb_serial_port *port, struct file *filp)
619 struct ktermios old_term;
621 dbg("%s - port %d", __func__, port->number);
623 retval = start_command_port(port->serial);
627 port->tty->low_latency = 1;
629 /* send an open port command */
630 retval = firm_open(port);
632 stop_command_port(port->serial);
636 retval = firm_purge(port, WHITEHEAT_PURGE_RX | WHITEHEAT_PURGE_TX);
639 stop_command_port(port->serial);
643 old_term.c_cflag = ~port->tty->termios->c_cflag;
644 old_term.c_iflag = ~port->tty->termios->c_iflag;
645 whiteheat_set_termios(port, &old_term);
647 /* Work around HCD bugs */
648 usb_clear_halt(port->serial->dev, port->read_urb->pipe);
649 usb_clear_halt(port->serial->dev, port->write_urb->pipe);
651 /* Start reading from the device */
652 retval = start_port_read(port);
654 err("%s - failed submitting read urb, error %d", __func__, retval);
656 stop_command_port(port->serial);
661 dbg("%s - exit, retval = %d", __func__, retval);
666 static void whiteheat_close(struct usb_serial_port *port, struct file * filp)
668 struct whiteheat_private *info = usb_get_serial_port_data(port);
669 struct whiteheat_urb_wrap *wrap;
671 struct list_head *tmp;
672 struct list_head *tmp2;
674 dbg("%s - port %d", __func__, port->number);
676 mutex_lock(&port->serial->disc_mutex);
677 /* filp is NULL when called from usb_serial_disconnect */
678 if ((filp && (tty_hung_up_p(filp))) || port->serial->disconnected) {
679 mutex_unlock(&port->serial->disc_mutex);
682 mutex_unlock(&port->serial->disc_mutex);
684 port->tty->closing = 1;
687 * Not currently in use; tty_wait_until_sent() calls
688 * serial_chars_in_buffer() which deadlocks on the second semaphore
689 * acquisition. This should be fixed at some point. Greg's been
691 if ((filp->f_flags & (O_NDELAY | O_NONBLOCK)) == 0) {
692 tty_wait_until_sent(port->tty, CLOSING_DELAY);
696 tty_driver_flush_buffer(port->tty);
697 tty_ldisc_flush(port->tty);
699 firm_report_tx_done(port);
703 /* shutdown our bulk reads and writes */
704 mutex_lock(&info->deathwarrant);
705 spin_lock_irq(&info->lock);
706 list_for_each_safe(tmp, tmp2, &info->rx_urbs_submitted) {
707 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
710 spin_unlock_irq(&info->lock);
712 spin_lock_irq(&info->lock);
713 list_add(tmp, &info->rx_urbs_free);
715 list_for_each_safe(tmp, tmp2, &info->rx_urb_q)
716 list_move(tmp, &info->rx_urbs_free);
717 list_for_each_safe(tmp, tmp2, &info->tx_urbs_submitted) {
718 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
721 spin_unlock_irq(&info->lock);
723 spin_lock_irq(&info->lock);
724 list_add(tmp, &info->tx_urbs_free);
726 spin_unlock_irq(&info->lock);
727 mutex_unlock(&info->deathwarrant);
729 stop_command_port(port->serial);
731 port->tty->closing = 0;
735 static int whiteheat_write(struct usb_serial_port *port, const unsigned char *buf, int count)
737 struct usb_serial *serial = port->serial;
738 struct whiteheat_private *info = usb_get_serial_port_data(port);
739 struct whiteheat_urb_wrap *wrap;
745 struct list_head *tmp;
747 dbg("%s - port %d", __func__, port->number);
750 dbg("%s - write request of 0 bytes", __func__);
755 spin_lock_irqsave(&info->lock, flags);
756 if (list_empty(&info->tx_urbs_free)) {
757 spin_unlock_irqrestore(&info->lock, flags);
760 tmp = list_first(&info->tx_urbs_free);
762 spin_unlock_irqrestore(&info->lock, flags);
764 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
766 bytes = (count > port->bulk_out_size) ? port->bulk_out_size : count;
767 memcpy (urb->transfer_buffer, buf + sent, bytes);
769 usb_serial_debug_data(debug, &port->dev, __func__, bytes, urb->transfer_buffer);
771 urb->dev = serial->dev;
772 urb->transfer_buffer_length = bytes;
773 result = usb_submit_urb(urb, GFP_ATOMIC);
775 err("%s - failed submitting write urb, error %d", __func__, result);
777 spin_lock_irqsave(&info->lock, flags);
778 list_add(tmp, &info->tx_urbs_free);
779 spin_unlock_irqrestore(&info->lock, flags);
784 spin_lock_irqsave(&info->lock, flags);
785 list_add(tmp, &info->tx_urbs_submitted);
786 spin_unlock_irqrestore(&info->lock, flags);
794 static int whiteheat_write_room(struct usb_serial_port *port)
796 struct whiteheat_private *info = usb_get_serial_port_data(port);
797 struct list_head *tmp;
801 dbg("%s - port %d", __func__, port->number);
803 spin_lock_irqsave(&info->lock, flags);
804 list_for_each(tmp, &info->tx_urbs_free)
806 spin_unlock_irqrestore(&info->lock, flags);
807 room *= port->bulk_out_size;
809 dbg("%s - returns %d", __func__, room);
814 static int whiteheat_tiocmget (struct usb_serial_port *port, struct file *file)
816 struct whiteheat_private *info = usb_get_serial_port_data(port);
817 unsigned int modem_signals = 0;
819 dbg("%s - port %d", __func__, port->number);
821 firm_get_dtr_rts(port);
822 if (info->mcr & UART_MCR_DTR)
823 modem_signals |= TIOCM_DTR;
824 if (info->mcr & UART_MCR_RTS)
825 modem_signals |= TIOCM_RTS;
827 return modem_signals;
831 static int whiteheat_tiocmset (struct usb_serial_port *port, struct file *file,
832 unsigned int set, unsigned int clear)
834 struct whiteheat_private *info = usb_get_serial_port_data(port);
836 dbg("%s - port %d", __func__, port->number);
839 info->mcr |= UART_MCR_RTS;
841 info->mcr |= UART_MCR_DTR;
843 if (clear & TIOCM_RTS)
844 info->mcr &= ~UART_MCR_RTS;
845 if (clear & TIOCM_DTR)
846 info->mcr &= ~UART_MCR_DTR;
848 firm_set_dtr(port, info->mcr & UART_MCR_DTR);
849 firm_set_rts(port, info->mcr & UART_MCR_RTS);
854 static int whiteheat_ioctl (struct usb_serial_port *port, struct file * file, unsigned int cmd, unsigned long arg)
856 struct serial_struct serstruct;
857 void __user *user_arg = (void __user *)arg;
859 dbg("%s - port %d, cmd 0x%.4x", __func__, port->number, cmd);
863 memset(&serstruct, 0, sizeof(serstruct));
864 serstruct.type = PORT_16654;
865 serstruct.line = port->serial->minor;
866 serstruct.port = port->number;
867 serstruct.flags = ASYNC_SKIP_TEST | ASYNC_AUTO_IRQ;
868 serstruct.xmit_fifo_size = port->bulk_out_size;
869 serstruct.custom_divisor = 0;
870 serstruct.baud_base = 460800;
871 serstruct.close_delay = CLOSING_DELAY;
872 serstruct.closing_wait = CLOSING_DELAY;
874 if (copy_to_user(user_arg, &serstruct, sizeof(serstruct)))
880 if (copy_from_user(&serstruct, user_arg, sizeof(serstruct)))
884 * For now this is ignored. dip sets the ASYNC_[V]HI flags
885 * but this isn't used by us at all. Maybe someone somewhere
886 * will need the custom_divisor setting.
899 static void whiteheat_set_termios(struct usb_serial_port *port, struct ktermios *old_termios)
901 dbg("%s -port %d", __func__, port->number);
902 firm_setup_port(port);
906 static void whiteheat_break_ctl(struct usb_serial_port *port, int break_state) {
907 firm_set_break(port, break_state);
911 static int whiteheat_chars_in_buffer(struct usb_serial_port *port)
913 struct whiteheat_private *info = usb_get_serial_port_data(port);
914 struct list_head *tmp;
915 struct whiteheat_urb_wrap *wrap;
919 dbg("%s - port %d", __func__, port->number);
921 spin_lock_irqsave(&info->lock, flags);
922 list_for_each(tmp, &info->tx_urbs_submitted) {
923 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
924 chars += wrap->urb->transfer_buffer_length;
926 spin_unlock_irqrestore(&info->lock, flags);
928 dbg ("%s - returns %d", __func__, chars);
933 static void whiteheat_throttle (struct usb_serial_port *port)
935 struct whiteheat_private *info = usb_get_serial_port_data(port);
938 dbg("%s - port %d", __func__, port->number);
940 spin_lock_irqsave(&info->lock, flags);
941 info->flags |= THROTTLED;
942 spin_unlock_irqrestore(&info->lock, flags);
948 static void whiteheat_unthrottle (struct usb_serial_port *port)
950 struct whiteheat_private *info = usb_get_serial_port_data(port);
951 int actually_throttled;
954 dbg("%s - port %d", __func__, port->number);
956 spin_lock_irqsave(&info->lock, flags);
957 actually_throttled = info->flags & ACTUALLY_THROTTLED;
958 info->flags &= ~(THROTTLED | ACTUALLY_THROTTLED);
959 spin_unlock_irqrestore(&info->lock, flags);
961 if (actually_throttled)
962 rx_data_softint(&info->rx_work);
968 /*****************************************************************************
969 * Connect Tech's White Heat callback routines
970 *****************************************************************************/
971 static void command_port_write_callback(struct urb *urb)
973 int status = urb->status;
978 dbg("nonzero urb status: %d", status);
984 static void command_port_read_callback(struct urb *urb)
986 struct usb_serial_port *command_port = urb->context;
987 struct whiteheat_command_private *command_info;
988 int status = urb->status;
989 unsigned char *data = urb->transfer_buffer;
994 command_info = usb_get_serial_port_data(command_port);
996 dbg ("%s - command_info is NULL, exiting.", __func__);
1000 dbg("%s - nonzero urb status: %d", __func__, status);
1001 if (status != -ENOENT)
1002 command_info->command_finished = WHITEHEAT_CMD_FAILURE;
1003 wake_up(&command_info->wait_command);
1007 usb_serial_debug_data(debug, &command_port->dev, __func__, urb->actual_length, data);
1009 if (data[0] == WHITEHEAT_CMD_COMPLETE) {
1010 command_info->command_finished = WHITEHEAT_CMD_COMPLETE;
1011 wake_up(&command_info->wait_command);
1012 } else if (data[0] == WHITEHEAT_CMD_FAILURE) {
1013 command_info->command_finished = WHITEHEAT_CMD_FAILURE;
1014 wake_up(&command_info->wait_command);
1015 } else if (data[0] == WHITEHEAT_EVENT) {
1016 /* These are unsolicited reports from the firmware, hence no waiting command to wakeup */
1017 dbg("%s - event received", __func__);
1018 } else if (data[0] == WHITEHEAT_GET_DTR_RTS) {
1019 memcpy(command_info->result_buffer, &data[1], urb->actual_length - 1);
1020 command_info->command_finished = WHITEHEAT_CMD_COMPLETE;
1021 wake_up(&command_info->wait_command);
1023 dbg("%s - bad reply from firmware", __func__);
1026 /* Continue trying to always read */
1027 command_port->read_urb->dev = command_port->serial->dev;
1028 result = usb_submit_urb(command_port->read_urb, GFP_ATOMIC);
1030 dbg("%s - failed resubmitting read urb, error %d", __func__, result);
1034 static void whiteheat_read_callback(struct urb *urb)
1036 struct usb_serial_port *port = urb->context;
1037 struct whiteheat_urb_wrap *wrap;
1038 unsigned char *data = urb->transfer_buffer;
1039 struct whiteheat_private *info = usb_get_serial_port_data(port);
1040 int status = urb->status;
1042 dbg("%s - port %d", __func__, port->number);
1044 spin_lock(&info->lock);
1045 wrap = urb_to_wrap(urb, &info->rx_urbs_submitted);
1047 spin_unlock(&info->lock);
1048 err("%s - Not my urb!", __func__);
1051 list_del(&wrap->list);
1052 spin_unlock(&info->lock);
1055 dbg("%s - nonzero read bulk status received: %d",
1057 spin_lock(&info->lock);
1058 list_add(&wrap->list, &info->rx_urbs_free);
1059 spin_unlock(&info->lock);
1063 usb_serial_debug_data(debug, &port->dev, __func__, urb->actual_length, data);
1065 spin_lock(&info->lock);
1066 list_add_tail(&wrap->list, &info->rx_urb_q);
1067 if (info->flags & THROTTLED) {
1068 info->flags |= ACTUALLY_THROTTLED;
1069 spin_unlock(&info->lock);
1072 spin_unlock(&info->lock);
1074 schedule_work(&info->rx_work);
1078 static void whiteheat_write_callback(struct urb *urb)
1080 struct usb_serial_port *port = urb->context;
1081 struct whiteheat_private *info = usb_get_serial_port_data(port);
1082 struct whiteheat_urb_wrap *wrap;
1083 int status = urb->status;
1085 dbg("%s - port %d", __func__, port->number);
1087 spin_lock(&info->lock);
1088 wrap = urb_to_wrap(urb, &info->tx_urbs_submitted);
1090 spin_unlock(&info->lock);
1091 err("%s - Not my urb!", __func__);
1094 list_move(&wrap->list, &info->tx_urbs_free);
1095 spin_unlock(&info->lock);
1098 dbg("%s - nonzero write bulk status received: %d",
1103 usb_serial_port_softint(port);
1107 /*****************************************************************************
1108 * Connect Tech's White Heat firmware interface
1109 *****************************************************************************/
1110 static int firm_send_command(struct usb_serial_port *port, __u8 command, __u8 *data, __u8 datasize)
1112 struct usb_serial_port *command_port;
1113 struct whiteheat_command_private *command_info;
1114 struct whiteheat_private *info;
1115 __u8 *transfer_buffer;
1119 dbg("%s - command %d", __func__, command);
1121 command_port = port->serial->port[COMMAND_PORT];
1122 command_info = usb_get_serial_port_data(command_port);
1123 mutex_lock(&command_info->mutex);
1124 command_info->command_finished = false;
1126 transfer_buffer = (__u8 *)command_port->write_urb->transfer_buffer;
1127 transfer_buffer[0] = command;
1128 memcpy (&transfer_buffer[1], data, datasize);
1129 command_port->write_urb->transfer_buffer_length = datasize + 1;
1130 command_port->write_urb->dev = port->serial->dev;
1131 retval = usb_submit_urb (command_port->write_urb, GFP_NOIO);
1133 dbg("%s - submit urb failed", __func__);
1137 /* wait for the command to complete */
1138 t = wait_event_timeout(command_info->wait_command,
1139 (bool)command_info->command_finished, COMMAND_TIMEOUT);
1141 usb_kill_urb(command_port->write_urb);
1143 if (command_info->command_finished == false) {
1144 dbg("%s - command timed out.", __func__);
1145 retval = -ETIMEDOUT;
1149 if (command_info->command_finished == WHITEHEAT_CMD_FAILURE) {
1150 dbg("%s - command failed.", __func__);
1155 if (command_info->command_finished == WHITEHEAT_CMD_COMPLETE) {
1156 dbg("%s - command completed.", __func__);
1158 case WHITEHEAT_GET_DTR_RTS:
1159 info = usb_get_serial_port_data(port);
1160 memcpy(&info->mcr, command_info->result_buffer, sizeof(struct whiteheat_dr_info));
1166 mutex_unlock(&command_info->mutex);
1171 static int firm_open(struct usb_serial_port *port) {
1172 struct whiteheat_simple open_command;
1174 open_command.port = port->number - port->serial->minor + 1;
1175 return firm_send_command(port, WHITEHEAT_OPEN, (__u8 *)&open_command, sizeof(open_command));
1179 static int firm_close(struct usb_serial_port *port) {
1180 struct whiteheat_simple close_command;
1182 close_command.port = port->number - port->serial->minor + 1;
1183 return firm_send_command(port, WHITEHEAT_CLOSE, (__u8 *)&close_command, sizeof(close_command));
1187 static int firm_setup_port(struct usb_serial_port *port) {
1188 struct whiteheat_port_settings port_settings;
1189 unsigned int cflag = port->tty->termios->c_cflag;
1191 port_settings.port = port->number + 1;
1193 /* get the byte size */
1194 switch (cflag & CSIZE) {
1195 case CS5: port_settings.bits = 5; break;
1196 case CS6: port_settings.bits = 6; break;
1197 case CS7: port_settings.bits = 7; break;
1199 case CS8: port_settings.bits = 8; break;
1201 dbg("%s - data bits = %d", __func__, port_settings.bits);
1203 /* determine the parity */
1207 port_settings.parity = WHITEHEAT_PAR_MARK;
1209 port_settings.parity = WHITEHEAT_PAR_SPACE;
1212 port_settings.parity = WHITEHEAT_PAR_ODD;
1214 port_settings.parity = WHITEHEAT_PAR_EVEN;
1216 port_settings.parity = WHITEHEAT_PAR_NONE;
1217 dbg("%s - parity = %c", __func__, port_settings.parity);
1219 /* figure out the stop bits requested */
1221 port_settings.stop = 2;
1223 port_settings.stop = 1;
1224 dbg("%s - stop bits = %d", __func__, port_settings.stop);
1226 /* figure out the flow control settings */
1227 if (cflag & CRTSCTS)
1228 port_settings.hflow = (WHITEHEAT_HFLOW_CTS | WHITEHEAT_HFLOW_RTS);
1230 port_settings.hflow = WHITEHEAT_HFLOW_NONE;
1231 dbg("%s - hardware flow control = %s %s %s %s", __func__,
1232 (port_settings.hflow & WHITEHEAT_HFLOW_CTS) ? "CTS" : "",
1233 (port_settings.hflow & WHITEHEAT_HFLOW_RTS) ? "RTS" : "",
1234 (port_settings.hflow & WHITEHEAT_HFLOW_DSR) ? "DSR" : "",
1235 (port_settings.hflow & WHITEHEAT_HFLOW_DTR) ? "DTR" : "");
1237 /* determine software flow control */
1238 if (I_IXOFF(port->tty))
1239 port_settings.sflow = WHITEHEAT_SFLOW_RXTX;
1241 port_settings.sflow = WHITEHEAT_SFLOW_NONE;
1242 dbg("%s - software flow control = %c", __func__, port_settings.sflow);
1244 port_settings.xon = START_CHAR(port->tty);
1245 port_settings.xoff = STOP_CHAR(port->tty);
1246 dbg("%s - XON = %2x, XOFF = %2x", __func__, port_settings.xon, port_settings.xoff);
1248 /* get the baud rate wanted */
1249 port_settings.baud = tty_get_baud_rate(port->tty);
1250 dbg("%s - baud rate = %d", __func__, port_settings.baud);
1252 /* fixme: should set validated settings */
1253 tty_encode_baud_rate(port->tty, port_settings.baud, port_settings.baud);
1254 /* handle any settings that aren't specified in the tty structure */
1255 port_settings.lloop = 0;
1257 /* now send the message to the device */
1258 return firm_send_command(port, WHITEHEAT_SETUP_PORT, (__u8 *)&port_settings, sizeof(port_settings));
1262 static int firm_set_rts(struct usb_serial_port *port, __u8 onoff) {
1263 struct whiteheat_set_rdb rts_command;
1265 rts_command.port = port->number - port->serial->minor + 1;
1266 rts_command.state = onoff;
1267 return firm_send_command(port, WHITEHEAT_SET_RTS, (__u8 *)&rts_command, sizeof(rts_command));
1271 static int firm_set_dtr(struct usb_serial_port *port, __u8 onoff) {
1272 struct whiteheat_set_rdb dtr_command;
1274 dtr_command.port = port->number - port->serial->minor + 1;
1275 dtr_command.state = onoff;
1276 return firm_send_command(port, WHITEHEAT_SET_RTS, (__u8 *)&dtr_command, sizeof(dtr_command));
1280 static int firm_set_break(struct usb_serial_port *port, __u8 onoff) {
1281 struct whiteheat_set_rdb break_command;
1283 break_command.port = port->number - port->serial->minor + 1;
1284 break_command.state = onoff;
1285 return firm_send_command(port, WHITEHEAT_SET_RTS, (__u8 *)&break_command, sizeof(break_command));
1289 static int firm_purge(struct usb_serial_port *port, __u8 rxtx) {
1290 struct whiteheat_purge purge_command;
1292 purge_command.port = port->number - port->serial->minor + 1;
1293 purge_command.what = rxtx;
1294 return firm_send_command(port, WHITEHEAT_PURGE, (__u8 *)&purge_command, sizeof(purge_command));
1298 static int firm_get_dtr_rts(struct usb_serial_port *port) {
1299 struct whiteheat_simple get_dr_command;
1301 get_dr_command.port = port->number - port->serial->minor + 1;
1302 return firm_send_command(port, WHITEHEAT_GET_DTR_RTS, (__u8 *)&get_dr_command, sizeof(get_dr_command));
1306 static int firm_report_tx_done(struct usb_serial_port *port) {
1307 struct whiteheat_simple close_command;
1309 close_command.port = port->number - port->serial->minor + 1;
1310 return firm_send_command(port, WHITEHEAT_REPORT_TX_DONE, (__u8 *)&close_command, sizeof(close_command));
1314 /*****************************************************************************
1315 * Connect Tech's White Heat utility functions
1316 *****************************************************************************/
1317 static int start_command_port(struct usb_serial *serial)
1319 struct usb_serial_port *command_port;
1320 struct whiteheat_command_private *command_info;
1323 command_port = serial->port[COMMAND_PORT];
1324 command_info = usb_get_serial_port_data(command_port);
1325 mutex_lock(&command_info->mutex);
1326 if (!command_info->port_running) {
1327 /* Work around HCD bugs */
1328 usb_clear_halt(serial->dev, command_port->read_urb->pipe);
1330 command_port->read_urb->dev = serial->dev;
1331 retval = usb_submit_urb(command_port->read_urb, GFP_KERNEL);
1333 err("%s - failed submitting read urb, error %d", __func__, retval);
1337 command_info->port_running++;
1340 mutex_unlock(&command_info->mutex);
1345 static void stop_command_port(struct usb_serial *serial)
1347 struct usb_serial_port *command_port;
1348 struct whiteheat_command_private *command_info;
1350 command_port = serial->port[COMMAND_PORT];
1351 command_info = usb_get_serial_port_data(command_port);
1352 mutex_lock(&command_info->mutex);
1353 command_info->port_running--;
1354 if (!command_info->port_running)
1355 usb_kill_urb(command_port->read_urb);
1356 mutex_unlock(&command_info->mutex);
1360 static int start_port_read(struct usb_serial_port *port)
1362 struct whiteheat_private *info = usb_get_serial_port_data(port);
1363 struct whiteheat_urb_wrap *wrap;
1366 unsigned long flags;
1367 struct list_head *tmp;
1368 struct list_head *tmp2;
1370 spin_lock_irqsave(&info->lock, flags);
1372 list_for_each_safe(tmp, tmp2, &info->rx_urbs_free) {
1374 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1376 urb->dev = port->serial->dev;
1377 spin_unlock_irqrestore(&info->lock, flags);
1378 retval = usb_submit_urb(urb, GFP_KERNEL);
1380 spin_lock_irqsave(&info->lock, flags);
1381 list_add(tmp, &info->rx_urbs_free);
1382 list_for_each_safe(tmp, tmp2, &info->rx_urbs_submitted) {
1383 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1386 spin_unlock_irqrestore(&info->lock, flags);
1388 spin_lock_irqsave(&info->lock, flags);
1389 list_add(tmp, &info->rx_urbs_free);
1393 spin_lock_irqsave(&info->lock, flags);
1394 list_add(tmp, &info->rx_urbs_submitted);
1397 spin_unlock_irqrestore(&info->lock, flags);
1403 static struct whiteheat_urb_wrap *urb_to_wrap(struct urb* urb, struct list_head *head)
1405 struct whiteheat_urb_wrap *wrap;
1406 struct list_head *tmp;
1408 list_for_each(tmp, head) {
1409 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1410 if (wrap->urb == urb)
1418 static struct list_head *list_first(struct list_head *head)
1424 static void rx_data_softint(struct work_struct *work)
1426 struct whiteheat_private *info =
1427 container_of(work, struct whiteheat_private, rx_work);
1428 struct usb_serial_port *port = info->port;
1429 struct tty_struct *tty = port->tty;
1430 struct whiteheat_urb_wrap *wrap;
1432 unsigned long flags;
1433 struct list_head *tmp;
1434 struct list_head *tmp2;
1438 spin_lock_irqsave(&info->lock, flags);
1439 if (info->flags & THROTTLED) {
1440 spin_unlock_irqrestore(&info->lock, flags);
1444 list_for_each_safe(tmp, tmp2, &info->rx_urb_q) {
1446 spin_unlock_irqrestore(&info->lock, flags);
1448 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1451 if (tty && urb->actual_length) {
1452 int len = tty_buffer_request_room(tty, urb->actual_length);
1453 /* This stuff can go away now I suspect */
1454 if (unlikely(len < urb->actual_length)) {
1455 spin_lock_irqsave(&info->lock, flags);
1456 list_add(tmp, &info->rx_urb_q);
1457 spin_unlock_irqrestore(&info->lock, flags);
1458 tty_flip_buffer_push(tty);
1459 schedule_work(&info->rx_work);
1462 tty_insert_flip_string(tty, urb->transfer_buffer, len);
1466 urb->dev = port->serial->dev;
1467 result = usb_submit_urb(urb, GFP_ATOMIC);
1469 err("%s - failed resubmitting read urb, error %d", __func__, result);
1470 spin_lock_irqsave(&info->lock, flags);
1471 list_add(tmp, &info->rx_urbs_free);
1475 spin_lock_irqsave(&info->lock, flags);
1476 list_add(tmp, &info->rx_urbs_submitted);
1478 spin_unlock_irqrestore(&info->lock, flags);
1481 tty_flip_buffer_push(tty);
1485 /*****************************************************************************
1486 * Connect Tech's White Heat module functions
1487 *****************************************************************************/
1488 static int __init whiteheat_init (void)
1491 retval = usb_serial_register(&whiteheat_fake_device);
1493 goto failed_fake_register;
1494 retval = usb_serial_register(&whiteheat_device);
1496 goto failed_device_register;
1497 retval = usb_register(&whiteheat_driver);
1499 goto failed_usb_register;
1500 info(DRIVER_DESC " " DRIVER_VERSION);
1502 failed_usb_register:
1503 usb_serial_deregister(&whiteheat_device);
1504 failed_device_register:
1505 usb_serial_deregister(&whiteheat_fake_device);
1506 failed_fake_register:
1511 static void __exit whiteheat_exit (void)
1513 usb_deregister (&whiteheat_driver);
1514 usb_serial_deregister (&whiteheat_fake_device);
1515 usb_serial_deregister (&whiteheat_device);
1519 module_init(whiteheat_init);
1520 module_exit(whiteheat_exit);
1522 MODULE_AUTHOR( DRIVER_AUTHOR );
1523 MODULE_DESCRIPTION( DRIVER_DESC );
1524 MODULE_LICENSE("GPL");
1526 MODULE_FIRMWARE("whiteheat.fw");
1527 MODULE_FIRMWARE("whiteheat_loader.fw");
1529 module_param(urb_pool_size, int, 0);
1530 MODULE_PARM_DESC(urb_pool_size, "Number of urbs to use for buffering");
1532 module_param(debug, bool, S_IRUGO | S_IWUSR);
1533 MODULE_PARM_DESC(debug, "Debug enabled or not");