2 * USB Cypress M8 driver
5 * Lonnie Mendez (dignome@gmail.com)
6 * Copyright (C) 2003,2004
7 * Neil Whelchel (koyama@firstlight.net)
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
14 * See Documentation/usb/usb-serial.txt for more information on using this
17 * See http://geocities.com/i0xox0i for information on this driver and the
18 * earthmate usb device.
20 * Lonnie Mendez <dignome@gmail.com>
22 * Fixed problem where setting or retreiving the serial config would fail
23 * with EPIPE. Removed CRTS toggling so the driver behaves more like
24 * other usbserial adapters. Issued new interval of 1ms instead of the
25 * default 10ms. As a result, transfer speed has been substantially
26 * increased from avg. 850bps to avg. 3300bps. initial termios has also
27 * been modified. Cleaned up code and formatting issues so it is more
28 * readable. Replaced the C++ style comments.
30 * Lonnie Mendez <dignome@gmail.com>
32 * Incorporated write buffering from pl2303 driver. Fixed bug with line
33 * handling so both lines are raised in cypress_open. (was dropping rts)
34 * Various code cleanups made as well along with other misc bug fixes.
36 * Lonnie Mendez <dignome@gmail.com>
38 * Driver modified to support dynamic line settings. Various improvments
43 * Driver first released.
47 /* Thanks to Neil Whelchel for writing the first cypress m8 implementation
49 /* Thanks to cypress for providing references for the hid reports. */
50 /* Thanks to Jiang Zhang for providing links and for general help. */
51 /* Code originates and was built up from ftdi_sio, belkin, pl2303 and others.*/
54 #include <linux/kernel.h>
55 #include <linux/errno.h>
56 #include <linux/init.h>
57 #include <linux/slab.h>
58 #include <linux/tty.h>
59 #include <linux/tty_driver.h>
60 #include <linux/tty_flip.h>
61 #include <linux/module.h>
62 #include <linux/moduleparam.h>
63 #include <linux/spinlock.h>
64 #include <linux/usb.h>
65 #include <linux/usb/serial.h>
66 #include <linux/serial.h>
67 #include <linux/delay.h>
68 #include <linux/uaccess.h>
70 #include "cypress_m8.h"
76 static int unstable_bauds;
81 #define DRIVER_VERSION "v1.09"
82 #define DRIVER_AUTHOR "Lonnie Mendez <dignome@gmail.com>, Neil Whelchel <koyama@firstlight.net>"
83 #define DRIVER_DESC "Cypress USB to Serial Driver"
85 /* write buffer size defines */
86 #define CYPRESS_BUF_SIZE 1024
87 #define CYPRESS_CLOSING_WAIT (30*HZ)
89 static struct usb_device_id id_table_earthmate [] = {
90 { USB_DEVICE(VENDOR_ID_DELORME, PRODUCT_ID_EARTHMATEUSB) },
91 { USB_DEVICE(VENDOR_ID_DELORME, PRODUCT_ID_EARTHMATEUSB_LT20) },
92 { } /* Terminating entry */
95 static struct usb_device_id id_table_cyphidcomrs232 [] = {
96 { USB_DEVICE(VENDOR_ID_CYPRESS, PRODUCT_ID_CYPHIDCOM) },
97 { USB_DEVICE(VENDOR_ID_POWERCOM, PRODUCT_ID_UPS) },
98 { } /* Terminating entry */
101 static struct usb_device_id id_table_nokiaca42v2 [] = {
102 { USB_DEVICE(VENDOR_ID_DAZZLE, PRODUCT_ID_CA42) },
103 { } /* Terminating entry */
106 static struct usb_device_id id_table_combined [] = {
107 { USB_DEVICE(VENDOR_ID_DELORME, PRODUCT_ID_EARTHMATEUSB) },
108 { USB_DEVICE(VENDOR_ID_DELORME, PRODUCT_ID_EARTHMATEUSB_LT20) },
109 { USB_DEVICE(VENDOR_ID_CYPRESS, PRODUCT_ID_CYPHIDCOM) },
110 { USB_DEVICE(VENDOR_ID_POWERCOM, PRODUCT_ID_UPS) },
111 { USB_DEVICE(VENDOR_ID_DAZZLE, PRODUCT_ID_CA42) },
112 { } /* Terminating entry */
115 MODULE_DEVICE_TABLE(usb, id_table_combined);
117 static struct usb_driver cypress_driver = {
119 .probe = usb_serial_probe,
120 .disconnect = usb_serial_disconnect,
121 .id_table = id_table_combined,
126 packet_format_1, /* b0:status, b1:payload count */
127 packet_format_2 /* b0[7:3]:status, b0[2:0]:payload count */
130 struct cypress_private {
131 spinlock_t lock; /* private lock */
132 int chiptype; /* identifier of device, for quirks/etc */
133 int bytes_in; /* used for statistics */
134 int bytes_out; /* used for statistics */
135 int cmd_count; /* used for statistics */
136 int cmd_ctrl; /* always set this to 1 before issuing a command */
137 struct cypress_buf *buf; /* write buffer */
138 int write_urb_in_use; /* write urb in use indicator */
139 int write_urb_interval; /* interval to use for write urb */
140 int read_urb_interval; /* interval to use for read urb */
141 int comm_is_ok; /* true if communication is (still) ok */
142 int termios_initialized;
143 __u8 line_control; /* holds dtr / rts value */
144 __u8 current_status; /* received from last read - info on dsr,cts,cd,ri,etc */
145 __u8 current_config; /* stores the current configuration byte */
146 __u8 rx_flags; /* throttling - used from whiteheat/ftdi_sio */
147 enum packet_format pkt_fmt; /* format to use for packet send / receive */
148 int get_cfg_unsafe; /* If true, the CYPRESS_GET_CONFIG is unsafe */
149 int baud_rate; /* stores current baud rate in
151 int isthrottled; /* if throttled, discard reads */
152 wait_queue_head_t delta_msr_wait; /* used for TIOCMIWAIT */
153 char prev_status, diff_status; /* used for TIOCMIWAIT */
154 /* we pass a pointer to this as the arguement sent to
155 cypress_set_termios old_termios */
156 struct ktermios tmp_termios; /* stores the old termios settings */
159 /* write buffer structure */
161 unsigned int buf_size;
167 /* function prototypes for the Cypress USB to serial device */
168 static int cypress_earthmate_startup(struct usb_serial *serial);
169 static int cypress_hidcom_startup(struct usb_serial *serial);
170 static int cypress_ca42v2_startup(struct usb_serial *serial);
171 static void cypress_release(struct usb_serial *serial);
172 static int cypress_open(struct tty_struct *tty, struct usb_serial_port *port);
173 static void cypress_close(struct usb_serial_port *port);
174 static void cypress_dtr_rts(struct usb_serial_port *port, int on);
175 static int cypress_write(struct tty_struct *tty, struct usb_serial_port *port,
176 const unsigned char *buf, int count);
177 static void cypress_send(struct usb_serial_port *port);
178 static int cypress_write_room(struct tty_struct *tty);
179 static int cypress_ioctl(struct tty_struct *tty, struct file *file,
180 unsigned int cmd, unsigned long arg);
181 static void cypress_set_termios(struct tty_struct *tty,
182 struct usb_serial_port *port, struct ktermios *old);
183 static int cypress_tiocmget(struct tty_struct *tty, struct file *file);
184 static int cypress_tiocmset(struct tty_struct *tty, struct file *file,
185 unsigned int set, unsigned int clear);
186 static int cypress_chars_in_buffer(struct tty_struct *tty);
187 static void cypress_throttle(struct tty_struct *tty);
188 static void cypress_unthrottle(struct tty_struct *tty);
189 static void cypress_set_dead(struct usb_serial_port *port);
190 static void cypress_read_int_callback(struct urb *urb);
191 static void cypress_write_int_callback(struct urb *urb);
192 /* write buffer functions */
193 static struct cypress_buf *cypress_buf_alloc(unsigned int size);
194 static void cypress_buf_free(struct cypress_buf *cb);
195 static void cypress_buf_clear(struct cypress_buf *cb);
196 static unsigned int cypress_buf_data_avail(struct cypress_buf *cb);
197 static unsigned int cypress_buf_space_avail(struct cypress_buf *cb);
198 static unsigned int cypress_buf_put(struct cypress_buf *cb,
199 const char *buf, unsigned int count);
200 static unsigned int cypress_buf_get(struct cypress_buf *cb,
201 char *buf, unsigned int count);
204 static struct usb_serial_driver cypress_earthmate_device = {
206 .owner = THIS_MODULE,
209 .description = "DeLorme Earthmate USB",
210 .usb_driver = &cypress_driver,
211 .id_table = id_table_earthmate,
213 .attach = cypress_earthmate_startup,
214 .release = cypress_release,
215 .open = cypress_open,
216 .close = cypress_close,
217 .dtr_rts = cypress_dtr_rts,
218 .write = cypress_write,
219 .write_room = cypress_write_room,
220 .ioctl = cypress_ioctl,
221 .set_termios = cypress_set_termios,
222 .tiocmget = cypress_tiocmget,
223 .tiocmset = cypress_tiocmset,
224 .chars_in_buffer = cypress_chars_in_buffer,
225 .throttle = cypress_throttle,
226 .unthrottle = cypress_unthrottle,
227 .read_int_callback = cypress_read_int_callback,
228 .write_int_callback = cypress_write_int_callback,
231 static struct usb_serial_driver cypress_hidcom_device = {
233 .owner = THIS_MODULE,
236 .description = "HID->COM RS232 Adapter",
237 .usb_driver = &cypress_driver,
238 .id_table = id_table_cyphidcomrs232,
240 .attach = cypress_hidcom_startup,
241 .release = cypress_release,
242 .open = cypress_open,
243 .close = cypress_close,
244 .dtr_rts = cypress_dtr_rts,
245 .write = cypress_write,
246 .write_room = cypress_write_room,
247 .ioctl = cypress_ioctl,
248 .set_termios = cypress_set_termios,
249 .tiocmget = cypress_tiocmget,
250 .tiocmset = cypress_tiocmset,
251 .chars_in_buffer = cypress_chars_in_buffer,
252 .throttle = cypress_throttle,
253 .unthrottle = cypress_unthrottle,
254 .read_int_callback = cypress_read_int_callback,
255 .write_int_callback = cypress_write_int_callback,
258 static struct usb_serial_driver cypress_ca42v2_device = {
260 .owner = THIS_MODULE,
261 .name = "nokiaca42v2",
263 .description = "Nokia CA-42 V2 Adapter",
264 .usb_driver = &cypress_driver,
265 .id_table = id_table_nokiaca42v2,
267 .attach = cypress_ca42v2_startup,
268 .release = cypress_release,
269 .open = cypress_open,
270 .close = cypress_close,
271 .dtr_rts = cypress_dtr_rts,
272 .write = cypress_write,
273 .write_room = cypress_write_room,
274 .ioctl = cypress_ioctl,
275 .set_termios = cypress_set_termios,
276 .tiocmget = cypress_tiocmget,
277 .tiocmset = cypress_tiocmset,
278 .chars_in_buffer = cypress_chars_in_buffer,
279 .throttle = cypress_throttle,
280 .unthrottle = cypress_unthrottle,
281 .read_int_callback = cypress_read_int_callback,
282 .write_int_callback = cypress_write_int_callback,
285 /*****************************************************************************
286 * Cypress serial helper functions
287 *****************************************************************************/
290 static int analyze_baud_rate(struct usb_serial_port *port, speed_t new_rate)
292 struct cypress_private *priv;
293 priv = usb_get_serial_port_data(port);
299 * The general purpose firmware for the Cypress M8 allows for
300 * a maximum speed of 57600bps (I have no idea whether DeLorme
301 * chose to use the general purpose firmware or not), if you
302 * need to modify this speed setting for your own project
303 * please add your own chiptype and modify the code likewise.
304 * The Cypress HID->COM device will work successfully up to
305 * 115200bps (but the actual throughput is around 3kBps).
307 if (port->serial->dev->speed == USB_SPEED_LOW) {
309 * Mike Isely <isely@pobox.com> 2-Feb-2008: The
310 * Cypress app note that describes this mechanism
311 * states the the low-speed part can't handle more
312 * than 800 bytes/sec, in which case 4800 baud is the
313 * safest speed for a part like that.
315 if (new_rate > 4800) {
316 dbg("%s - failed setting baud rate, device incapable "
317 "speed %d", __func__, new_rate);
321 switch (priv->chiptype) {
323 if (new_rate <= 600) {
324 /* 300 and 600 baud rates are supported under
325 * the generic firmware, but are not used with
326 * NMEA and SiRF protocols */
327 dbg("%s - failed setting baud rate, unsupported speed "
328 "of %d on Earthmate GPS", __func__, new_rate);
339 /* This function can either set or retrieve the current serial line settings */
340 static int cypress_serial_control(struct tty_struct *tty,
341 struct usb_serial_port *port, speed_t baud_rate, int data_bits,
342 int stop_bits, int parity_enable, int parity_type, int reset,
343 int cypress_request_type)
345 int new_baudrate = 0, retval = 0, tries = 0;
346 struct cypress_private *priv;
347 __u8 feature_buffer[5];
352 priv = usb_get_serial_port_data(port);
354 if (!priv->comm_is_ok)
357 switch (cypress_request_type) {
358 case CYPRESS_SET_CONFIG:
359 /* 0 means 'Hang up' so doesn't change the true bit rate */
360 new_baudrate = priv->baud_rate;
361 if (baud_rate && baud_rate != priv->baud_rate) {
362 dbg("%s - baud rate is changing", __func__);
363 retval = analyze_baud_rate(port, baud_rate);
365 new_baudrate = retval;
366 dbg("%s - New baud rate set to %d",
367 __func__, new_baudrate);
370 dbg("%s - baud rate is being sent as %d",
371 __func__, new_baudrate);
373 memset(feature_buffer, 0, sizeof(feature_buffer));
374 /* fill the feature_buffer with new configuration */
375 *((u_int32_t *)feature_buffer) = new_baudrate;
376 feature_buffer[4] |= data_bits; /* assign data bits in 2 bit space ( max 3 ) */
378 feature_buffer[4] |= (stop_bits << 3); /* assign stop bits in 1 bit space */
379 feature_buffer[4] |= (parity_enable << 4); /* assign parity flag in 1 bit space */
380 feature_buffer[4] |= (parity_type << 5); /* assign parity type in 1 bit space */
382 feature_buffer[4] |= (reset << 7); /* assign reset at end of byte, 1 bit space */
384 dbg("%s - device is being sent this feature report:",
386 dbg("%s - %02X - %02X - %02X - %02X - %02X", __func__,
387 feature_buffer[0], feature_buffer[1],
388 feature_buffer[2], feature_buffer[3],
392 retval = usb_control_msg(port->serial->dev,
393 usb_sndctrlpipe(port->serial->dev, 0),
395 USB_DIR_OUT | USB_RECIP_INTERFACE | USB_TYPE_CLASS,
396 0x0300, 0, feature_buffer,
397 sizeof(feature_buffer), 500);
402 } while (retval != sizeof(feature_buffer) &&
405 if (retval != sizeof(feature_buffer)) {
406 dev_err(&port->dev, "%s - failed sending serial "
407 "line settings - %d\n", __func__, retval);
408 cypress_set_dead(port);
410 spin_lock_irqsave(&priv->lock, flags);
411 priv->baud_rate = new_baudrate;
412 priv->current_config = feature_buffer[4];
413 spin_unlock_irqrestore(&priv->lock, flags);
414 /* If we asked for a speed change encode it */
416 tty_encode_baud_rate(tty,
417 new_baudrate, new_baudrate);
420 case CYPRESS_GET_CONFIG:
421 if (priv->get_cfg_unsafe) {
422 /* Not implemented for this device,
423 and if we try to do it we're likely
424 to crash the hardware. */
427 dbg("%s - retreiving serial line settings", __func__);
428 /* set initial values in feature buffer */
429 memset(feature_buffer, 0, sizeof(feature_buffer));
432 retval = usb_control_msg(port->serial->dev,
433 usb_rcvctrlpipe(port->serial->dev, 0),
435 USB_DIR_IN | USB_RECIP_INTERFACE | USB_TYPE_CLASS,
436 0x0300, 0, feature_buffer,
437 sizeof(feature_buffer), 500);
441 } while (retval != sizeof(feature_buffer)
442 && retval != -ENODEV);
444 if (retval != sizeof(feature_buffer)) {
445 dev_err(&port->dev, "%s - failed to retrieve serial "
446 "line settings - %d\n", __func__, retval);
447 cypress_set_dead(port);
450 spin_lock_irqsave(&priv->lock, flags);
451 /* store the config in one byte, and later
452 use bit masks to check values */
453 priv->current_config = feature_buffer[4];
454 priv->baud_rate = *((u_int32_t *)feature_buffer);
455 spin_unlock_irqrestore(&priv->lock, flags);
458 spin_lock_irqsave(&priv->lock, flags);
460 spin_unlock_irqrestore(&priv->lock, flags);
463 } /* cypress_serial_control */
466 static void cypress_set_dead(struct usb_serial_port *port)
468 struct cypress_private *priv = usb_get_serial_port_data(port);
471 spin_lock_irqsave(&priv->lock, flags);
472 if (!priv->comm_is_ok) {
473 spin_unlock_irqrestore(&priv->lock, flags);
476 priv->comm_is_ok = 0;
477 spin_unlock_irqrestore(&priv->lock, flags);
479 dev_err(&port->dev, "cypress_m8 suspending failing port %d - "
480 "interval might be too short\n", port->number);
484 /*****************************************************************************
485 * Cypress serial driver functions
486 *****************************************************************************/
489 static int generic_startup(struct usb_serial *serial)
491 struct cypress_private *priv;
492 struct usb_serial_port *port = serial->port[0];
494 dbg("%s - port %d", __func__, port->number);
496 priv = kzalloc(sizeof(struct cypress_private), GFP_KERNEL);
500 priv->comm_is_ok = !0;
501 spin_lock_init(&priv->lock);
502 priv->buf = cypress_buf_alloc(CYPRESS_BUF_SIZE);
503 if (priv->buf == NULL) {
507 init_waitqueue_head(&priv->delta_msr_wait);
509 usb_reset_configuration(serial->dev);
512 priv->line_control = 0;
513 priv->termios_initialized = 0;
515 /* Default packet format setting is determined by packet size.
516 Anything with a size larger then 9 must have a separate
517 count field since the 3 bit count field is otherwise too
518 small. Otherwise we can use the slightly more compact
519 format. This is in accordance with the cypress_m8 serial
520 converter app note. */
521 if (port->interrupt_out_size > 9)
522 priv->pkt_fmt = packet_format_1;
524 priv->pkt_fmt = packet_format_2;
527 priv->write_urb_interval = interval;
528 priv->read_urb_interval = interval;
529 dbg("%s - port %d read & write intervals forced to %d",
530 __func__, port->number, interval);
532 priv->write_urb_interval = port->interrupt_out_urb->interval;
533 priv->read_urb_interval = port->interrupt_in_urb->interval;
534 dbg("%s - port %d intervals: read=%d write=%d",
535 __func__, port->number,
536 priv->read_urb_interval, priv->write_urb_interval);
538 usb_set_serial_port_data(port, priv);
544 static int cypress_earthmate_startup(struct usb_serial *serial)
546 struct cypress_private *priv;
547 struct usb_serial_port *port = serial->port[0];
551 if (generic_startup(serial)) {
552 dbg("%s - Failed setting up port %d", __func__,
557 priv = usb_get_serial_port_data(port);
558 priv->chiptype = CT_EARTHMATE;
559 /* All Earthmate devices use the separated-count packet
561 priv->pkt_fmt = packet_format_1;
562 if (serial->dev->descriptor.idProduct !=
563 cpu_to_le16(PRODUCT_ID_EARTHMATEUSB)) {
564 /* The old original USB Earthmate seemed able to
565 handle GET_CONFIG requests; everything they've
566 produced since that time crashes if this command is
568 dbg("%s - Marking this device as unsafe for GET_CONFIG "
569 "commands", __func__);
570 priv->get_cfg_unsafe = !0;
574 } /* cypress_earthmate_startup */
577 static int cypress_hidcom_startup(struct usb_serial *serial)
579 struct cypress_private *priv;
583 if (generic_startup(serial)) {
584 dbg("%s - Failed setting up port %d", __func__,
585 serial->port[0]->number);
589 priv = usb_get_serial_port_data(serial->port[0]);
590 priv->chiptype = CT_CYPHIDCOM;
593 } /* cypress_hidcom_startup */
596 static int cypress_ca42v2_startup(struct usb_serial *serial)
598 struct cypress_private *priv;
602 if (generic_startup(serial)) {
603 dbg("%s - Failed setting up port %d", __func__,
604 serial->port[0]->number);
608 priv = usb_get_serial_port_data(serial->port[0]);
609 priv->chiptype = CT_CA42V2;
612 } /* cypress_ca42v2_startup */
615 static void cypress_release(struct usb_serial *serial)
617 struct cypress_private *priv;
619 dbg("%s - port %d", __func__, serial->port[0]->number);
621 /* all open ports are closed at this point */
623 priv = usb_get_serial_port_data(serial->port[0]);
626 cypress_buf_free(priv->buf);
632 static int cypress_open(struct tty_struct *tty, struct usb_serial_port *port)
634 struct cypress_private *priv = usb_get_serial_port_data(port);
635 struct usb_serial *serial = port->serial;
639 dbg("%s - port %d", __func__, port->number);
641 if (!priv->comm_is_ok)
644 /* clear halts before open */
645 usb_clear_halt(serial->dev, 0x81);
646 usb_clear_halt(serial->dev, 0x02);
648 spin_lock_irqsave(&priv->lock, flags);
649 /* reset read/write statistics */
654 spin_unlock_irqrestore(&priv->lock, flags);
660 cypress_set_termios(tty, port, &priv->tmp_termios);
662 /* setup the port and start reading from the device */
663 if (!port->interrupt_in_urb) {
664 dev_err(&port->dev, "%s - interrupt_in_urb is empty!\n",
669 usb_fill_int_urb(port->interrupt_in_urb, serial->dev,
670 usb_rcvintpipe(serial->dev, port->interrupt_in_endpointAddress),
671 port->interrupt_in_urb->transfer_buffer,
672 port->interrupt_in_urb->transfer_buffer_length,
673 cypress_read_int_callback, port, priv->read_urb_interval);
674 result = usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL);
678 "%s - failed submitting read urb, error %d\n",
680 cypress_set_dead(port);
682 port->port.drain_delay = 256;
686 static void cypress_dtr_rts(struct usb_serial_port *port, int on)
688 struct cypress_private *priv = usb_get_serial_port_data(port);
689 /* drop dtr and rts */
690 priv = usb_get_serial_port_data(port);
691 spin_lock_irq(&priv->lock);
693 priv->line_control = 0;
695 priv->line_control = CONTROL_DTR | CONTROL_RTS;
697 spin_unlock_irq(&priv->lock);
698 cypress_write(NULL, port, NULL, 0);
701 static void cypress_close(struct usb_serial_port *port)
703 struct cypress_private *priv = usb_get_serial_port_data(port);
705 dbg("%s - port %d", __func__, port->number);
707 /* writing is potentially harmful, lock must be taken */
708 mutex_lock(&port->serial->disc_mutex);
709 if (port->serial->disconnected) {
710 mutex_unlock(&port->serial->disc_mutex);
713 cypress_buf_clear(priv->buf);
714 dbg("%s - stopping urbs", __func__);
715 usb_kill_urb(port->interrupt_in_urb);
716 usb_kill_urb(port->interrupt_out_urb);
720 dev_info(&port->dev, "Statistics: %d Bytes In | %d Bytes Out | %d Commands Issued\n",
721 priv->bytes_in, priv->bytes_out, priv->cmd_count);
722 mutex_unlock(&port->serial->disc_mutex);
723 } /* cypress_close */
726 static int cypress_write(struct tty_struct *tty, struct usb_serial_port *port,
727 const unsigned char *buf, int count)
729 struct cypress_private *priv = usb_get_serial_port_data(port);
732 dbg("%s - port %d, %d bytes", __func__, port->number, count);
734 /* line control commands, which need to be executed immediately,
735 are not put into the buffer for obvious reasons.
737 if (priv->cmd_ctrl) {
745 spin_lock_irqsave(&priv->lock, flags);
746 count = cypress_buf_put(priv->buf, buf, count);
747 spin_unlock_irqrestore(&priv->lock, flags);
753 } /* cypress_write */
756 static void cypress_send(struct usb_serial_port *port)
758 int count = 0, result, offset, actual_size;
759 struct cypress_private *priv = usb_get_serial_port_data(port);
762 if (!priv->comm_is_ok)
765 dbg("%s - port %d", __func__, port->number);
766 dbg("%s - interrupt out size is %d", __func__,
767 port->interrupt_out_size);
769 spin_lock_irqsave(&priv->lock, flags);
770 if (priv->write_urb_in_use) {
771 dbg("%s - can't write, urb in use", __func__);
772 spin_unlock_irqrestore(&priv->lock, flags);
775 spin_unlock_irqrestore(&priv->lock, flags);
778 memset(port->interrupt_out_urb->transfer_buffer, 0,
779 port->interrupt_out_size);
781 spin_lock_irqsave(&priv->lock, flags);
782 switch (priv->pkt_fmt) {
784 case packet_format_1:
785 /* this is for the CY7C64013... */
787 port->interrupt_out_buffer[0] = priv->line_control;
789 case packet_format_2:
790 /* this is for the CY7C63743... */
792 port->interrupt_out_buffer[0] = priv->line_control;
796 if (priv->line_control & CONTROL_RESET)
797 priv->line_control &= ~CONTROL_RESET;
799 if (priv->cmd_ctrl) {
801 dbg("%s - line control command being issued", __func__);
802 spin_unlock_irqrestore(&priv->lock, flags);
805 spin_unlock_irqrestore(&priv->lock, flags);
807 count = cypress_buf_get(priv->buf, &port->interrupt_out_buffer[offset],
808 port->interrupt_out_size-offset);
813 switch (priv->pkt_fmt) {
815 case packet_format_1:
816 port->interrupt_out_buffer[1] = count;
818 case packet_format_2:
819 port->interrupt_out_buffer[0] |= count;
822 dbg("%s - count is %d", __func__, count);
825 spin_lock_irqsave(&priv->lock, flags);
826 priv->write_urb_in_use = 1;
827 spin_unlock_irqrestore(&priv->lock, flags);
832 actual_size = count +
833 (priv->pkt_fmt == packet_format_1 ? 2 : 1);
835 usb_serial_debug_data(debug, &port->dev, __func__,
836 port->interrupt_out_size,
837 port->interrupt_out_urb->transfer_buffer);
839 usb_fill_int_urb(port->interrupt_out_urb, port->serial->dev,
840 usb_sndintpipe(port->serial->dev, port->interrupt_out_endpointAddress),
841 port->interrupt_out_buffer, port->interrupt_out_size,
842 cypress_write_int_callback, port, priv->write_urb_interval);
843 result = usb_submit_urb(port->interrupt_out_urb, GFP_ATOMIC);
846 "%s - failed submitting write urb, error %d\n",
848 priv->write_urb_in_use = 0;
849 cypress_set_dead(port);
852 spin_lock_irqsave(&priv->lock, flags);
856 /* do not count the line control and size bytes */
857 priv->bytes_out += count;
858 spin_unlock_irqrestore(&priv->lock, flags);
860 usb_serial_port_softint(port);
864 /* returns how much space is available in the soft buffer */
865 static int cypress_write_room(struct tty_struct *tty)
867 struct usb_serial_port *port = tty->driver_data;
868 struct cypress_private *priv = usb_get_serial_port_data(port);
872 dbg("%s - port %d", __func__, port->number);
874 spin_lock_irqsave(&priv->lock, flags);
875 room = cypress_buf_space_avail(priv->buf);
876 spin_unlock_irqrestore(&priv->lock, flags);
878 dbg("%s - returns %d", __func__, room);
883 static int cypress_tiocmget(struct tty_struct *tty, struct file *file)
885 struct usb_serial_port *port = tty->driver_data;
886 struct cypress_private *priv = usb_get_serial_port_data(port);
887 __u8 status, control;
888 unsigned int result = 0;
891 dbg("%s - port %d", __func__, port->number);
893 spin_lock_irqsave(&priv->lock, flags);
894 control = priv->line_control;
895 status = priv->current_status;
896 spin_unlock_irqrestore(&priv->lock, flags);
898 result = ((control & CONTROL_DTR) ? TIOCM_DTR : 0)
899 | ((control & CONTROL_RTS) ? TIOCM_RTS : 0)
900 | ((status & UART_CTS) ? TIOCM_CTS : 0)
901 | ((status & UART_DSR) ? TIOCM_DSR : 0)
902 | ((status & UART_RI) ? TIOCM_RI : 0)
903 | ((status & UART_CD) ? TIOCM_CD : 0);
905 dbg("%s - result = %x", __func__, result);
911 static int cypress_tiocmset(struct tty_struct *tty, struct file *file,
912 unsigned int set, unsigned int clear)
914 struct usb_serial_port *port = tty->driver_data;
915 struct cypress_private *priv = usb_get_serial_port_data(port);
918 dbg("%s - port %d", __func__, port->number);
920 spin_lock_irqsave(&priv->lock, flags);
922 priv->line_control |= CONTROL_RTS;
924 priv->line_control |= CONTROL_DTR;
925 if (clear & TIOCM_RTS)
926 priv->line_control &= ~CONTROL_RTS;
927 if (clear & TIOCM_DTR)
928 priv->line_control &= ~CONTROL_DTR;
930 spin_unlock_irqrestore(&priv->lock, flags);
932 return cypress_write(tty, port, NULL, 0);
936 static int cypress_ioctl(struct tty_struct *tty, struct file *file,
937 unsigned int cmd, unsigned long arg)
939 struct usb_serial_port *port = tty->driver_data;
940 struct cypress_private *priv = usb_get_serial_port_data(port);
942 dbg("%s - port %d, cmd 0x%.4x", __func__, port->number, cmd);
945 /* This code comes from drivers/char/serial.c and ftdi_sio.c */
947 while (priv != NULL) {
948 interruptible_sleep_on(&priv->delta_msr_wait);
949 /* see if a signal did it */
950 if (signal_pending(current))
953 char diff = priv->diff_status;
955 return -EIO; /* no change => error */
957 /* consume all events */
958 priv->diff_status = 0;
960 /* return 0 if caller wanted to know about
962 if (((arg & TIOCM_RNG) && (diff & UART_RI)) ||
963 ((arg & TIOCM_DSR) && (diff & UART_DSR)) ||
964 ((arg & TIOCM_CD) && (diff & UART_CD)) ||
965 ((arg & TIOCM_CTS) && (diff & UART_CTS)))
967 /* otherwise caller can't care less about what
968 * happened, and so we continue to wait for
977 dbg("%s - arg not supported - it was 0x%04x - check include/asm/ioctls.h", __func__, cmd);
979 } /* cypress_ioctl */
982 static void cypress_set_termios(struct tty_struct *tty,
983 struct usb_serial_port *port, struct ktermios *old_termios)
985 struct cypress_private *priv = usb_get_serial_port_data(port);
986 int data_bits, stop_bits, parity_type, parity_enable;
987 unsigned cflag, iflag;
992 dbg("%s - port %d", __func__, port->number);
994 spin_lock_irqsave(&priv->lock, flags);
995 /* We can't clean this one up as we don't know the device type
997 if (!priv->termios_initialized) {
998 if (priv->chiptype == CT_EARTHMATE) {
999 *(tty->termios) = tty_std_termios;
1000 tty->termios->c_cflag = B4800 | CS8 | CREAD | HUPCL |
1002 tty->termios->c_ispeed = 4800;
1003 tty->termios->c_ospeed = 4800;
1004 } else if (priv->chiptype == CT_CYPHIDCOM) {
1005 *(tty->termios) = tty_std_termios;
1006 tty->termios->c_cflag = B9600 | CS8 | CREAD | HUPCL |
1008 tty->termios->c_ispeed = 9600;
1009 tty->termios->c_ospeed = 9600;
1010 } else if (priv->chiptype == CT_CA42V2) {
1011 *(tty->termios) = tty_std_termios;
1012 tty->termios->c_cflag = B9600 | CS8 | CREAD | HUPCL |
1014 tty->termios->c_ispeed = 9600;
1015 tty->termios->c_ospeed = 9600;
1017 priv->termios_initialized = 1;
1019 spin_unlock_irqrestore(&priv->lock, flags);
1021 /* Unsupported features need clearing */
1022 tty->termios->c_cflag &= ~(CMSPAR|CRTSCTS);
1024 cflag = tty->termios->c_cflag;
1025 iflag = tty->termios->c_iflag;
1027 /* check if there are new settings */
1029 spin_lock_irqsave(&priv->lock, flags);
1030 priv->tmp_termios = *(tty->termios);
1031 spin_unlock_irqrestore(&priv->lock, flags);
1034 /* set number of data bits, parity, stop bits */
1035 /* when parity is disabled the parity type bit is ignored */
1037 /* 1 means 2 stop bits, 0 means 1 stop bit */
1038 stop_bits = cflag & CSTOPB ? 1 : 0;
1040 if (cflag & PARENB) {
1042 /* 1 means odd parity, 0 means even parity */
1043 parity_type = cflag & PARODD ? 1 : 0;
1045 parity_enable = parity_type = 0;
1047 switch (cflag & CSIZE) {
1061 dev_err(&port->dev, "%s - CSIZE was set, but not CS5-CS8\n",
1065 spin_lock_irqsave(&priv->lock, flags);
1066 oldlines = priv->line_control;
1067 if ((cflag & CBAUD) == B0) {
1068 /* drop dtr and rts */
1069 dbg("%s - dropping the lines, baud rate 0bps", __func__);
1070 priv->line_control &= ~(CONTROL_DTR | CONTROL_RTS);
1072 priv->line_control = (CONTROL_DTR | CONTROL_RTS);
1073 spin_unlock_irqrestore(&priv->lock, flags);
1075 dbg("%s - sending %d stop_bits, %d parity_enable, %d parity_type, "
1076 "%d data_bits (+5)", __func__, stop_bits,
1077 parity_enable, parity_type, data_bits);
1079 cypress_serial_control(tty, port, tty_get_baud_rate(tty),
1080 data_bits, stop_bits,
1081 parity_enable, parity_type,
1082 0, CYPRESS_SET_CONFIG);
1084 /* we perform a CYPRESS_GET_CONFIG so that the current settings are
1085 * filled into the private structure this should confirm that all is
1086 * working if it returns what we just set */
1087 cypress_serial_control(tty, port, 0, 0, 0, 0, 0, 0, CYPRESS_GET_CONFIG);
1089 /* Here we can define custom tty settings for devices; the main tty
1090 * termios flag base comes from empeg.c */
1092 spin_lock_irqsave(&priv->lock, flags);
1093 if (priv->chiptype == CT_EARTHMATE && priv->baud_rate == 4800) {
1094 dbg("Using custom termios settings for a baud rate of "
1096 /* define custom termios settings for NMEA protocol */
1098 tty->termios->c_iflag /* input modes - */
1099 &= ~(IGNBRK /* disable ignore break */
1100 | BRKINT /* disable break causes interrupt */
1101 | PARMRK /* disable mark parity errors */
1102 | ISTRIP /* disable clear high bit of input char */
1103 | INLCR /* disable translate NL to CR */
1104 | IGNCR /* disable ignore CR */
1105 | ICRNL /* disable translate CR to NL */
1106 | IXON); /* disable enable XON/XOFF flow control */
1108 tty->termios->c_oflag /* output modes */
1109 &= ~OPOST; /* disable postprocess output char */
1111 tty->termios->c_lflag /* line discipline modes */
1112 &= ~(ECHO /* disable echo input characters */
1113 | ECHONL /* disable echo new line */
1114 | ICANON /* disable erase, kill, werase, and rprnt
1115 special characters */
1116 | ISIG /* disable interrupt, quit, and suspend
1117 special characters */
1118 | IEXTEN); /* disable non-POSIX special characters */
1119 } /* CT_CYPHIDCOM: Application should handle this for device */
1121 linechange = (priv->line_control != oldlines);
1122 spin_unlock_irqrestore(&priv->lock, flags);
1124 /* if necessary, set lines */
1127 cypress_write(tty, port, NULL, 0);
1129 } /* cypress_set_termios */
1132 /* returns amount of data still left in soft buffer */
1133 static int cypress_chars_in_buffer(struct tty_struct *tty)
1135 struct usb_serial_port *port = tty->driver_data;
1136 struct cypress_private *priv = usb_get_serial_port_data(port);
1138 unsigned long flags;
1140 dbg("%s - port %d", __func__, port->number);
1142 spin_lock_irqsave(&priv->lock, flags);
1143 chars = cypress_buf_data_avail(priv->buf);
1144 spin_unlock_irqrestore(&priv->lock, flags);
1146 dbg("%s - returns %d", __func__, chars);
1151 static void cypress_throttle(struct tty_struct *tty)
1153 struct usb_serial_port *port = tty->driver_data;
1154 struct cypress_private *priv = usb_get_serial_port_data(port);
1156 dbg("%s - port %d", __func__, port->number);
1158 spin_lock_irq(&priv->lock);
1159 priv->rx_flags = THROTTLED;
1160 spin_unlock_irq(&priv->lock);
1164 static void cypress_unthrottle(struct tty_struct *tty)
1166 struct usb_serial_port *port = tty->driver_data;
1167 struct cypress_private *priv = usb_get_serial_port_data(port);
1168 int actually_throttled, result;
1170 dbg("%s - port %d", __func__, port->number);
1172 spin_lock_irq(&priv->lock);
1173 actually_throttled = priv->rx_flags & ACTUALLY_THROTTLED;
1175 spin_unlock_irq(&priv->lock);
1177 if (!priv->comm_is_ok)
1180 if (actually_throttled) {
1181 port->interrupt_in_urb->dev = port->serial->dev;
1183 result = usb_submit_urb(port->interrupt_in_urb, GFP_KERNEL);
1185 dev_err(&port->dev, "%s - failed submitting read urb, "
1186 "error %d\n", __func__, result);
1187 cypress_set_dead(port);
1193 static void cypress_read_int_callback(struct urb *urb)
1195 struct usb_serial_port *port = urb->context;
1196 struct cypress_private *priv = usb_get_serial_port_data(port);
1197 struct tty_struct *tty;
1198 unsigned char *data = urb->transfer_buffer;
1199 unsigned long flags;
1200 char tty_flag = TTY_NORMAL;
1205 int status = urb->status;
1207 dbg("%s - port %d", __func__, port->number);
1210 case 0: /* success */
1215 /* precursor to disconnect so just go away */
1218 /* Can't call usb_clear_halt while in_interrupt */
1221 /* something ugly is going on... */
1222 dev_err(&urb->dev->dev,
1223 "%s - unexpected nonzero read status received: %d\n",
1225 cypress_set_dead(port);
1229 spin_lock_irqsave(&priv->lock, flags);
1230 if (priv->rx_flags & THROTTLED) {
1231 dbg("%s - now throttling", __func__);
1232 priv->rx_flags |= ACTUALLY_THROTTLED;
1233 spin_unlock_irqrestore(&priv->lock, flags);
1236 spin_unlock_irqrestore(&priv->lock, flags);
1238 tty = tty_port_tty_get(&port->port);
1240 dbg("%s - bad tty pointer - exiting", __func__);
1244 spin_lock_irqsave(&priv->lock, flags);
1245 result = urb->actual_length;
1246 switch (priv->pkt_fmt) {
1248 case packet_format_1:
1249 /* This is for the CY7C64013... */
1250 priv->current_status = data[0] & 0xF8;
1251 bytes = data[1] + 2;
1256 case packet_format_2:
1257 /* This is for the CY7C63743... */
1258 priv->current_status = data[0] & 0xF8;
1259 bytes = (data[0] & 0x07) + 1;
1265 spin_unlock_irqrestore(&priv->lock, flags);
1266 if (result < bytes) {
1267 dbg("%s - wrong packet size - received %d bytes but packet "
1268 "said %d bytes", __func__, result, bytes);
1272 usb_serial_debug_data(debug, &port->dev, __func__,
1273 urb->actual_length, data);
1275 spin_lock_irqsave(&priv->lock, flags);
1276 /* check to see if status has changed */
1277 if (priv->current_status != priv->prev_status) {
1278 priv->diff_status |= priv->current_status ^
1280 wake_up_interruptible(&priv->delta_msr_wait);
1281 priv->prev_status = priv->current_status;
1283 spin_unlock_irqrestore(&priv->lock, flags);
1285 /* hangup, as defined in acm.c... this might be a bad place for it
1287 if (tty && !(tty->termios->c_cflag & CLOCAL) &&
1288 !(priv->current_status & UART_CD)) {
1289 dbg("%s - calling hangup", __func__);
1294 /* There is one error bit... I'm assuming it is a parity error
1295 * indicator as the generic firmware will set this bit to 1 if a
1296 * parity error occurs.
1297 * I can not find reference to any other error events. */
1298 spin_lock_irqsave(&priv->lock, flags);
1299 if (priv->current_status & CYP_ERROR) {
1300 spin_unlock_irqrestore(&priv->lock, flags);
1301 tty_flag = TTY_PARITY;
1302 dbg("%s - Parity Error detected", __func__);
1304 spin_unlock_irqrestore(&priv->lock, flags);
1306 /* process read if there is data other than line status */
1307 if (tty && (bytes > i)) {
1308 bytes = tty_buffer_request_room(tty, bytes);
1309 for (; i < bytes ; ++i) {
1310 dbg("pushing byte number %d - %d - %c", i, data[i],
1312 tty_insert_flip_char(tty, data[i], tty_flag);
1314 tty_flip_buffer_push(tty);
1317 spin_lock_irqsave(&priv->lock, flags);
1318 /* control and status byte(s) are also counted */
1319 priv->bytes_in += bytes;
1320 spin_unlock_irqrestore(&priv->lock, flags);
1325 /* Continue trying to always read... unless the port has closed. */
1327 if (port->port.count > 0 && priv->comm_is_ok) {
1328 usb_fill_int_urb(port->interrupt_in_urb, port->serial->dev,
1329 usb_rcvintpipe(port->serial->dev,
1330 port->interrupt_in_endpointAddress),
1331 port->interrupt_in_urb->transfer_buffer,
1332 port->interrupt_in_urb->transfer_buffer_length,
1333 cypress_read_int_callback, port,
1334 priv->read_urb_interval);
1335 result = usb_submit_urb(port->interrupt_in_urb, GFP_ATOMIC);
1337 dev_err(&urb->dev->dev, "%s - failed resubmitting "
1338 "read urb, error %d\n", __func__,
1340 cypress_set_dead(port);
1345 } /* cypress_read_int_callback */
1348 static void cypress_write_int_callback(struct urb *urb)
1350 struct usb_serial_port *port = urb->context;
1351 struct cypress_private *priv = usb_get_serial_port_data(port);
1353 int status = urb->status;
1355 dbg("%s - port %d", __func__, port->number);
1364 /* this urb is terminated, clean up */
1365 dbg("%s - urb shutting down with status: %d",
1367 priv->write_urb_in_use = 0;
1369 case -EPIPE: /* no break needed; clear halt and resubmit */
1370 if (!priv->comm_is_ok)
1372 usb_clear_halt(port->serial->dev, 0x02);
1373 /* error in the urb, so we have to resubmit it */
1374 dbg("%s - nonzero write bulk status received: %d",
1376 port->interrupt_out_urb->transfer_buffer_length = 1;
1377 port->interrupt_out_urb->dev = port->serial->dev;
1378 result = usb_submit_urb(port->interrupt_out_urb, GFP_ATOMIC);
1381 dev_err(&urb->dev->dev,
1382 "%s - failed resubmitting write urb, error %d\n",
1384 cypress_set_dead(port);
1387 dev_err(&urb->dev->dev,
1388 "%s - unexpected nonzero write status received: %d\n",
1390 cypress_set_dead(port);
1393 priv->write_urb_in_use = 0;
1395 /* send any buffered data */
1400 /*****************************************************************************
1401 * Write buffer functions - buffering code from pl2303 used
1402 *****************************************************************************/
1407 * Allocate a circular buffer and all associated memory.
1410 static struct cypress_buf *cypress_buf_alloc(unsigned int size)
1413 struct cypress_buf *cb;
1419 cb = kmalloc(sizeof(struct cypress_buf), GFP_KERNEL);
1423 cb->buf_buf = kmalloc(size, GFP_KERNEL);
1424 if (cb->buf_buf == NULL) {
1429 cb->buf_size = size;
1430 cb->buf_get = cb->buf_put = cb->buf_buf;
1440 * Free the buffer and all associated memory.
1443 static void cypress_buf_free(struct cypress_buf *cb)
1455 * Clear out all data in the circular buffer.
1458 static void cypress_buf_clear(struct cypress_buf *cb)
1461 cb->buf_get = cb->buf_put;
1462 /* equivalent to a get of all data available */
1467 * cypress_buf_data_avail
1469 * Return the number of bytes of data available in the circular
1473 static unsigned int cypress_buf_data_avail(struct cypress_buf *cb)
1476 return (cb->buf_size + cb->buf_put - cb->buf_get)
1484 * cypress_buf_space_avail
1486 * Return the number of bytes of space available in the circular
1490 static unsigned int cypress_buf_space_avail(struct cypress_buf *cb)
1493 return (cb->buf_size + cb->buf_get - cb->buf_put - 1)
1503 * Copy data data from a user buffer and put it into the circular buffer.
1504 * Restrict to the amount of space available.
1506 * Return the number of bytes copied.
1509 static unsigned int cypress_buf_put(struct cypress_buf *cb, const char *buf,
1519 len = cypress_buf_space_avail(cb);
1526 len = cb->buf_buf + cb->buf_size - cb->buf_put;
1528 memcpy(cb->buf_put, buf, len);
1529 memcpy(cb->buf_buf, buf+len, count - len);
1530 cb->buf_put = cb->buf_buf + count - len;
1532 memcpy(cb->buf_put, buf, count);
1534 cb->buf_put += count;
1535 else /* count == len */
1536 cb->buf_put = cb->buf_buf;
1547 * Get data from the circular buffer and copy to the given buffer.
1548 * Restrict to the amount of data available.
1550 * Return the number of bytes copied.
1553 static unsigned int cypress_buf_get(struct cypress_buf *cb, char *buf,
1563 len = cypress_buf_data_avail(cb);
1570 len = cb->buf_buf + cb->buf_size - cb->buf_get;
1572 memcpy(buf, cb->buf_get, len);
1573 memcpy(buf+len, cb->buf_buf, count - len);
1574 cb->buf_get = cb->buf_buf + count - len;
1576 memcpy(buf, cb->buf_get, count);
1578 cb->buf_get += count;
1579 else /* count == len */
1580 cb->buf_get = cb->buf_buf;
1587 /*****************************************************************************
1589 *****************************************************************************/
1591 static int __init cypress_init(void)
1595 dbg("%s", __func__);
1597 retval = usb_serial_register(&cypress_earthmate_device);
1599 goto failed_em_register;
1600 retval = usb_serial_register(&cypress_hidcom_device);
1602 goto failed_hidcom_register;
1603 retval = usb_serial_register(&cypress_ca42v2_device);
1605 goto failed_ca42v2_register;
1606 retval = usb_register(&cypress_driver);
1608 goto failed_usb_register;
1610 printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_VERSION ":"
1614 failed_usb_register:
1615 usb_serial_deregister(&cypress_ca42v2_device);
1616 failed_ca42v2_register:
1617 usb_serial_deregister(&cypress_hidcom_device);
1618 failed_hidcom_register:
1619 usb_serial_deregister(&cypress_earthmate_device);
1625 static void __exit cypress_exit(void)
1627 dbg("%s", __func__);
1629 usb_deregister(&cypress_driver);
1630 usb_serial_deregister(&cypress_earthmate_device);
1631 usb_serial_deregister(&cypress_hidcom_device);
1632 usb_serial_deregister(&cypress_ca42v2_device);
1636 module_init(cypress_init);
1637 module_exit(cypress_exit);
1639 MODULE_AUTHOR(DRIVER_AUTHOR);
1640 MODULE_DESCRIPTION(DRIVER_DESC);
1641 MODULE_VERSION(DRIVER_VERSION);
1642 MODULE_LICENSE("GPL");
1644 module_param(debug, bool, S_IRUGO | S_IWUSR);
1645 MODULE_PARM_DESC(debug, "Debug enabled or not");
1646 module_param(stats, bool, S_IRUGO | S_IWUSR);
1647 MODULE_PARM_DESC(stats, "Enable statistics or not");
1648 module_param(interval, int, S_IRUGO | S_IWUSR);
1649 MODULE_PARM_DESC(interval, "Overrides interrupt interval");
1650 module_param(unstable_bauds, bool, S_IRUGO | S_IWUSR);
1651 MODULE_PARM_DESC(unstable_bauds, "Allow unstable baud rates");