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
18 * (10/09/2002) Stuart MacDonald (stuartm@connecttech.com)
19 * Upgrade to full working driver
22 * switched from using spinlock to a semaphore, which fixes lots of
26 * Identify version on module load.
29 * Fixed MOD_INC and MOD_DEC logic, the ability to open a port more
30 * than once, and the got the proper usb_device_id table entries so
31 * the driver works again.
33 * (11/01/2000) Adam J. Richter
34 * usb_device_id table support
37 * Fixed bug with urb->dev not being set properly, now that the usb
41 * firmware is improved to guard against crap sent to device
42 * firmware now replies CMD_FAILURE on bad things
43 * read_callback fix you provided for private info struct
44 * command_finished now indicates success or fail
45 * setup_port struct now packed to avoid gcc padding
46 * firmware uses 1 based port numbering, driver now handles that
49 * Removed DEBUG #ifdefs with call to usb_serial_debug_data
52 * Added module_init and module_exit functions to handle the fact that this
53 * driver is a loadable module now.
54 * Fixed bug with port->minor that was found by Al Borchers
57 * Added support for port settings. Baud rate can now be changed. Line
58 * signals are not transferred to and from the tty layer yet, but things
59 * seem to be working well now.
62 * First cut at open and close commands. Data can flow through the ports at
66 * Split driver up into device specific pieces.
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/mutex.h>
80 #include <linux/uaccess.h>
81 #include <asm/termbits.h>
82 #include <linux/usb.h>
83 #include <linux/serial_reg.h>
84 #include <linux/serial.h>
85 #include <linux/usb/serial.h>
86 #include <linux/firmware.h>
87 #include <linux/ihex.h>
88 #include "whiteheat.h" /* WhiteHEAT specific commands */
99 #define DRIVER_VERSION "v2.0"
100 #define DRIVER_AUTHOR "Greg Kroah-Hartman <greg@kroah.com>, Stuart MacDonald <stuartm@connecttech.com>"
101 #define DRIVER_DESC "USB ConnectTech WhiteHEAT driver"
103 #define CONNECT_TECH_VENDOR_ID 0x0710
104 #define CONNECT_TECH_FAKE_WHITE_HEAT_ID 0x0001
105 #define CONNECT_TECH_WHITE_HEAT_ID 0x8001
108 ID tables for whiteheat are unusual, because we want to different
109 things for different versions of the device. Eventually, this
110 will be doable from a single table. But, for now, we define two
111 separate ID tables, and then a third table that combines them
112 just for the purpose of exporting the autoloading information.
114 static const struct usb_device_id id_table_std[] = {
115 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_WHITE_HEAT_ID) },
116 { } /* Terminating entry */
119 static const struct usb_device_id id_table_prerenumeration[] = {
120 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_FAKE_WHITE_HEAT_ID) },
121 { } /* Terminating entry */
124 static const struct usb_device_id id_table_combined[] = {
125 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_WHITE_HEAT_ID) },
126 { USB_DEVICE(CONNECT_TECH_VENDOR_ID, CONNECT_TECH_FAKE_WHITE_HEAT_ID) },
127 { } /* Terminating entry */
130 MODULE_DEVICE_TABLE(usb, id_table_combined);
132 static struct usb_driver whiteheat_driver = {
134 .probe = usb_serial_probe,
135 .disconnect = usb_serial_disconnect,
136 .id_table = id_table_combined,
140 /* function prototypes for the Connect Tech WhiteHEAT prerenumeration device */
141 static int whiteheat_firmware_download(struct usb_serial *serial,
142 const struct usb_device_id *id);
143 static int whiteheat_firmware_attach(struct usb_serial *serial);
145 /* function prototypes for the Connect Tech WhiteHEAT serial converter */
146 static int whiteheat_attach(struct usb_serial *serial);
147 static void whiteheat_release(struct usb_serial *serial);
148 static int whiteheat_open(struct tty_struct *tty,
149 struct usb_serial_port *port);
150 static void whiteheat_close(struct usb_serial_port *port);
151 static int whiteheat_write(struct tty_struct *tty,
152 struct usb_serial_port *port,
153 const unsigned char *buf, int count);
154 static int whiteheat_write_room(struct tty_struct *tty);
155 static int whiteheat_ioctl(struct tty_struct *tty,
156 unsigned int cmd, unsigned long arg);
157 static void whiteheat_set_termios(struct tty_struct *tty,
158 struct usb_serial_port *port, struct ktermios *old);
159 static int whiteheat_tiocmget(struct tty_struct *tty);
160 static int whiteheat_tiocmset(struct tty_struct *tty,
161 unsigned int set, unsigned int clear);
162 static void whiteheat_break_ctl(struct tty_struct *tty, int break_state);
163 static int whiteheat_chars_in_buffer(struct tty_struct *tty);
164 static void whiteheat_throttle(struct tty_struct *tty);
165 static void whiteheat_unthrottle(struct tty_struct *tty);
166 static void whiteheat_read_callback(struct urb *urb);
167 static void whiteheat_write_callback(struct urb *urb);
169 static struct usb_serial_driver whiteheat_fake_device = {
171 .owner = THIS_MODULE,
172 .name = "whiteheatnofirm",
174 .description = "Connect Tech - WhiteHEAT - (prerenumeration)",
175 .usb_driver = &whiteheat_driver,
176 .id_table = id_table_prerenumeration,
178 .probe = whiteheat_firmware_download,
179 .attach = whiteheat_firmware_attach,
182 static struct usb_serial_driver whiteheat_device = {
184 .owner = THIS_MODULE,
187 .description = "Connect Tech - WhiteHEAT",
188 .usb_driver = &whiteheat_driver,
189 .id_table = id_table_std,
191 .attach = whiteheat_attach,
192 .release = whiteheat_release,
193 .open = whiteheat_open,
194 .close = whiteheat_close,
195 .write = whiteheat_write,
196 .write_room = whiteheat_write_room,
197 .ioctl = whiteheat_ioctl,
198 .set_termios = whiteheat_set_termios,
199 .break_ctl = whiteheat_break_ctl,
200 .tiocmget = whiteheat_tiocmget,
201 .tiocmset = whiteheat_tiocmset,
202 .chars_in_buffer = whiteheat_chars_in_buffer,
203 .throttle = whiteheat_throttle,
204 .unthrottle = whiteheat_unthrottle,
205 .read_bulk_callback = whiteheat_read_callback,
206 .write_bulk_callback = whiteheat_write_callback,
210 struct whiteheat_command_private {
213 __u8 command_finished;
214 wait_queue_head_t wait_command; /* for handling sleeping whilst
215 waiting for a command to
217 __u8 result_buffer[64];
221 #define THROTTLED 0x01
222 #define ACTUALLY_THROTTLED 0x02
224 static int urb_pool_size = 8;
226 struct whiteheat_urb_wrap {
227 struct list_head list;
231 struct whiteheat_private {
234 __u8 mcr; /* FIXME: no locking on mcr */
235 struct list_head rx_urbs_free;
236 struct list_head rx_urbs_submitted;
237 struct list_head rx_urb_q;
238 struct work_struct rx_work;
239 struct usb_serial_port *port;
240 struct list_head tx_urbs_free;
241 struct list_head tx_urbs_submitted;
242 struct mutex deathwarrant;
246 /* local function prototypes */
247 static int start_command_port(struct usb_serial *serial);
248 static void stop_command_port(struct usb_serial *serial);
249 static void command_port_write_callback(struct urb *urb);
250 static void command_port_read_callback(struct urb *urb);
252 static int start_port_read(struct usb_serial_port *port);
253 static struct whiteheat_urb_wrap *urb_to_wrap(struct urb *urb,
254 struct list_head *head);
255 static struct list_head *list_first(struct list_head *head);
256 static void rx_data_softint(struct work_struct *work);
258 static int firm_send_command(struct usb_serial_port *port, __u8 command,
259 __u8 *data, __u8 datasize);
260 static int firm_open(struct usb_serial_port *port);
261 static int firm_close(struct usb_serial_port *port);
262 static void firm_setup_port(struct tty_struct *tty);
263 static int firm_set_rts(struct usb_serial_port *port, __u8 onoff);
264 static int firm_set_dtr(struct usb_serial_port *port, __u8 onoff);
265 static int firm_set_break(struct usb_serial_port *port, __u8 onoff);
266 static int firm_purge(struct usb_serial_port *port, __u8 rxtx);
267 static int firm_get_dtr_rts(struct usb_serial_port *port);
268 static int firm_report_tx_done(struct usb_serial_port *port);
271 #define COMMAND_PORT 4
272 #define COMMAND_TIMEOUT (2*HZ) /* 2 second timeout for a command */
273 #define COMMAND_TIMEOUT_MS 2000
274 #define CLOSING_DELAY (30 * HZ)
277 /*****************************************************************************
278 * Connect Tech's White Heat prerenumeration driver functions
279 *****************************************************************************/
281 /* steps to download the firmware to the WhiteHEAT device:
282 - hold the reset (by writing to the reset bit of the CPUCS register)
283 - download the VEND_AX.HEX file to the chip using VENDOR_REQUEST-ANCHOR_LOAD
284 - release the reset (by writing to the CPUCS register)
285 - download the WH.HEX file for all addresses greater than 0x1b3f using
286 VENDOR_REQUEST-ANCHOR_EXTERNAL_RAM_LOAD
288 - download the WH.HEX file for all addresses less than 0x1b40 using
289 VENDOR_REQUEST_ANCHOR_LOAD
291 - device renumerated itself and comes up as new device id with all
292 firmware download completed.
294 static int whiteheat_firmware_download(struct usb_serial *serial,
295 const struct usb_device_id *id)
297 int response, ret = -ENOENT;
298 const struct firmware *loader_fw = NULL, *firmware_fw = NULL;
299 const struct ihex_binrec *record;
303 if (request_ihex_firmware(&firmware_fw, "whiteheat.fw",
304 &serial->dev->dev)) {
305 dev_err(&serial->dev->dev,
306 "%s - request \"whiteheat.fw\" failed\n", __func__);
309 if (request_ihex_firmware(&loader_fw, "whiteheat_loader.fw",
310 &serial->dev->dev)) {
311 dev_err(&serial->dev->dev,
312 "%s - request \"whiteheat_loader.fw\" failed\n",
317 response = ezusb_set_reset (serial, 1);
319 record = (const struct ihex_binrec *)loader_fw->data;
321 response = ezusb_writememory (serial, be32_to_cpu(record->addr),
322 (unsigned char *)record->data,
323 be16_to_cpu(record->len), 0xa0);
325 dev_err(&serial->dev->dev, "%s - ezusb_writememory "
326 "failed for loader (%d %04X %p %d)\n",
327 __func__, response, be32_to_cpu(record->addr),
328 record->data, be16_to_cpu(record->len));
331 record = ihex_next_binrec(record);
334 response = ezusb_set_reset(serial, 0);
336 record = (const struct ihex_binrec *)firmware_fw->data;
337 while (record && be32_to_cpu(record->addr) < 0x1b40)
338 record = ihex_next_binrec(record);
340 response = ezusb_writememory (serial, be32_to_cpu(record->addr),
341 (unsigned char *)record->data,
342 be16_to_cpu(record->len), 0xa3);
344 dev_err(&serial->dev->dev, "%s - ezusb_writememory "
345 "failed for first firmware step "
346 "(%d %04X %p %d)\n", __func__, response,
347 be32_to_cpu(record->addr), record->data,
348 be16_to_cpu(record->len));
354 response = ezusb_set_reset(serial, 1);
356 record = (const struct ihex_binrec *)firmware_fw->data;
357 while (record && be32_to_cpu(record->addr) < 0x1b40) {
358 response = ezusb_writememory (serial, be32_to_cpu(record->addr),
359 (unsigned char *)record->data,
360 be16_to_cpu(record->len), 0xa0);
362 dev_err(&serial->dev->dev, "%s - ezusb_writememory "
363 "failed for second firmware step "
364 "(%d %04X %p %d)\n", __func__, response,
365 be32_to_cpu(record->addr), record->data,
366 be16_to_cpu(record->len));
372 response = ezusb_set_reset (serial, 0);
374 release_firmware(loader_fw);
375 release_firmware(firmware_fw);
380 static int whiteheat_firmware_attach(struct usb_serial *serial)
382 /* We want this device to fail to have a driver assigned to it */
387 /*****************************************************************************
388 * Connect Tech's White Heat serial driver functions
389 *****************************************************************************/
390 static int whiteheat_attach(struct usb_serial *serial)
392 struct usb_serial_port *command_port;
393 struct whiteheat_command_private *command_info;
394 struct usb_serial_port *port;
395 struct whiteheat_private *info;
396 struct whiteheat_hw_info *hw_info;
406 struct whiteheat_urb_wrap *wrap;
407 struct list_head *tmp;
409 command_port = serial->port[COMMAND_PORT];
411 pipe = usb_sndbulkpipe(serial->dev,
412 command_port->bulk_out_endpointAddress);
413 command = kmalloc(2, GFP_KERNEL);
415 goto no_command_buffer;
416 command[0] = WHITEHEAT_GET_HW_INFO;
419 result = kmalloc(sizeof(*hw_info) + 1, GFP_KERNEL);
421 goto no_result_buffer;
423 * When the module is reloaded the firmware is still there and
424 * the endpoints are still in the usb core unchanged. This is the
425 * unlinking bug in disguise. Same for the call below.
427 usb_clear_halt(serial->dev, pipe);
428 ret = usb_bulk_msg(serial->dev, pipe, command, 2,
429 &alen, COMMAND_TIMEOUT_MS);
431 dev_err(&serial->dev->dev, "%s: Couldn't send command [%d]\n",
432 serial->type->description, ret);
434 } else if (alen != 2) {
435 dev_err(&serial->dev->dev, "%s: Send command incomplete [%d]\n",
436 serial->type->description, alen);
440 pipe = usb_rcvbulkpipe(serial->dev,
441 command_port->bulk_in_endpointAddress);
442 /* See the comment on the usb_clear_halt() above */
443 usb_clear_halt(serial->dev, pipe);
444 ret = usb_bulk_msg(serial->dev, pipe, result,
445 sizeof(*hw_info) + 1, &alen, COMMAND_TIMEOUT_MS);
447 dev_err(&serial->dev->dev, "%s: Couldn't get results [%d]\n",
448 serial->type->description, ret);
450 } else if (alen != sizeof(*hw_info) + 1) {
451 dev_err(&serial->dev->dev, "%s: Get results incomplete [%d]\n",
452 serial->type->description, alen);
454 } else if (result[0] != command[0]) {
455 dev_err(&serial->dev->dev, "%s: Command failed [%d]\n",
456 serial->type->description, result[0]);
460 hw_info = (struct whiteheat_hw_info *)&result[1];
462 dev_info(&serial->dev->dev, "%s: Driver %s: Firmware v%d.%02d\n",
463 serial->type->description, DRIVER_VERSION,
464 hw_info->sw_major_rev, hw_info->sw_minor_rev);
466 for (i = 0; i < serial->num_ports; i++) {
467 port = serial->port[i];
469 info = kmalloc(sizeof(struct whiteheat_private), GFP_KERNEL);
472 "%s: Out of memory for port structures\n",
473 serial->type->description);
477 spin_lock_init(&info->lock);
478 mutex_init(&info->deathwarrant);
481 INIT_WORK(&info->rx_work, rx_data_softint);
484 INIT_LIST_HEAD(&info->rx_urbs_free);
485 INIT_LIST_HEAD(&info->rx_urbs_submitted);
486 INIT_LIST_HEAD(&info->rx_urb_q);
487 INIT_LIST_HEAD(&info->tx_urbs_free);
488 INIT_LIST_HEAD(&info->tx_urbs_submitted);
490 for (j = 0; j < urb_pool_size; j++) {
491 urb = usb_alloc_urb(0, GFP_KERNEL);
493 dev_err(&port->dev, "No free urbs available\n");
496 buf_size = port->read_urb->transfer_buffer_length;
497 urb->transfer_buffer = kmalloc(buf_size, GFP_KERNEL);
498 if (!urb->transfer_buffer) {
500 "Couldn't allocate urb buffer\n");
503 wrap = kmalloc(sizeof(*wrap), GFP_KERNEL);
506 "Couldn't allocate urb wrapper\n");
509 usb_fill_bulk_urb(urb, serial->dev,
510 usb_rcvbulkpipe(serial->dev,
511 port->bulk_in_endpointAddress),
512 urb->transfer_buffer, buf_size,
513 whiteheat_read_callback, port);
515 list_add(&wrap->list, &info->rx_urbs_free);
517 urb = usb_alloc_urb(0, GFP_KERNEL);
519 dev_err(&port->dev, "No free urbs available\n");
522 buf_size = port->write_urb->transfer_buffer_length;
523 urb->transfer_buffer = kmalloc(buf_size, GFP_KERNEL);
524 if (!urb->transfer_buffer) {
526 "Couldn't allocate urb buffer\n");
529 wrap = kmalloc(sizeof(*wrap), GFP_KERNEL);
532 "Couldn't allocate urb wrapper\n");
535 usb_fill_bulk_urb(urb, serial->dev,
536 usb_sndbulkpipe(serial->dev,
537 port->bulk_out_endpointAddress),
538 urb->transfer_buffer, buf_size,
539 whiteheat_write_callback, port);
541 list_add(&wrap->list, &info->tx_urbs_free);
544 usb_set_serial_port_data(port, info);
547 command_info = kmalloc(sizeof(struct whiteheat_command_private),
549 if (command_info == NULL) {
550 dev_err(&serial->dev->dev,
551 "%s: Out of memory for port structures\n",
552 serial->type->description);
553 goto no_command_private;
556 mutex_init(&command_info->mutex);
557 command_info->port_running = 0;
558 init_waitqueue_head(&command_info->wait_command);
559 usb_set_serial_port_data(command_port, command_info);
560 command_port->write_urb->complete = command_port_write_callback;
561 command_port->read_urb->complete = command_port_read_callback;
568 /* Firmware likely not running */
569 dev_err(&serial->dev->dev,
570 "%s: Unable to retrieve firmware version, try replugging\n",
571 serial->type->description);
572 dev_err(&serial->dev->dev,
573 "%s: If the firmware is not running (status led not blinking)\n",
574 serial->type->description);
575 dev_err(&serial->dev->dev,
576 "%s: please contact support@connecttech.com\n",
577 serial->type->description);
583 for (i = serial->num_ports - 1; i >= 0; i--) {
584 port = serial->port[i];
585 info = usb_get_serial_port_data(port);
586 for (j = urb_pool_size - 1; j >= 0; j--) {
587 tmp = list_first(&info->tx_urbs_free);
589 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
593 kfree(urb->transfer_buffer);
597 tmp = list_first(&info->rx_urbs_free);
599 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
603 kfree(urb->transfer_buffer);
621 static void whiteheat_release(struct usb_serial *serial)
623 struct usb_serial_port *command_port;
624 struct usb_serial_port *port;
625 struct whiteheat_private *info;
626 struct whiteheat_urb_wrap *wrap;
628 struct list_head *tmp;
629 struct list_head *tmp2;
634 /* free up our private data for our command port */
635 command_port = serial->port[COMMAND_PORT];
636 kfree(usb_get_serial_port_data(command_port));
638 for (i = 0; i < serial->num_ports; i++) {
639 port = serial->port[i];
640 info = usb_get_serial_port_data(port);
641 list_for_each_safe(tmp, tmp2, &info->rx_urbs_free) {
643 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
646 kfree(urb->transfer_buffer);
649 list_for_each_safe(tmp, tmp2, &info->tx_urbs_free) {
651 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
654 kfree(urb->transfer_buffer);
661 static int whiteheat_open(struct tty_struct *tty, struct usb_serial_port *port)
665 dbg("%s - port %d", __func__, port->number);
667 retval = start_command_port(port->serial);
672 tty->low_latency = 1;
674 /* send an open port command */
675 retval = firm_open(port);
677 stop_command_port(port->serial);
681 retval = firm_purge(port, WHITEHEAT_PURGE_RX | WHITEHEAT_PURGE_TX);
684 stop_command_port(port->serial);
689 firm_setup_port(tty);
691 /* Work around HCD bugs */
692 usb_clear_halt(port->serial->dev, port->read_urb->pipe);
693 usb_clear_halt(port->serial->dev, port->write_urb->pipe);
695 /* Start reading from the device */
696 retval = start_port_read(port);
699 "%s - failed submitting read urb, error %d\n",
702 stop_command_port(port->serial);
707 dbg("%s - exit, retval = %d", __func__, retval);
712 static void whiteheat_close(struct usb_serial_port *port)
714 struct whiteheat_private *info = usb_get_serial_port_data(port);
715 struct whiteheat_urb_wrap *wrap;
717 struct list_head *tmp;
718 struct list_head *tmp2;
720 dbg("%s - port %d", __func__, port->number);
722 firm_report_tx_done(port);
725 /* shutdown our bulk reads and writes */
726 mutex_lock(&info->deathwarrant);
727 spin_lock_irq(&info->lock);
728 list_for_each_safe(tmp, tmp2, &info->rx_urbs_submitted) {
729 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
732 spin_unlock_irq(&info->lock);
734 spin_lock_irq(&info->lock);
735 list_add(tmp, &info->rx_urbs_free);
737 list_for_each_safe(tmp, tmp2, &info->rx_urb_q)
738 list_move(tmp, &info->rx_urbs_free);
739 list_for_each_safe(tmp, tmp2, &info->tx_urbs_submitted) {
740 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
743 spin_unlock_irq(&info->lock);
745 spin_lock_irq(&info->lock);
746 list_add(tmp, &info->tx_urbs_free);
748 spin_unlock_irq(&info->lock);
749 mutex_unlock(&info->deathwarrant);
750 stop_command_port(port->serial);
754 static int whiteheat_write(struct tty_struct *tty,
755 struct usb_serial_port *port, const unsigned char *buf, int count)
757 struct usb_serial *serial = port->serial;
758 struct whiteheat_private *info = usb_get_serial_port_data(port);
759 struct whiteheat_urb_wrap *wrap;
765 struct list_head *tmp;
767 dbg("%s - port %d", __func__, port->number);
770 dbg("%s - write request of 0 bytes", __func__);
775 spin_lock_irqsave(&info->lock, flags);
776 if (list_empty(&info->tx_urbs_free)) {
777 spin_unlock_irqrestore(&info->lock, flags);
780 tmp = list_first(&info->tx_urbs_free);
782 spin_unlock_irqrestore(&info->lock, flags);
784 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
786 bytes = (count > port->bulk_out_size) ?
787 port->bulk_out_size : count;
788 memcpy(urb->transfer_buffer, buf + sent, bytes);
790 usb_serial_debug_data(debug, &port->dev,
791 __func__, bytes, urb->transfer_buffer);
793 urb->dev = serial->dev;
794 urb->transfer_buffer_length = bytes;
795 result = usb_submit_urb(urb, GFP_ATOMIC);
798 "%s - failed submitting write urb, error %d\n",
801 spin_lock_irqsave(&info->lock, flags);
802 list_add(tmp, &info->tx_urbs_free);
803 spin_unlock_irqrestore(&info->lock, flags);
808 spin_lock_irqsave(&info->lock, flags);
809 list_add(tmp, &info->tx_urbs_submitted);
810 spin_unlock_irqrestore(&info->lock, flags);
817 static int whiteheat_write_room(struct tty_struct *tty)
819 struct usb_serial_port *port = tty->driver_data;
820 struct whiteheat_private *info = usb_get_serial_port_data(port);
821 struct list_head *tmp;
825 dbg("%s - port %d", __func__, port->number);
827 spin_lock_irqsave(&info->lock, flags);
828 list_for_each(tmp, &info->tx_urbs_free)
830 spin_unlock_irqrestore(&info->lock, flags);
831 room *= port->bulk_out_size;
833 dbg("%s - returns %d", __func__, room);
837 static int whiteheat_tiocmget(struct tty_struct *tty)
839 struct usb_serial_port *port = tty->driver_data;
840 struct whiteheat_private *info = usb_get_serial_port_data(port);
841 unsigned int modem_signals = 0;
843 dbg("%s - port %d", __func__, port->number);
845 firm_get_dtr_rts(port);
846 if (info->mcr & UART_MCR_DTR)
847 modem_signals |= TIOCM_DTR;
848 if (info->mcr & UART_MCR_RTS)
849 modem_signals |= TIOCM_RTS;
851 return modem_signals;
854 static int whiteheat_tiocmset(struct tty_struct *tty,
855 unsigned int set, unsigned int clear)
857 struct usb_serial_port *port = tty->driver_data;
858 struct whiteheat_private *info = usb_get_serial_port_data(port);
860 dbg("%s - port %d", __func__, port->number);
863 info->mcr |= UART_MCR_RTS;
865 info->mcr |= UART_MCR_DTR;
867 if (clear & TIOCM_RTS)
868 info->mcr &= ~UART_MCR_RTS;
869 if (clear & TIOCM_DTR)
870 info->mcr &= ~UART_MCR_DTR;
872 firm_set_dtr(port, info->mcr & UART_MCR_DTR);
873 firm_set_rts(port, info->mcr & UART_MCR_RTS);
878 static int whiteheat_ioctl(struct tty_struct *tty,
879 unsigned int cmd, unsigned long arg)
881 struct usb_serial_port *port = tty->driver_data;
882 struct serial_struct serstruct;
883 void __user *user_arg = (void __user *)arg;
885 dbg("%s - port %d, cmd 0x%.4x", __func__, port->number, cmd);
889 memset(&serstruct, 0, sizeof(serstruct));
890 serstruct.type = PORT_16654;
891 serstruct.line = port->serial->minor;
892 serstruct.port = port->number;
893 serstruct.flags = ASYNC_SKIP_TEST | ASYNC_AUTO_IRQ;
894 serstruct.xmit_fifo_size = port->bulk_out_size;
895 serstruct.custom_divisor = 0;
896 serstruct.baud_base = 460800;
897 serstruct.close_delay = CLOSING_DELAY;
898 serstruct.closing_wait = CLOSING_DELAY;
900 if (copy_to_user(user_arg, &serstruct, sizeof(serstruct)))
911 static void whiteheat_set_termios(struct tty_struct *tty,
912 struct usb_serial_port *port, struct ktermios *old_termios)
914 firm_setup_port(tty);
917 static void whiteheat_break_ctl(struct tty_struct *tty, int break_state)
919 struct usb_serial_port *port = tty->driver_data;
920 firm_set_break(port, break_state);
924 static int whiteheat_chars_in_buffer(struct tty_struct *tty)
926 struct usb_serial_port *port = tty->driver_data;
927 struct whiteheat_private *info = usb_get_serial_port_data(port);
928 struct list_head *tmp;
929 struct whiteheat_urb_wrap *wrap;
933 dbg("%s - port %d", __func__, port->number);
935 spin_lock_irqsave(&info->lock, flags);
936 list_for_each(tmp, &info->tx_urbs_submitted) {
937 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
938 chars += wrap->urb->transfer_buffer_length;
940 spin_unlock_irqrestore(&info->lock, flags);
942 dbg("%s - returns %d", __func__, chars);
947 static void whiteheat_throttle(struct tty_struct *tty)
949 struct usb_serial_port *port = tty->driver_data;
950 struct whiteheat_private *info = usb_get_serial_port_data(port);
952 dbg("%s - port %d", __func__, port->number);
954 spin_lock_irq(&info->lock);
955 info->flags |= THROTTLED;
956 spin_unlock_irq(&info->lock);
960 static void whiteheat_unthrottle(struct tty_struct *tty)
962 struct usb_serial_port *port = tty->driver_data;
963 struct whiteheat_private *info = usb_get_serial_port_data(port);
964 int actually_throttled;
966 dbg("%s - port %d", __func__, port->number);
968 spin_lock_irq(&info->lock);
969 actually_throttled = info->flags & ACTUALLY_THROTTLED;
970 info->flags &= ~(THROTTLED | ACTUALLY_THROTTLED);
971 spin_unlock_irq(&info->lock);
973 if (actually_throttled)
974 rx_data_softint(&info->rx_work);
978 /*****************************************************************************
979 * Connect Tech's White Heat callback routines
980 *****************************************************************************/
981 static void command_port_write_callback(struct urb *urb)
983 int status = urb->status;
988 dbg("nonzero urb status: %d", status);
994 static void command_port_read_callback(struct urb *urb)
996 struct usb_serial_port *command_port = urb->context;
997 struct whiteheat_command_private *command_info;
998 int status = urb->status;
999 unsigned char *data = urb->transfer_buffer;
1002 dbg("%s", __func__);
1004 command_info = usb_get_serial_port_data(command_port);
1005 if (!command_info) {
1006 dbg("%s - command_info is NULL, exiting.", __func__);
1010 dbg("%s - nonzero urb status: %d", __func__, status);
1011 if (status != -ENOENT)
1012 command_info->command_finished = WHITEHEAT_CMD_FAILURE;
1013 wake_up(&command_info->wait_command);
1017 usb_serial_debug_data(debug, &command_port->dev,
1018 __func__, urb->actual_length, data);
1020 if (data[0] == WHITEHEAT_CMD_COMPLETE) {
1021 command_info->command_finished = WHITEHEAT_CMD_COMPLETE;
1022 wake_up(&command_info->wait_command);
1023 } else if (data[0] == WHITEHEAT_CMD_FAILURE) {
1024 command_info->command_finished = WHITEHEAT_CMD_FAILURE;
1025 wake_up(&command_info->wait_command);
1026 } else if (data[0] == WHITEHEAT_EVENT) {
1027 /* These are unsolicited reports from the firmware, hence no
1028 waiting command to wakeup */
1029 dbg("%s - event received", __func__);
1030 } else if (data[0] == WHITEHEAT_GET_DTR_RTS) {
1031 memcpy(command_info->result_buffer, &data[1],
1032 urb->actual_length - 1);
1033 command_info->command_finished = WHITEHEAT_CMD_COMPLETE;
1034 wake_up(&command_info->wait_command);
1036 dbg("%s - bad reply from firmware", __func__);
1038 /* Continue trying to always read */
1039 command_port->read_urb->dev = command_port->serial->dev;
1040 result = usb_submit_urb(command_port->read_urb, GFP_ATOMIC);
1042 dbg("%s - failed resubmitting read urb, error %d",
1047 static void whiteheat_read_callback(struct urb *urb)
1049 struct usb_serial_port *port = urb->context;
1050 struct whiteheat_urb_wrap *wrap;
1051 unsigned char *data = urb->transfer_buffer;
1052 struct whiteheat_private *info = usb_get_serial_port_data(port);
1053 int status = urb->status;
1055 dbg("%s - port %d", __func__, port->number);
1057 spin_lock(&info->lock);
1058 wrap = urb_to_wrap(urb, &info->rx_urbs_submitted);
1060 spin_unlock(&info->lock);
1061 dev_err(&port->dev, "%s - Not my urb!\n", __func__);
1064 list_del(&wrap->list);
1065 spin_unlock(&info->lock);
1068 dbg("%s - nonzero read bulk status received: %d",
1070 spin_lock(&info->lock);
1071 list_add(&wrap->list, &info->rx_urbs_free);
1072 spin_unlock(&info->lock);
1076 usb_serial_debug_data(debug, &port->dev,
1077 __func__, urb->actual_length, data);
1079 spin_lock(&info->lock);
1080 list_add_tail(&wrap->list, &info->rx_urb_q);
1081 if (info->flags & THROTTLED) {
1082 info->flags |= ACTUALLY_THROTTLED;
1083 spin_unlock(&info->lock);
1086 spin_unlock(&info->lock);
1088 schedule_work(&info->rx_work);
1092 static void whiteheat_write_callback(struct urb *urb)
1094 struct usb_serial_port *port = urb->context;
1095 struct whiteheat_private *info = usb_get_serial_port_data(port);
1096 struct whiteheat_urb_wrap *wrap;
1097 int status = urb->status;
1099 dbg("%s - port %d", __func__, port->number);
1101 spin_lock(&info->lock);
1102 wrap = urb_to_wrap(urb, &info->tx_urbs_submitted);
1104 spin_unlock(&info->lock);
1105 dev_err(&port->dev, "%s - Not my urb!\n", __func__);
1108 list_move(&wrap->list, &info->tx_urbs_free);
1109 spin_unlock(&info->lock);
1112 dbg("%s - nonzero write bulk status received: %d",
1117 usb_serial_port_softint(port);
1121 /*****************************************************************************
1122 * Connect Tech's White Heat firmware interface
1123 *****************************************************************************/
1124 static int firm_send_command(struct usb_serial_port *port, __u8 command,
1125 __u8 *data, __u8 datasize)
1127 struct usb_serial_port *command_port;
1128 struct whiteheat_command_private *command_info;
1129 struct whiteheat_private *info;
1130 __u8 *transfer_buffer;
1134 dbg("%s - command %d", __func__, command);
1136 command_port = port->serial->port[COMMAND_PORT];
1137 command_info = usb_get_serial_port_data(command_port);
1138 mutex_lock(&command_info->mutex);
1139 command_info->command_finished = false;
1141 transfer_buffer = (__u8 *)command_port->write_urb->transfer_buffer;
1142 transfer_buffer[0] = command;
1143 memcpy(&transfer_buffer[1], data, datasize);
1144 command_port->write_urb->transfer_buffer_length = datasize + 1;
1145 command_port->write_urb->dev = port->serial->dev;
1146 retval = usb_submit_urb(command_port->write_urb, GFP_NOIO);
1148 dbg("%s - submit urb failed", __func__);
1152 /* wait for the command to complete */
1153 t = wait_event_timeout(command_info->wait_command,
1154 (bool)command_info->command_finished, COMMAND_TIMEOUT);
1156 usb_kill_urb(command_port->write_urb);
1158 if (command_info->command_finished == false) {
1159 dbg("%s - command timed out.", __func__);
1160 retval = -ETIMEDOUT;
1164 if (command_info->command_finished == WHITEHEAT_CMD_FAILURE) {
1165 dbg("%s - command failed.", __func__);
1170 if (command_info->command_finished == WHITEHEAT_CMD_COMPLETE) {
1171 dbg("%s - command completed.", __func__);
1173 case WHITEHEAT_GET_DTR_RTS:
1174 info = usb_get_serial_port_data(port);
1175 memcpy(&info->mcr, command_info->result_buffer,
1176 sizeof(struct whiteheat_dr_info));
1181 mutex_unlock(&command_info->mutex);
1186 static int firm_open(struct usb_serial_port *port)
1188 struct whiteheat_simple open_command;
1190 open_command.port = port->number - port->serial->minor + 1;
1191 return firm_send_command(port, WHITEHEAT_OPEN,
1192 (__u8 *)&open_command, sizeof(open_command));
1196 static int firm_close(struct usb_serial_port *port)
1198 struct whiteheat_simple close_command;
1200 close_command.port = port->number - port->serial->minor + 1;
1201 return firm_send_command(port, WHITEHEAT_CLOSE,
1202 (__u8 *)&close_command, sizeof(close_command));
1206 static void firm_setup_port(struct tty_struct *tty)
1208 struct usb_serial_port *port = tty->driver_data;
1209 struct whiteheat_port_settings port_settings;
1210 unsigned int cflag = tty->termios->c_cflag;
1212 port_settings.port = port->number + 1;
1214 /* get the byte size */
1215 switch (cflag & CSIZE) {
1216 case CS5: port_settings.bits = 5; break;
1217 case CS6: port_settings.bits = 6; break;
1218 case CS7: port_settings.bits = 7; break;
1220 case CS8: port_settings.bits = 8; break;
1222 dbg("%s - data bits = %d", __func__, port_settings.bits);
1224 /* determine the parity */
1228 port_settings.parity = WHITEHEAT_PAR_MARK;
1230 port_settings.parity = WHITEHEAT_PAR_SPACE;
1233 port_settings.parity = WHITEHEAT_PAR_ODD;
1235 port_settings.parity = WHITEHEAT_PAR_EVEN;
1237 port_settings.parity = WHITEHEAT_PAR_NONE;
1238 dbg("%s - parity = %c", __func__, port_settings.parity);
1240 /* figure out the stop bits requested */
1242 port_settings.stop = 2;
1244 port_settings.stop = 1;
1245 dbg("%s - stop bits = %d", __func__, port_settings.stop);
1247 /* figure out the flow control settings */
1248 if (cflag & CRTSCTS)
1249 port_settings.hflow = (WHITEHEAT_HFLOW_CTS |
1250 WHITEHEAT_HFLOW_RTS);
1252 port_settings.hflow = WHITEHEAT_HFLOW_NONE;
1253 dbg("%s - hardware flow control = %s %s %s %s", __func__,
1254 (port_settings.hflow & WHITEHEAT_HFLOW_CTS) ? "CTS" : "",
1255 (port_settings.hflow & WHITEHEAT_HFLOW_RTS) ? "RTS" : "",
1256 (port_settings.hflow & WHITEHEAT_HFLOW_DSR) ? "DSR" : "",
1257 (port_settings.hflow & WHITEHEAT_HFLOW_DTR) ? "DTR" : "");
1259 /* determine software flow control */
1261 port_settings.sflow = WHITEHEAT_SFLOW_RXTX;
1263 port_settings.sflow = WHITEHEAT_SFLOW_NONE;
1264 dbg("%s - software flow control = %c", __func__, port_settings.sflow);
1266 port_settings.xon = START_CHAR(tty);
1267 port_settings.xoff = STOP_CHAR(tty);
1268 dbg("%s - XON = %2x, XOFF = %2x",
1269 __func__, port_settings.xon, port_settings.xoff);
1271 /* get the baud rate wanted */
1272 port_settings.baud = tty_get_baud_rate(tty);
1273 dbg("%s - baud rate = %d", __func__, port_settings.baud);
1275 /* fixme: should set validated settings */
1276 tty_encode_baud_rate(tty, port_settings.baud, port_settings.baud);
1277 /* handle any settings that aren't specified in the tty structure */
1278 port_settings.lloop = 0;
1280 /* now send the message to the device */
1281 firm_send_command(port, WHITEHEAT_SETUP_PORT,
1282 (__u8 *)&port_settings, sizeof(port_settings));
1286 static int firm_set_rts(struct usb_serial_port *port, __u8 onoff)
1288 struct whiteheat_set_rdb rts_command;
1290 rts_command.port = port->number - port->serial->minor + 1;
1291 rts_command.state = onoff;
1292 return firm_send_command(port, WHITEHEAT_SET_RTS,
1293 (__u8 *)&rts_command, sizeof(rts_command));
1297 static int firm_set_dtr(struct usb_serial_port *port, __u8 onoff)
1299 struct whiteheat_set_rdb dtr_command;
1301 dtr_command.port = port->number - port->serial->minor + 1;
1302 dtr_command.state = onoff;
1303 return firm_send_command(port, WHITEHEAT_SET_DTR,
1304 (__u8 *)&dtr_command, sizeof(dtr_command));
1308 static int firm_set_break(struct usb_serial_port *port, __u8 onoff)
1310 struct whiteheat_set_rdb break_command;
1312 break_command.port = port->number - port->serial->minor + 1;
1313 break_command.state = onoff;
1314 return firm_send_command(port, WHITEHEAT_SET_BREAK,
1315 (__u8 *)&break_command, sizeof(break_command));
1319 static int firm_purge(struct usb_serial_port *port, __u8 rxtx)
1321 struct whiteheat_purge purge_command;
1323 purge_command.port = port->number - port->serial->minor + 1;
1324 purge_command.what = rxtx;
1325 return firm_send_command(port, WHITEHEAT_PURGE,
1326 (__u8 *)&purge_command, sizeof(purge_command));
1330 static int firm_get_dtr_rts(struct usb_serial_port *port)
1332 struct whiteheat_simple get_dr_command;
1334 get_dr_command.port = port->number - port->serial->minor + 1;
1335 return firm_send_command(port, WHITEHEAT_GET_DTR_RTS,
1336 (__u8 *)&get_dr_command, sizeof(get_dr_command));
1340 static int firm_report_tx_done(struct usb_serial_port *port)
1342 struct whiteheat_simple close_command;
1344 close_command.port = port->number - port->serial->minor + 1;
1345 return firm_send_command(port, WHITEHEAT_REPORT_TX_DONE,
1346 (__u8 *)&close_command, sizeof(close_command));
1350 /*****************************************************************************
1351 * Connect Tech's White Heat utility functions
1352 *****************************************************************************/
1353 static int start_command_port(struct usb_serial *serial)
1355 struct usb_serial_port *command_port;
1356 struct whiteheat_command_private *command_info;
1359 command_port = serial->port[COMMAND_PORT];
1360 command_info = usb_get_serial_port_data(command_port);
1361 mutex_lock(&command_info->mutex);
1362 if (!command_info->port_running) {
1363 /* Work around HCD bugs */
1364 usb_clear_halt(serial->dev, command_port->read_urb->pipe);
1366 command_port->read_urb->dev = serial->dev;
1367 retval = usb_submit_urb(command_port->read_urb, GFP_KERNEL);
1369 dev_err(&serial->dev->dev,
1370 "%s - failed submitting read urb, error %d\n",
1375 command_info->port_running++;
1378 mutex_unlock(&command_info->mutex);
1383 static void stop_command_port(struct usb_serial *serial)
1385 struct usb_serial_port *command_port;
1386 struct whiteheat_command_private *command_info;
1388 command_port = serial->port[COMMAND_PORT];
1389 command_info = usb_get_serial_port_data(command_port);
1390 mutex_lock(&command_info->mutex);
1391 command_info->port_running--;
1392 if (!command_info->port_running)
1393 usb_kill_urb(command_port->read_urb);
1394 mutex_unlock(&command_info->mutex);
1398 static int start_port_read(struct usb_serial_port *port)
1400 struct whiteheat_private *info = usb_get_serial_port_data(port);
1401 struct whiteheat_urb_wrap *wrap;
1404 unsigned long flags;
1405 struct list_head *tmp;
1406 struct list_head *tmp2;
1408 spin_lock_irqsave(&info->lock, flags);
1410 list_for_each_safe(tmp, tmp2, &info->rx_urbs_free) {
1412 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1414 urb->dev = port->serial->dev;
1415 spin_unlock_irqrestore(&info->lock, flags);
1416 retval = usb_submit_urb(urb, GFP_KERNEL);
1418 spin_lock_irqsave(&info->lock, flags);
1419 list_add(tmp, &info->rx_urbs_free);
1420 list_for_each_safe(tmp, tmp2, &info->rx_urbs_submitted) {
1421 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1424 spin_unlock_irqrestore(&info->lock, flags);
1426 spin_lock_irqsave(&info->lock, flags);
1427 list_add(tmp, &info->rx_urbs_free);
1431 spin_lock_irqsave(&info->lock, flags);
1432 list_add(tmp, &info->rx_urbs_submitted);
1435 spin_unlock_irqrestore(&info->lock, flags);
1441 static struct whiteheat_urb_wrap *urb_to_wrap(struct urb *urb,
1442 struct list_head *head)
1444 struct whiteheat_urb_wrap *wrap;
1445 struct list_head *tmp;
1447 list_for_each(tmp, head) {
1448 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1449 if (wrap->urb == urb)
1457 static struct list_head *list_first(struct list_head *head)
1463 static void rx_data_softint(struct work_struct *work)
1465 struct whiteheat_private *info =
1466 container_of(work, struct whiteheat_private, rx_work);
1467 struct usb_serial_port *port = info->port;
1468 struct tty_struct *tty = tty_port_tty_get(&port->port);
1469 struct whiteheat_urb_wrap *wrap;
1471 unsigned long flags;
1472 struct list_head *tmp;
1473 struct list_head *tmp2;
1477 spin_lock_irqsave(&info->lock, flags);
1478 if (info->flags & THROTTLED) {
1479 spin_unlock_irqrestore(&info->lock, flags);
1483 list_for_each_safe(tmp, tmp2, &info->rx_urb_q) {
1485 spin_unlock_irqrestore(&info->lock, flags);
1487 wrap = list_entry(tmp, struct whiteheat_urb_wrap, list);
1490 if (tty && urb->actual_length)
1491 sent += tty_insert_flip_string(tty,
1492 urb->transfer_buffer, urb->actual_length);
1494 urb->dev = port->serial->dev;
1495 result = usb_submit_urb(urb, GFP_ATOMIC);
1498 "%s - failed resubmitting read urb, error %d\n",
1500 spin_lock_irqsave(&info->lock, flags);
1501 list_add(tmp, &info->rx_urbs_free);
1505 spin_lock_irqsave(&info->lock, flags);
1506 list_add(tmp, &info->rx_urbs_submitted);
1508 spin_unlock_irqrestore(&info->lock, flags);
1511 tty_flip_buffer_push(tty);
1517 /*****************************************************************************
1518 * Connect Tech's White Heat module functions
1519 *****************************************************************************/
1520 static int __init whiteheat_init(void)
1523 retval = usb_serial_register(&whiteheat_fake_device);
1525 goto failed_fake_register;
1526 retval = usb_serial_register(&whiteheat_device);
1528 goto failed_device_register;
1529 retval = usb_register(&whiteheat_driver);
1531 goto failed_usb_register;
1532 printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_VERSION ":"
1535 failed_usb_register:
1536 usb_serial_deregister(&whiteheat_device);
1537 failed_device_register:
1538 usb_serial_deregister(&whiteheat_fake_device);
1539 failed_fake_register:
1544 static void __exit whiteheat_exit(void)
1546 usb_deregister(&whiteheat_driver);
1547 usb_serial_deregister(&whiteheat_fake_device);
1548 usb_serial_deregister(&whiteheat_device);
1552 module_init(whiteheat_init);
1553 module_exit(whiteheat_exit);
1555 MODULE_AUTHOR(DRIVER_AUTHOR);
1556 MODULE_DESCRIPTION(DRIVER_DESC);
1557 MODULE_LICENSE("GPL");
1559 MODULE_FIRMWARE("whiteheat.fw");
1560 MODULE_FIRMWARE("whiteheat_loader.fw");
1562 module_param(urb_pool_size, int, 0);
1563 MODULE_PARM_DESC(urb_pool_size, "Number of urbs to use for buffering");
1565 module_param(debug, bool, S_IRUGO | S_IWUSR);
1566 MODULE_PARM_DESC(debug, "Debug enabled or not");