2 * USB ZyXEL omni.net LCD PLUS driver
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * See Documentation/usb/usb-serial.txt for more information on using this driver
11 * Please report both successes and troubles to the author at omninet@kroah.com
14 * switched from using spinlock to a semaphore, which fixes lots of problems.
17 * Identify version on module load.
19 * (11/01/2000) Adam J. Richter
20 * usb_device_id table support
23 * Fixed bug with urb->dev not being set properly, now that the usb
27 * Added locks for SMP safeness.
28 * Fixed MOD_INC and MOD_DEC logic and the ability to open a port more
30 * Fixed potential race in omninet_write_bulk_callback
33 * Added module_init and module_exit functions to handle the fact that this
34 * driver is a loadable module now.
38 #include <linux/config.h>
39 #include <linux/kernel.h>
40 #include <linux/errno.h>
41 #include <linux/init.h>
42 #include <linux/slab.h>
43 #include <linux/tty.h>
44 #include <linux/tty_driver.h>
45 #include <linux/tty_flip.h>
46 #include <linux/module.h>
47 #include <linux/spinlock.h>
48 #include <asm/uaccess.h>
49 #include <linux/usb.h>
50 #include "usb-serial.h"
57 #define DRIVER_VERSION "v1.1"
58 #define DRIVER_AUTHOR "Alessandro Zummo"
59 #define DRIVER_DESC "USB ZyXEL omni.net LCD PLUS Driver"
61 #define ZYXEL_VENDOR_ID 0x0586
62 #define ZYXEL_OMNINET_ID 0x1000
63 #define BT_IGNITIONPRO_ID 0x2000 /* This one seems to be a re-branded ZyXEL device */
65 /* function prototypes */
66 static int omninet_open (struct usb_serial_port
*port
, struct file
*filp
);
67 static void omninet_close (struct usb_serial_port
*port
, struct file
*filp
);
68 static void omninet_read_bulk_callback (struct urb
*urb
, struct pt_regs
*regs
);
69 static void omninet_write_bulk_callback (struct urb
*urb
, struct pt_regs
*regs
);
70 static int omninet_write (struct usb_serial_port
*port
, const unsigned char *buf
, int count
);
71 static int omninet_write_room (struct usb_serial_port
*port
);
72 static void omninet_shutdown (struct usb_serial
*serial
);
74 static struct usb_device_id id_table
[] = {
75 { USB_DEVICE(ZYXEL_VENDOR_ID
, ZYXEL_OMNINET_ID
) },
76 { USB_DEVICE(ZYXEL_VENDOR_ID
, BT_IGNITIONPRO_ID
) },
77 { } /* Terminating entry */
80 MODULE_DEVICE_TABLE (usb
, id_table
);
82 static struct usb_driver omninet_driver
= {
85 .probe
= usb_serial_probe
,
86 .disconnect
= usb_serial_disconnect
,
91 static struct usb_serial_driver zyxel_omninet_device
= {
96 .description
= "ZyXEL - omni.net lcd plus usb",
98 .num_interrupt_in
= 1,
102 .open
= omninet_open
,
103 .close
= omninet_close
,
104 .write
= omninet_write
,
105 .write_room
= omninet_write_room
,
106 .read_bulk_callback
= omninet_read_bulk_callback
,
107 .write_bulk_callback
= omninet_write_bulk_callback
,
108 .shutdown
= omninet_shutdown
,
114 * The omni.net always exchange 64 bytes of data with the host. The first
115 * four bytes are the control header, you can see it in the above structure.
117 * oh_seq is a sequence number. Don't know if/how it's used.
118 * oh_len is the length of the data bytes in the packet.
119 * oh_xxx Bit-mapped, related to handshaking and status info.
120 * I normally set it to 0x03 in trasmitted frames.
121 * 7: Active when the TA is in a CONNECTed state.
123 * 5: handshaking, unknown
124 * 4: handshaking, unknown
125 * 3: unknown, usually 0
126 * 2: unknown, usually 0
127 * 1: handshaking, unknown, usually set to 1 in trasmitted frames
128 * 0: handshaking, unknown, usually set to 1 in trasmitted frames
129 * oh_pad Probably a pad byte.
131 * After the header you will find data bytes if oh_len was greater than zero.
135 struct omninet_header
145 __u8 od_outseq
; // Sequence number for bulk_out URBs
148 static int omninet_open (struct usb_serial_port
*port
, struct file
*filp
)
150 struct usb_serial
*serial
= port
->serial
;
151 struct usb_serial_port
*wport
;
152 struct omninet_data
*od
;
155 dbg("%s - port %d", __FUNCTION__
, port
->number
);
157 od
= kmalloc( sizeof(struct omninet_data
), GFP_KERNEL
);
159 err("%s- kmalloc(%Zd) failed.", __FUNCTION__
, sizeof(struct omninet_data
));
163 usb_set_serial_port_data(port
, od
);
164 wport
= serial
->port
[1];
165 wport
->tty
= port
->tty
;
167 /* Start reading from the device */
168 usb_fill_bulk_urb(port
->read_urb
, serial
->dev
,
169 usb_rcvbulkpipe(serial
->dev
, port
->bulk_in_endpointAddress
),
170 port
->read_urb
->transfer_buffer
, port
->read_urb
->transfer_buffer_length
,
171 omninet_read_bulk_callback
, port
);
172 result
= usb_submit_urb(port
->read_urb
, GFP_KERNEL
);
174 err("%s - failed submitting read urb, error %d", __FUNCTION__
, result
);
179 static void omninet_close (struct usb_serial_port
*port
, struct file
* filp
)
181 struct usb_serial
*serial
= port
->serial
;
182 struct usb_serial_port
*wport
;
184 dbg("%s - port %d", __FUNCTION__
, port
->number
);
186 wport
= serial
->port
[1];
187 usb_kill_urb(wport
->write_urb
);
188 usb_kill_urb(port
->read_urb
);
190 kfree(usb_get_serial_port_data(port
));
194 #define OMNINET_DATAOFFSET 0x04
195 #define OMNINET_HEADERLEN sizeof(struct omninet_header)
196 #define OMNINET_BULKOUTSIZE (64 - OMNINET_HEADERLEN)
198 static void omninet_read_bulk_callback (struct urb
*urb
, struct pt_regs
*regs
)
200 struct usb_serial_port
*port
= (struct usb_serial_port
*)urb
->context
;
201 unsigned char *data
= urb
->transfer_buffer
;
202 struct omninet_header
*header
= (struct omninet_header
*) &data
[0];
207 // dbg("omninet_read_bulk_callback");
210 dbg("%s - nonzero read bulk status received: %d", __FUNCTION__
, urb
->status
);
214 if ((debug
) && (header
->oh_xxx
!= 0x30)) {
215 if (urb
->actual_length
) {
216 printk (KERN_DEBUG __FILE__
": omninet_read %d: ", header
->oh_len
);
217 for (i
= 0; i
< (header
->oh_len
+ OMNINET_HEADERLEN
); i
++) {
218 printk ("%.2x ", data
[i
]);
224 if (urb
->actual_length
&& header
->oh_len
) {
225 for (i
= 0; i
< header
->oh_len
; i
++) {
226 tty_insert_flip_char(port
->tty
, data
[OMNINET_DATAOFFSET
+ i
], 0);
228 tty_flip_buffer_push(port
->tty
);
231 /* Continue trying to always read */
232 usb_fill_bulk_urb(urb
, port
->serial
->dev
,
233 usb_rcvbulkpipe(port
->serial
->dev
, port
->bulk_in_endpointAddress
),
234 urb
->transfer_buffer
, urb
->transfer_buffer_length
,
235 omninet_read_bulk_callback
, port
);
236 result
= usb_submit_urb(urb
, GFP_ATOMIC
);
238 err("%s - failed resubmitting read urb, error %d", __FUNCTION__
, result
);
243 static int omninet_write (struct usb_serial_port
*port
, const unsigned char *buf
, int count
)
245 struct usb_serial
*serial
= port
->serial
;
246 struct usb_serial_port
*wport
= serial
->port
[1];
248 struct omninet_data
*od
= usb_get_serial_port_data(port
);
249 struct omninet_header
*header
= (struct omninet_header
*) wport
->write_urb
->transfer_buffer
;
253 // dbg("omninet_write port %d", port->number);
256 dbg("%s - write request of 0 bytes", __FUNCTION__
);
260 spin_lock(&port
->lock
);
261 if (port
->write_urb_busy
) {
262 spin_unlock(&port
->lock
);
263 dbg("%s - already writing", __FUNCTION__
);
266 port
->write_urb_busy
= 1;
267 spin_unlock(&port
->lock
);
269 count
= (count
> OMNINET_BULKOUTSIZE
) ? OMNINET_BULKOUTSIZE
: count
;
271 memcpy (wport
->write_urb
->transfer_buffer
+ OMNINET_DATAOFFSET
, buf
, count
);
273 usb_serial_debug_data(debug
, &port
->dev
, __FUNCTION__
, count
, wport
->write_urb
->transfer_buffer
);
275 header
->oh_seq
= od
->od_outseq
++;
276 header
->oh_len
= count
;
277 header
->oh_xxx
= 0x03;
278 header
->oh_pad
= 0x00;
280 /* send the data out the bulk port, always 64 bytes */
281 wport
->write_urb
->transfer_buffer_length
= 64;
283 wport
->write_urb
->dev
= serial
->dev
;
284 result
= usb_submit_urb(wport
->write_urb
, GFP_ATOMIC
);
286 port
->write_urb_busy
= 0;
287 err("%s - failed submitting write urb, error %d", __FUNCTION__
, result
);
295 static int omninet_write_room (struct usb_serial_port
*port
)
297 struct usb_serial
*serial
= port
->serial
;
298 struct usb_serial_port
*wport
= serial
->port
[1];
300 int room
= 0; // Default: no room
302 if (wport
->write_urb_busy
)
303 room
= wport
->bulk_out_size
- OMNINET_HEADERLEN
;
305 // dbg("omninet_write_room returns %d", room);
310 static void omninet_write_bulk_callback (struct urb
*urb
, struct pt_regs
*regs
)
312 /* struct omninet_header *header = (struct omninet_header *) urb->transfer_buffer; */
313 struct usb_serial_port
*port
= (struct usb_serial_port
*) urb
->context
;
315 // dbg("omninet_write_bulk_callback, port %0x\n", port);
317 port
->write_urb_busy
= 0;
319 dbg("%s - nonzero write bulk status received: %d", __FUNCTION__
, urb
->status
);
323 schedule_work(&port
->work
);
325 // dbg("omninet_write_bulk_callback, tty %0x\n", tty);
329 static void omninet_shutdown (struct usb_serial
*serial
)
331 dbg ("%s", __FUNCTION__
);
335 static int __init
omninet_init (void)
338 retval
= usb_serial_register(&zyxel_omninet_device
);
340 goto failed_usb_serial_register
;
341 retval
= usb_register(&omninet_driver
);
343 goto failed_usb_register
;
344 info(DRIVER_VERSION
":" DRIVER_DESC
);
347 usb_serial_deregister(&zyxel_omninet_device
);
348 failed_usb_serial_register
:
353 static void __exit
omninet_exit (void)
355 usb_deregister (&omninet_driver
);
356 usb_serial_deregister (&zyxel_omninet_device
);
360 module_init(omninet_init
);
361 module_exit(omninet_exit
);
363 MODULE_AUTHOR( DRIVER_AUTHOR
);
364 MODULE_DESCRIPTION( DRIVER_DESC
);
365 MODULE_LICENSE("GPL");
367 module_param(debug
, bool, S_IRUGO
| S_IWUSR
);
368 MODULE_PARM_DESC(debug
, "Debug enabled or not");