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