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/kernel.h>
39 #include <linux/errno.h>
40 #include <linux/init.h>
41 #include <linux/slab.h>
42 #include <linux/tty.h>
43 #include <linux/tty_driver.h>
44 #include <linux/tty_flip.h>
45 #include <linux/module.h>
46 #include <linux/spinlock.h>
47 #include <asm/uaccess.h>
48 #include <linux/usb.h>
49 #include <linux/usb/serial.h>
56 #define DRIVER_VERSION "v1.1"
57 #define DRIVER_AUTHOR "Alessandro Zummo"
58 #define DRIVER_DESC "USB ZyXEL omni.net LCD PLUS Driver"
60 #define ZYXEL_VENDOR_ID 0x0586
61 #define ZYXEL_OMNINET_ID 0x1000
62 #define BT_IGNITIONPRO_ID 0x2000 /* This one seems to be a re-branded ZyXEL device */
64 /* function prototypes */
65 static int omninet_open (struct usb_serial_port
*port
, struct file
*filp
);
66 static void omninet_close (struct usb_serial_port
*port
, struct file
*filp
);
67 static void omninet_read_bulk_callback (struct urb
*urb
);
68 static void omninet_write_bulk_callback (struct urb
*urb
);
69 static int omninet_write (struct usb_serial_port
*port
, const unsigned char *buf
, int count
);
70 static int omninet_write_room (struct usb_serial_port
*port
);
71 static void omninet_shutdown (struct usb_serial
*serial
);
73 static struct usb_device_id id_table
[] = {
74 { USB_DEVICE(ZYXEL_VENDOR_ID
, ZYXEL_OMNINET_ID
) },
75 { USB_DEVICE(ZYXEL_VENDOR_ID
, BT_IGNITIONPRO_ID
) },
76 { } /* Terminating entry */
79 MODULE_DEVICE_TABLE (usb
, id_table
);
81 static struct usb_driver omninet_driver
= {
83 .probe
= usb_serial_probe
,
84 .disconnect
= usb_serial_disconnect
,
90 static struct usb_serial_driver zyxel_omninet_device
= {
95 .description
= "ZyXEL - omni.net lcd plus usb",
96 .usb_driver
= &omninet_driver
,
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
);
175 /* open failed - all allocations must be freed */
177 usb_set_serial_port_data(port
, NULL
);
183 static void omninet_close (struct usb_serial_port
*port
, struct file
* filp
)
185 struct usb_serial
*serial
= port
->serial
;
186 struct usb_serial_port
*wport
;
188 dbg("%s - port %d", __FUNCTION__
, port
->number
);
190 wport
= serial
->port
[1];
191 usb_kill_urb(wport
->write_urb
);
192 usb_kill_urb(port
->read_urb
);
194 kfree(usb_get_serial_port_data(port
));
198 #define OMNINET_DATAOFFSET 0x04
199 #define OMNINET_HEADERLEN sizeof(struct omninet_header)
200 #define OMNINET_BULKOUTSIZE (64 - OMNINET_HEADERLEN)
202 static void omninet_read_bulk_callback (struct urb
*urb
)
204 struct usb_serial_port
*port
= (struct usb_serial_port
*)urb
->context
;
205 unsigned char *data
= urb
->transfer_buffer
;
206 struct omninet_header
*header
= (struct omninet_header
*) &data
[0];
211 dbg("%s - port %d", __FUNCTION__
, port
->number
);
214 dbg("%s - nonzero read bulk status received: %d", __FUNCTION__
, urb
->status
);
218 if ((debug
) && (header
->oh_xxx
!= 0x30)) {
219 if (urb
->actual_length
) {
220 printk (KERN_DEBUG __FILE__
": omninet_read %d: ", header
->oh_len
);
221 for (i
= 0; i
< (header
->oh_len
+ OMNINET_HEADERLEN
); i
++) {
222 printk ("%.2x ", data
[i
]);
228 if (urb
->actual_length
&& header
->oh_len
) {
229 for (i
= 0; i
< header
->oh_len
; i
++) {
230 tty_insert_flip_char(port
->tty
, data
[OMNINET_DATAOFFSET
+ i
], 0);
232 tty_flip_buffer_push(port
->tty
);
235 /* Continue trying to always read */
236 usb_fill_bulk_urb(urb
, port
->serial
->dev
,
237 usb_rcvbulkpipe(port
->serial
->dev
, port
->bulk_in_endpointAddress
),
238 urb
->transfer_buffer
, urb
->transfer_buffer_length
,
239 omninet_read_bulk_callback
, port
);
240 result
= usb_submit_urb(urb
, GFP_ATOMIC
);
242 err("%s - failed resubmitting read urb, error %d", __FUNCTION__
, result
);
247 static int omninet_write (struct usb_serial_port
*port
, const unsigned char *buf
, int count
)
249 struct usb_serial
*serial
= port
->serial
;
250 struct usb_serial_port
*wport
= serial
->port
[1];
252 struct omninet_data
*od
= usb_get_serial_port_data(port
);
253 struct omninet_header
*header
= (struct omninet_header
*) wport
->write_urb
->transfer_buffer
;
257 dbg("%s - port %d", __FUNCTION__
, port
->number
);
260 dbg("%s - write request of 0 bytes", __FUNCTION__
);
264 spin_lock_bh(&wport
->lock
);
265 if (wport
->write_urb_busy
) {
266 spin_unlock_bh(&wport
->lock
);
267 dbg("%s - already writing", __FUNCTION__
);
270 wport
->write_urb_busy
= 1;
271 spin_unlock_bh(&wport
->lock
);
273 count
= (count
> OMNINET_BULKOUTSIZE
) ? OMNINET_BULKOUTSIZE
: count
;
275 memcpy (wport
->write_urb
->transfer_buffer
+ OMNINET_DATAOFFSET
, buf
, count
);
277 usb_serial_debug_data(debug
, &port
->dev
, __FUNCTION__
, count
, wport
->write_urb
->transfer_buffer
);
279 header
->oh_seq
= od
->od_outseq
++;
280 header
->oh_len
= count
;
281 header
->oh_xxx
= 0x03;
282 header
->oh_pad
= 0x00;
284 /* send the data out the bulk port, always 64 bytes */
285 wport
->write_urb
->transfer_buffer_length
= 64;
287 wport
->write_urb
->dev
= serial
->dev
;
288 result
= usb_submit_urb(wport
->write_urb
, GFP_ATOMIC
);
290 wport
->write_urb_busy
= 0;
291 err("%s - failed submitting write urb, error %d", __FUNCTION__
, result
);
299 static int omninet_write_room (struct usb_serial_port
*port
)
301 struct usb_serial
*serial
= port
->serial
;
302 struct usb_serial_port
*wport
= serial
->port
[1];
304 int room
= 0; // Default: no room
306 if (wport
->write_urb_busy
)
307 room
= wport
->bulk_out_size
- OMNINET_HEADERLEN
;
309 dbg("%s - returns %d", __FUNCTION__
, room
);
314 static void omninet_write_bulk_callback (struct urb
*urb
)
316 /* struct omninet_header *header = (struct omninet_header *) urb->transfer_buffer; */
317 struct usb_serial_port
*port
= (struct usb_serial_port
*) urb
->context
;
319 dbg("%s - port %0x\n", __FUNCTION__
, port
->number
);
321 port
->write_urb_busy
= 0;
323 dbg("%s - nonzero write bulk status received: %d", __FUNCTION__
, urb
->status
);
327 usb_serial_port_softint(port
);
331 static void omninet_shutdown (struct usb_serial
*serial
)
333 dbg ("%s", __FUNCTION__
);
337 static int __init
omninet_init (void)
340 retval
= usb_serial_register(&zyxel_omninet_device
);
342 goto failed_usb_serial_register
;
343 retval
= usb_register(&omninet_driver
);
345 goto failed_usb_register
;
346 info(DRIVER_VERSION
":" DRIVER_DESC
);
349 usb_serial_deregister(&zyxel_omninet_device
);
350 failed_usb_serial_register
:
355 static void __exit
omninet_exit (void)
357 usb_deregister (&omninet_driver
);
358 usb_serial_deregister (&zyxel_omninet_device
);
362 module_init(omninet_init
);
363 module_exit(omninet_exit
);
365 MODULE_AUTHOR( DRIVER_AUTHOR
);
366 MODULE_DESCRIPTION( DRIVER_DESC
);
367 MODULE_LICENSE("GPL");
369 module_param(debug
, bool, S_IRUGO
| S_IWUSR
);
370 MODULE_PARM_DESC(debug
, "Debug enabled or not");