blob: 0f01dd3b59d09234d0ba90ae3eb17e2587e6ef49 [file] [log] [blame]
Greg Kroah-Hartman5fd54ac2017-11-03 11:28:30 +01001// SPDX-License-Identifier: GPL-2.0+
Michael Hund2824bd22005-06-27 22:44:22 +02002/**
3 * Generic USB driver for report based interrupt in/out devices
4 * like LD Didactic's USB devices. LD Didactic's USB devices are
5 * HID devices which do not use HID report definitons (they use
6 * raw interrupt in and our reports only for communication).
7 *
8 * This driver uses a ring buffer for time critical reading of
9 * interrupt in reports and provides read and write methods for
10 * raw interrupt reports (similar to the Windows HID driver).
11 * Devices based on the book USB COMPLETE by Jan Axelson may need
12 * such a compatibility to the Windows HID driver.
13 *
14 * Copyright (C) 2005 Michael Hund <mhund@ld-didactic.de>
15 *
16 * This program is free software; you can redistribute it and/or
17 * modify it under the terms of the GNU General Public License as
18 * published by the Free Software Foundation; either version 2 of
19 * the License, or (at your option) any later version.
20 *
21 * Derived from Lego USB Tower driver
22 * Copyright (C) 2003 David Glance <advidgsf@sourceforge.net>
23 * 2001-2004 Juergen Stuber <starblue@users.sourceforge.net>
Michael Hund2824bd22005-06-27 22:44:22 +020024 */
25
Michael Hund2824bd22005-06-27 22:44:22 +020026#include <linux/kernel.h>
27#include <linux/errno.h>
Michael Hund2824bd22005-06-27 22:44:22 +020028#include <linux/slab.h>
29#include <linux/module.h>
Arjan van de Ven4186ecf2006-01-11 15:55:29 +010030#include <linux/mutex.h>
Michael Hund2824bd22005-06-27 22:44:22 +020031
Linus Torvalds7c0f6ba2016-12-24 11:46:01 -080032#include <linux/uaccess.h>
Michael Hund2824bd22005-06-27 22:44:22 +020033#include <linux/input.h>
34#include <linux/usb.h>
35#include <linux/poll.h>
36
37/* Define these values to match your devices */
38#define USB_VENDOR_ID_LD 0x0f11 /* USB Vendor ID of LD Didactic GmbH */
Michael Hundce97cac2011-05-03 10:12:00 -070039#define USB_DEVICE_ID_LD_CASSY 0x1000 /* USB Product ID of CASSY-S modules with 8 bytes endpoint size */
40#define USB_DEVICE_ID_LD_CASSY2 0x1001 /* USB Product ID of CASSY-S modules with 64 bytes endpoint size */
Michael Hundba3e66e2006-02-02 09:36:43 +010041#define USB_DEVICE_ID_LD_POCKETCASSY 0x1010 /* USB Product ID of Pocket-CASSY */
Michael Hundce97cac2011-05-03 10:12:00 -070042#define USB_DEVICE_ID_LD_POCKETCASSY2 0x1011 /* USB Product ID of Pocket-CASSY 2 (reserved) */
Michael Hundba3e66e2006-02-02 09:36:43 +010043#define USB_DEVICE_ID_LD_MOBILECASSY 0x1020 /* USB Product ID of Mobile-CASSY */
Michael Hundce97cac2011-05-03 10:12:00 -070044#define USB_DEVICE_ID_LD_MOBILECASSY2 0x1021 /* USB Product ID of Mobile-CASSY 2 (reserved) */
45#define USB_DEVICE_ID_LD_MICROCASSYVOLTAGE 0x1031 /* USB Product ID of Micro-CASSY Voltage */
46#define USB_DEVICE_ID_LD_MICROCASSYCURRENT 0x1032 /* USB Product ID of Micro-CASSY Current */
47#define USB_DEVICE_ID_LD_MICROCASSYTIME 0x1033 /* USB Product ID of Micro-CASSY Time (reserved) */
48#define USB_DEVICE_ID_LD_MICROCASSYTEMPERATURE 0x1035 /* USB Product ID of Micro-CASSY Temperature */
49#define USB_DEVICE_ID_LD_MICROCASSYPH 0x1038 /* USB Product ID of Micro-CASSY pH */
Michael Hundba3e66e2006-02-02 09:36:43 +010050#define USB_DEVICE_ID_LD_JWM 0x1080 /* USB Product ID of Joule and Wattmeter */
51#define USB_DEVICE_ID_LD_DMMP 0x1081 /* USB Product ID of Digital Multimeter P (reserved) */
52#define USB_DEVICE_ID_LD_UMIP 0x1090 /* USB Product ID of UMI P */
Michael Hundce97cac2011-05-03 10:12:00 -070053#define USB_DEVICE_ID_LD_UMIC 0x10A0 /* USB Product ID of UMI C */
54#define USB_DEVICE_ID_LD_UMIB 0x10B0 /* USB Product ID of UMI B */
55#define USB_DEVICE_ID_LD_XRAY 0x1100 /* USB Product ID of X-Ray Apparatus 55481 */
56#define USB_DEVICE_ID_LD_XRAY2 0x1101 /* USB Product ID of X-Ray Apparatus 554800 */
57#define USB_DEVICE_ID_LD_XRAYCT 0x1110 /* USB Product ID of X-Ray Apparatus CT 554821*/
Michael Hundba3e66e2006-02-02 09:36:43 +010058#define USB_DEVICE_ID_LD_VIDEOCOM 0x1200 /* USB Product ID of VideoCom */
Michael Hundce97cac2011-05-03 10:12:00 -070059#define USB_DEVICE_ID_LD_MOTOR 0x1210 /* USB Product ID of Motor (reserved) */
Michael Hundba3e66e2006-02-02 09:36:43 +010060#define USB_DEVICE_ID_LD_COM3LAB 0x2000 /* USB Product ID of COM3LAB */
61#define USB_DEVICE_ID_LD_TELEPORT 0x2010 /* USB Product ID of Terminal Adapter */
62#define USB_DEVICE_ID_LD_NETWORKANALYSER 0x2020 /* USB Product ID of Network Analyser */
63#define USB_DEVICE_ID_LD_POWERCONTROL 0x2030 /* USB Product ID of Converter Control Unit */
64#define USB_DEVICE_ID_LD_MACHINETEST 0x2040 /* USB Product ID of Machine Test System */
Michael Hundce97cac2011-05-03 10:12:00 -070065#define USB_DEVICE_ID_LD_MOSTANALYSER 0x2050 /* USB Product ID of MOST Protocol Analyser */
66#define USB_DEVICE_ID_LD_MOSTANALYSER2 0x2051 /* USB Product ID of MOST Protocol Analyser 2 */
67#define USB_DEVICE_ID_LD_ABSESP 0x2060 /* USB Product ID of ABS ESP */
68#define USB_DEVICE_ID_LD_AUTODATABUS 0x2070 /* USB Product ID of Automotive Data Buses */
69#define USB_DEVICE_ID_LD_MCT 0x2080 /* USB Product ID of Microcontroller technique */
70#define USB_DEVICE_ID_LD_HYBRID 0x2090 /* USB Product ID of Automotive Hybrid */
71#define USB_DEVICE_ID_LD_HEATCONTROL 0x20A0 /* USB Product ID of Heat control */
Michael Hund2824bd22005-06-27 22:44:22 +020072
Michael Hund2824bd22005-06-27 22:44:22 +020073#ifdef CONFIG_USB_DYNAMIC_MINORS
74#define USB_LD_MINOR_BASE 0
75#else
76#define USB_LD_MINOR_BASE 176
77#endif
78
79/* table of devices that work with this driver */
Németh Márton33b9e162010-01-10 15:34:45 +010080static const struct usb_device_id ld_usb_table[] = {
Michael Hundba3e66e2006-02-02 09:36:43 +010081 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_CASSY) },
Michael Hundce97cac2011-05-03 10:12:00 -070082 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_CASSY2) },
Michael Hundba3e66e2006-02-02 09:36:43 +010083 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POCKETCASSY) },
Michael Hundce97cac2011-05-03 10:12:00 -070084 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POCKETCASSY2) },
Michael Hundba3e66e2006-02-02 09:36:43 +010085 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOBILECASSY) },
Michael Hundce97cac2011-05-03 10:12:00 -070086 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOBILECASSY2) },
87 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYVOLTAGE) },
88 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYCURRENT) },
89 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYTIME) },
90 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYTEMPERATURE) },
91 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MICROCASSYPH) },
Michael Hundba3e66e2006-02-02 09:36:43 +010092 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_JWM) },
93 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_DMMP) },
94 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIP) },
Michael Hundce97cac2011-05-03 10:12:00 -070095 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIC) },
96 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_UMIB) },
97 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY) },
Michael Hundba3e66e2006-02-02 09:36:43 +010098 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_XRAY2) },
99 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_VIDEOCOM) },
Michael Hundce97cac2011-05-03 10:12:00 -0700100 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOTOR) },
Michael Hundba3e66e2006-02-02 09:36:43 +0100101 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_COM3LAB) },
102 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_TELEPORT) },
103 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_NETWORKANALYSER) },
104 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_POWERCONTROL) },
105 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MACHINETEST) },
Michael Hundce97cac2011-05-03 10:12:00 -0700106 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOSTANALYSER) },
107 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MOSTANALYSER2) },
108 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_ABSESP) },
109 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_AUTODATABUS) },
110 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_MCT) },
111 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_HYBRID) },
112 { USB_DEVICE(USB_VENDOR_ID_LD, USB_DEVICE_ID_LD_HEATCONTROL) },
Michael Hund2824bd22005-06-27 22:44:22 +0200113 { } /* Terminating entry */
114};
115MODULE_DEVICE_TABLE(usb, ld_usb_table);
Michael Hund2824bd22005-06-27 22:44:22 +0200116MODULE_AUTHOR("Michael Hund <mhund@ld-didactic.de>");
117MODULE_DESCRIPTION("LD USB Driver");
118MODULE_LICENSE("GPL");
119MODULE_SUPPORTED_DEVICE("LD USB Devices");
120
Michael Hund2824bd22005-06-27 22:44:22 +0200121/* All interrupt in transfers are collected in a ring buffer to
122 * avoid racing conditions and get better performance of the driver.
123 */
124static int ring_buffer_size = 128;
Milian Reichardt3d1a4672017-03-04 03:42:32 +0100125module_param(ring_buffer_size, int, 0000);
Michael Hund2824bd22005-06-27 22:44:22 +0200126MODULE_PARM_DESC(ring_buffer_size, "Read ring buffer size in reports");
127
128/* The write_buffer can contain more than one interrupt out transfer.
129 */
130static int write_buffer_size = 10;
Milian Reichardt3d1a4672017-03-04 03:42:32 +0100131module_param(write_buffer_size, int, 0000);
Michael Hund2824bd22005-06-27 22:44:22 +0200132MODULE_PARM_DESC(write_buffer_size, "Write buffer size in reports");
133
134/* As of kernel version 2.6.4 ehci-hcd uses an
135 * "only one interrupt transfer per frame" shortcut
136 * to simplify the scheduling of periodic transfers.
137 * This conflicts with our standard 1ms intervals for in and out URBs.
138 * We use default intervals of 2ms for in and 2ms for out transfers,
139 * which should be fast enough.
140 * Increase the interval to allow more devices that do interrupt transfers,
141 * or set to 1 to use the standard interval from the endpoint descriptors.
142 */
143static int min_interrupt_in_interval = 2;
Milian Reichardt3d1a4672017-03-04 03:42:32 +0100144module_param(min_interrupt_in_interval, int, 0000);
Michael Hund2824bd22005-06-27 22:44:22 +0200145MODULE_PARM_DESC(min_interrupt_in_interval, "Minimum interrupt in interval in ms");
146
147static int min_interrupt_out_interval = 2;
Milian Reichardt3d1a4672017-03-04 03:42:32 +0100148module_param(min_interrupt_out_interval, int, 0000);
Michael Hund2824bd22005-06-27 22:44:22 +0200149MODULE_PARM_DESC(min_interrupt_out_interval, "Minimum interrupt out interval in ms");
150
151/* Structure to hold all of our device specific stuff */
152struct ld_usb {
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700153 struct mutex mutex; /* locks this structure */
Milian Reichardt4d72e352017-03-04 03:42:33 +0100154 struct usb_interface *intf; /* save off the usb interface pointer */
Michael Hund2824bd22005-06-27 22:44:22 +0200155
156 int open_count; /* number of times this port has been opened */
157
Milian Reichardt4d72e352017-03-04 03:42:33 +0100158 char *ring_buffer;
Michael Hund2824bd22005-06-27 22:44:22 +0200159 unsigned int ring_head;
160 unsigned int ring_tail;
161
162 wait_queue_head_t read_wait;
163 wait_queue_head_t write_wait;
164
Milian Reichardt4d72e352017-03-04 03:42:33 +0100165 char *interrupt_in_buffer;
166 struct usb_endpoint_descriptor *interrupt_in_endpoint;
167 struct urb *interrupt_in_urb;
Michael Hund2824bd22005-06-27 22:44:22 +0200168 int interrupt_in_interval;
169 size_t interrupt_in_endpoint_size;
170 int interrupt_in_running;
171 int interrupt_in_done;
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200172 int buffer_overflow;
173 spinlock_t rbsl;
Michael Hund2824bd22005-06-27 22:44:22 +0200174
Milian Reichardt4d72e352017-03-04 03:42:33 +0100175 char *interrupt_out_buffer;
176 struct usb_endpoint_descriptor *interrupt_out_endpoint;
177 struct urb *interrupt_out_urb;
Michael Hund2824bd22005-06-27 22:44:22 +0200178 int interrupt_out_interval;
179 size_t interrupt_out_endpoint_size;
180 int interrupt_out_busy;
181};
182
Michael Hund2824bd22005-06-27 22:44:22 +0200183static struct usb_driver ld_usb_driver;
184
185/**
186 * ld_usb_abort_transfers
187 * aborts transfers and frees associated data structures
188 */
189static void ld_usb_abort_transfers(struct ld_usb *dev)
190{
191 /* shutdown transfer */
192 if (dev->interrupt_in_running) {
193 dev->interrupt_in_running = 0;
194 if (dev->intf)
195 usb_kill_urb(dev->interrupt_in_urb);
196 }
197 if (dev->interrupt_out_busy)
198 if (dev->intf)
199 usb_kill_urb(dev->interrupt_out_urb);
200}
201
202/**
203 * ld_usb_delete
204 */
205static void ld_usb_delete(struct ld_usb *dev)
206{
207 ld_usb_abort_transfers(dev);
208
209 /* free data structures */
210 usb_free_urb(dev->interrupt_in_urb);
211 usb_free_urb(dev->interrupt_out_urb);
212 kfree(dev->ring_buffer);
213 kfree(dev->interrupt_in_buffer);
214 kfree(dev->interrupt_out_buffer);
215 kfree(dev);
216}
217
218/**
219 * ld_usb_interrupt_in_callback
220 */
David Howells7d12e782006-10-05 14:55:46 +0100221static void ld_usb_interrupt_in_callback(struct urb *urb)
Michael Hund2824bd22005-06-27 22:44:22 +0200222{
223 struct ld_usb *dev = urb->context;
224 size_t *actual_buffer;
225 unsigned int next_ring_head;
Greg Kroah-Hartman491c0212007-07-18 10:58:02 -0700226 int status = urb->status;
Michael Hund2824bd22005-06-27 22:44:22 +0200227 int retval;
228
Greg Kroah-Hartman491c0212007-07-18 10:58:02 -0700229 if (status) {
230 if (status == -ENOENT ||
231 status == -ECONNRESET ||
232 status == -ESHUTDOWN) {
Michael Hund2824bd22005-06-27 22:44:22 +0200233 goto exit;
234 } else {
Greg Kroah-Hartman457163c2013-06-26 16:30:38 -0700235 dev_dbg(&dev->intf->dev,
236 "%s: nonzero status received: %d\n", __func__,
237 status);
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200238 spin_lock(&dev->rbsl);
Michael Hund2824bd22005-06-27 22:44:22 +0200239 goto resubmit; /* maybe we can recover */
240 }
241 }
242
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200243 spin_lock(&dev->rbsl);
Michael Hund2824bd22005-06-27 22:44:22 +0200244 if (urb->actual_length > 0) {
245 next_ring_head = (dev->ring_head+1) % ring_buffer_size;
246 if (next_ring_head != dev->ring_tail) {
Milian Reichardt4d72e352017-03-04 03:42:33 +0100247 actual_buffer = (size_t *)(dev->ring_buffer + dev->ring_head * (sizeof(size_t)+dev->interrupt_in_endpoint_size));
Michael Hund2824bd22005-06-27 22:44:22 +0200248 /* actual_buffer gets urb->actual_length + interrupt_in_buffer */
249 *actual_buffer = urb->actual_length;
250 memcpy(actual_buffer+1, dev->interrupt_in_buffer, urb->actual_length);
251 dev->ring_head = next_ring_head;
Greg Kroah-Hartman457163c2013-06-26 16:30:38 -0700252 dev_dbg(&dev->intf->dev, "%s: received %d bytes\n",
253 __func__, urb->actual_length);
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200254 } else {
Michael Hund2824bd22005-06-27 22:44:22 +0200255 dev_warn(&dev->intf->dev,
256 "Ring buffer overflow, %d bytes dropped\n",
257 urb->actual_length);
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200258 dev->buffer_overflow = 1;
259 }
Michael Hund2824bd22005-06-27 22:44:22 +0200260 }
261
262resubmit:
263 /* resubmit if we're still running */
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200264 if (dev->interrupt_in_running && !dev->buffer_overflow && dev->intf) {
Michael Hund2824bd22005-06-27 22:44:22 +0200265 retval = usb_submit_urb(dev->interrupt_in_urb, GFP_ATOMIC);
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200266 if (retval) {
Michael Hund2824bd22005-06-27 22:44:22 +0200267 dev_err(&dev->intf->dev,
268 "usb_submit_urb failed (%d)\n", retval);
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200269 dev->buffer_overflow = 1;
270 }
Michael Hund2824bd22005-06-27 22:44:22 +0200271 }
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200272 spin_unlock(&dev->rbsl);
Michael Hund2824bd22005-06-27 22:44:22 +0200273exit:
274 dev->interrupt_in_done = 1;
275 wake_up_interruptible(&dev->read_wait);
276}
277
278/**
279 * ld_usb_interrupt_out_callback
280 */
David Howells7d12e782006-10-05 14:55:46 +0100281static void ld_usb_interrupt_out_callback(struct urb *urb)
Michael Hund2824bd22005-06-27 22:44:22 +0200282{
283 struct ld_usb *dev = urb->context;
Greg Kroah-Hartman491c0212007-07-18 10:58:02 -0700284 int status = urb->status;
Michael Hund2824bd22005-06-27 22:44:22 +0200285
286 /* sync/async unlink faults aren't errors */
Greg Kroah-Hartman491c0212007-07-18 10:58:02 -0700287 if (status && !(status == -ENOENT ||
288 status == -ECONNRESET ||
289 status == -ESHUTDOWN))
Greg Kroah-Hartman457163c2013-06-26 16:30:38 -0700290 dev_dbg(&dev->intf->dev,
291 "%s - nonzero write interrupt status received: %d\n",
292 __func__, status);
Michael Hund2824bd22005-06-27 22:44:22 +0200293
294 dev->interrupt_out_busy = 0;
295 wake_up_interruptible(&dev->write_wait);
296}
297
298/**
299 * ld_usb_open
300 */
301static int ld_usb_open(struct inode *inode, struct file *file)
302{
303 struct ld_usb *dev;
304 int subminor;
Alan Sternd4ead162007-05-22 11:46:41 -0400305 int retval;
Michael Hund2824bd22005-06-27 22:44:22 +0200306 struct usb_interface *interface;
307
308 nonseekable_open(inode, file);
309 subminor = iminor(inode);
310
Michael Hund2824bd22005-06-27 22:44:22 +0200311 interface = usb_find_interface(&ld_usb_driver, subminor);
312
313 if (!interface) {
Greg Kroah-Hartmanb22862e2012-04-20 16:53:47 -0700314 printk(KERN_ERR "%s - error, can't find device for minor %d\n",
315 __func__, subminor);
Alan Sternd4ead162007-05-22 11:46:41 -0400316 return -ENODEV;
Michael Hund2824bd22005-06-27 22:44:22 +0200317 }
318
319 dev = usb_get_intfdata(interface);
320
Oliver Neukum6248c522010-01-14 16:12:27 +0100321 if (!dev)
Alan Sternd4ead162007-05-22 11:46:41 -0400322 return -ENODEV;
Michael Hund2824bd22005-06-27 22:44:22 +0200323
324 /* lock this device */
Oliver Neukum6248c522010-01-14 16:12:27 +0100325 if (mutex_lock_interruptible(&dev->mutex))
Alan Sternd4ead162007-05-22 11:46:41 -0400326 return -ERESTARTSYS;
Michael Hund2824bd22005-06-27 22:44:22 +0200327
328 /* allow opening only once */
329 if (dev->open_count) {
330 retval = -EBUSY;
331 goto unlock_exit;
332 }
333 dev->open_count = 1;
334
335 /* initialize in direction */
336 dev->ring_head = 0;
337 dev->ring_tail = 0;
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200338 dev->buffer_overflow = 0;
Michael Hund2824bd22005-06-27 22:44:22 +0200339 usb_fill_int_urb(dev->interrupt_in_urb,
340 interface_to_usbdev(interface),
341 usb_rcvintpipe(interface_to_usbdev(interface),
342 dev->interrupt_in_endpoint->bEndpointAddress),
343 dev->interrupt_in_buffer,
344 dev->interrupt_in_endpoint_size,
345 ld_usb_interrupt_in_callback,
346 dev,
347 dev->interrupt_in_interval);
348
349 dev->interrupt_in_running = 1;
350 dev->interrupt_in_done = 0;
351
352 retval = usb_submit_urb(dev->interrupt_in_urb, GFP_KERNEL);
353 if (retval) {
354 dev_err(&interface->dev, "Couldn't submit interrupt_in_urb %d\n", retval);
355 dev->interrupt_in_running = 0;
356 dev->open_count = 0;
357 goto unlock_exit;
358 }
359
360 /* save device in the file's private structure */
361 file->private_data = dev;
362
363unlock_exit:
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700364 mutex_unlock(&dev->mutex);
Michael Hund2824bd22005-06-27 22:44:22 +0200365
Michael Hund2824bd22005-06-27 22:44:22 +0200366 return retval;
367}
368
369/**
370 * ld_usb_release
371 */
372static int ld_usb_release(struct inode *inode, struct file *file)
373{
374 struct ld_usb *dev;
375 int retval = 0;
376
377 dev = file->private_data;
378
379 if (dev == NULL) {
380 retval = -ENODEV;
381 goto exit;
382 }
383
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700384 if (mutex_lock_interruptible(&dev->mutex)) {
Michael Hund2824bd22005-06-27 22:44:22 +0200385 retval = -ERESTARTSYS;
386 goto exit;
387 }
388
389 if (dev->open_count != 1) {
390 retval = -ENODEV;
391 goto unlock_exit;
392 }
393 if (dev->intf == NULL) {
394 /* the device was unplugged before the file was released */
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700395 mutex_unlock(&dev->mutex);
Michael Hund2824bd22005-06-27 22:44:22 +0200396 /* unlock here as ld_usb_delete frees dev */
397 ld_usb_delete(dev);
398 goto exit;
399 }
400
401 /* wait until write transfer is finished */
402 if (dev->interrupt_out_busy)
403 wait_event_interruptible_timeout(dev->write_wait, !dev->interrupt_out_busy, 2 * HZ);
404 ld_usb_abort_transfers(dev);
405 dev->open_count = 0;
406
407unlock_exit:
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700408 mutex_unlock(&dev->mutex);
Michael Hund2824bd22005-06-27 22:44:22 +0200409
410exit:
411 return retval;
412}
413
414/**
415 * ld_usb_poll
416 */
417static unsigned int ld_usb_poll(struct file *file, poll_table *wait)
418{
419 struct ld_usb *dev;
420 unsigned int mask = 0;
421
422 dev = file->private_data;
423
Oliver Neukumd12b85e2009-07-02 17:01:06 +0200424 if (!dev->intf)
425 return POLLERR | POLLHUP;
426
Michael Hund2824bd22005-06-27 22:44:22 +0200427 poll_wait(file, &dev->read_wait, wait);
428 poll_wait(file, &dev->write_wait, wait);
429
430 if (dev->ring_head != dev->ring_tail)
431 mask |= POLLIN | POLLRDNORM;
432 if (!dev->interrupt_out_busy)
433 mask |= POLLOUT | POLLWRNORM;
434
435 return mask;
436}
437
438/**
439 * ld_usb_read
440 */
441static ssize_t ld_usb_read(struct file *file, char __user *buffer, size_t count,
442 loff_t *ppos)
443{
444 struct ld_usb *dev;
445 size_t *actual_buffer;
446 size_t bytes_to_read;
447 int retval = 0;
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200448 int rv;
Michael Hund2824bd22005-06-27 22:44:22 +0200449
450 dev = file->private_data;
451
452 /* verify that we actually have some data to read */
453 if (count == 0)
454 goto exit;
455
456 /* lock this object */
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700457 if (mutex_lock_interruptible(&dev->mutex)) {
Michael Hund2824bd22005-06-27 22:44:22 +0200458 retval = -ERESTARTSYS;
459 goto exit;
460 }
461
462 /* verify that the device wasn't unplugged */
463 if (dev->intf == NULL) {
464 retval = -ENODEV;
Greg Kroah-Hartmanb22862e2012-04-20 16:53:47 -0700465 printk(KERN_ERR "ldusb: No device or device unplugged %d\n", retval);
Michael Hund2824bd22005-06-27 22:44:22 +0200466 goto unlock_exit;
467 }
468
469 /* wait for data */
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200470 spin_lock_irq(&dev->rbsl);
Michael Hund2824bd22005-06-27 22:44:22 +0200471 if (dev->ring_head == dev->ring_tail) {
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200472 dev->interrupt_in_done = 0;
473 spin_unlock_irq(&dev->rbsl);
Michael Hund2824bd22005-06-27 22:44:22 +0200474 if (file->f_flags & O_NONBLOCK) {
475 retval = -EAGAIN;
476 goto unlock_exit;
477 }
478 retval = wait_event_interruptible(dev->read_wait, dev->interrupt_in_done);
479 if (retval < 0)
480 goto unlock_exit;
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200481 } else {
482 spin_unlock_irq(&dev->rbsl);
Michael Hund2824bd22005-06-27 22:44:22 +0200483 }
484
485 /* actual_buffer contains actual_length + interrupt_in_buffer */
Milian Reichardt4d72e352017-03-04 03:42:33 +0100486 actual_buffer = (size_t *)(dev->ring_buffer + dev->ring_tail * (sizeof(size_t)+dev->interrupt_in_endpoint_size));
Michael Hund2824bd22005-06-27 22:44:22 +0200487 bytes_to_read = min(count, *actual_buffer);
488 if (bytes_to_read < *actual_buffer)
Alexey Dobriyandd7d5002005-08-14 17:24:26 +0400489 dev_warn(&dev->intf->dev, "Read buffer overflow, %zd bytes dropped\n",
Michael Hund2824bd22005-06-27 22:44:22 +0200490 *actual_buffer-bytes_to_read);
491
492 /* copy one interrupt_in_buffer from ring_buffer into userspace */
493 if (copy_to_user(buffer, actual_buffer+1, bytes_to_read)) {
494 retval = -EFAULT;
495 goto unlock_exit;
496 }
497 dev->ring_tail = (dev->ring_tail+1) % ring_buffer_size;
498
499 retval = bytes_to_read;
500
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200501 spin_lock_irq(&dev->rbsl);
502 if (dev->buffer_overflow) {
503 dev->buffer_overflow = 0;
504 spin_unlock_irq(&dev->rbsl);
505 rv = usb_submit_urb(dev->interrupt_in_urb, GFP_KERNEL);
506 if (rv < 0)
507 dev->buffer_overflow = 1;
508 } else {
509 spin_unlock_irq(&dev->rbsl);
510 }
511
Michael Hund2824bd22005-06-27 22:44:22 +0200512unlock_exit:
513 /* unlock the device */
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700514 mutex_unlock(&dev->mutex);
Michael Hund2824bd22005-06-27 22:44:22 +0200515
516exit:
517 return retval;
518}
519
520/**
521 * ld_usb_write
522 */
523static ssize_t ld_usb_write(struct file *file, const char __user *buffer,
524 size_t count, loff_t *ppos)
525{
526 struct ld_usb *dev;
527 size_t bytes_to_write;
528 int retval = 0;
529
530 dev = file->private_data;
531
532 /* verify that we actually have some data to write */
533 if (count == 0)
534 goto exit;
535
536 /* lock this object */
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700537 if (mutex_lock_interruptible(&dev->mutex)) {
Michael Hund2824bd22005-06-27 22:44:22 +0200538 retval = -ERESTARTSYS;
539 goto exit;
540 }
541
542 /* verify that the device wasn't unplugged */
543 if (dev->intf == NULL) {
544 retval = -ENODEV;
Greg Kroah-Hartmanb22862e2012-04-20 16:53:47 -0700545 printk(KERN_ERR "ldusb: No device or device unplugged %d\n", retval);
Michael Hund2824bd22005-06-27 22:44:22 +0200546 goto unlock_exit;
547 }
548
549 /* wait until previous transfer is finished */
550 if (dev->interrupt_out_busy) {
551 if (file->f_flags & O_NONBLOCK) {
552 retval = -EAGAIN;
553 goto unlock_exit;
554 }
555 retval = wait_event_interruptible(dev->write_wait, !dev->interrupt_out_busy);
556 if (retval < 0) {
557 goto unlock_exit;
558 }
559 }
560
561 /* write the data into interrupt_out_buffer from userspace */
562 bytes_to_write = min(count, write_buffer_size*dev->interrupt_out_endpoint_size);
563 if (bytes_to_write < count)
Milian Reichardte3146212017-03-04 03:42:34 +0100564 dev_warn(&dev->intf->dev, "Write buffer overflow, %zd bytes dropped\n", count-bytes_to_write);
Greg Kroah-Hartman457163c2013-06-26 16:30:38 -0700565 dev_dbg(&dev->intf->dev, "%s: count = %zd, bytes_to_write = %zd\n",
566 __func__, count, bytes_to_write);
Michael Hund2824bd22005-06-27 22:44:22 +0200567
568 if (copy_from_user(dev->interrupt_out_buffer, buffer, bytes_to_write)) {
569 retval = -EFAULT;
570 goto unlock_exit;
571 }
572
573 if (dev->interrupt_out_endpoint == NULL) {
574 /* try HID_REQ_SET_REPORT=9 on control_endpoint instead of interrupt_out_endpoint */
575 retval = usb_control_msg(interface_to_usbdev(dev->intf),
576 usb_sndctrlpipe(interface_to_usbdev(dev->intf), 0),
577 9,
578 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_OUT,
579 1 << 8, 0,
580 dev->interrupt_out_buffer,
581 bytes_to_write,
582 USB_CTRL_SET_TIMEOUT * HZ);
583 if (retval < 0)
Greg Kroah-Hartmanb22862e2012-04-20 16:53:47 -0700584 dev_err(&dev->intf->dev,
585 "Couldn't submit HID_REQ_SET_REPORT %d\n",
586 retval);
Michael Hund2824bd22005-06-27 22:44:22 +0200587 goto unlock_exit;
588 }
589
590 /* send off the urb */
591 usb_fill_int_urb(dev->interrupt_out_urb,
592 interface_to_usbdev(dev->intf),
593 usb_sndintpipe(interface_to_usbdev(dev->intf),
594 dev->interrupt_out_endpoint->bEndpointAddress),
595 dev->interrupt_out_buffer,
596 bytes_to_write,
597 ld_usb_interrupt_out_callback,
598 dev,
599 dev->interrupt_out_interval);
600
601 dev->interrupt_out_busy = 1;
602 wmb();
603
604 retval = usb_submit_urb(dev->interrupt_out_urb, GFP_KERNEL);
605 if (retval) {
606 dev->interrupt_out_busy = 0;
Greg Kroah-Hartmanb22862e2012-04-20 16:53:47 -0700607 dev_err(&dev->intf->dev,
608 "Couldn't submit interrupt_out_urb %d\n", retval);
Michael Hund2824bd22005-06-27 22:44:22 +0200609 goto unlock_exit;
610 }
611 retval = bytes_to_write;
612
613unlock_exit:
614 /* unlock the device */
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700615 mutex_unlock(&dev->mutex);
Michael Hund2824bd22005-06-27 22:44:22 +0200616
617exit:
618 return retval;
619}
620
621/* file operations needed when we register this driver */
Luiz Fernando N. Capitulino066202d2006-08-05 20:37:11 -0300622static const struct file_operations ld_usb_fops = {
Michael Hund2824bd22005-06-27 22:44:22 +0200623 .owner = THIS_MODULE,
624 .read = ld_usb_read,
625 .write = ld_usb_write,
626 .open = ld_usb_open,
627 .release = ld_usb_release,
628 .poll = ld_usb_poll,
Arnd Bergmann6038f372010-08-15 18:52:59 +0200629 .llseek = no_llseek,
Michael Hund2824bd22005-06-27 22:44:22 +0200630};
631
632/*
633 * usb class driver info in order to get a minor number from the usb core,
Greg Kroah-Hartman595b14c2006-01-18 17:36:58 -0500634 * and to have the device registered with the driver core
Michael Hund2824bd22005-06-27 22:44:22 +0200635 */
636static struct usb_class_driver ld_usb_class = {
637 .name = "ldusb%d",
638 .fops = &ld_usb_fops,
639 .minor_base = USB_LD_MINOR_BASE,
640};
641
642/**
643 * ld_usb_probe
644 *
645 * Called by the usb core when a new device is connected that it thinks
646 * this driver might be interested in.
647 */
648static int ld_usb_probe(struct usb_interface *intf, const struct usb_device_id *id)
649{
650 struct usb_device *udev = interface_to_usbdev(intf);
651 struct ld_usb *dev = NULL;
652 struct usb_host_interface *iface_desc;
Michael Hund2824bd22005-06-27 22:44:22 +0200653 char *buffer;
Michael Hund2824bd22005-06-27 22:44:22 +0200654 int retval = -ENOMEM;
Johan Hovold2707ca12017-03-17 11:35:40 +0100655 int res;
Michael Hund2824bd22005-06-27 22:44:22 +0200656
Uwe Kleine-Königb5950762010-11-01 15:38:34 -0400657 /* allocate memory for our device state and initialize it */
Michael Hund2824bd22005-06-27 22:44:22 +0200658
Oliver Neukum1144cf72006-01-06 22:40:02 +0100659 dev = kzalloc(sizeof(*dev), GFP_KERNEL);
Wolfram Sang6714ffa2016-08-25 19:39:18 +0200660 if (!dev)
Michael Hund2824bd22005-06-27 22:44:22 +0200661 goto exit;
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700662 mutex_init(&dev->mutex);
Oliver Neukum9d33efd2007-05-04 09:23:40 +0200663 spin_lock_init(&dev->rbsl);
Michael Hund2824bd22005-06-27 22:44:22 +0200664 dev->intf = intf;
665 init_waitqueue_head(&dev->read_wait);
666 init_waitqueue_head(&dev->write_wait);
667
668 /* workaround for early firmware versions on fast computers */
669 if ((le16_to_cpu(udev->descriptor.idVendor) == USB_VENDOR_ID_LD) &&
Michael Hundba3e66e2006-02-02 09:36:43 +0100670 ((le16_to_cpu(udev->descriptor.idProduct) == USB_DEVICE_ID_LD_CASSY) ||
671 (le16_to_cpu(udev->descriptor.idProduct) == USB_DEVICE_ID_LD_COM3LAB)) &&
Michael Hund2824bd22005-06-27 22:44:22 +0200672 (le16_to_cpu(udev->descriptor.bcdDevice) <= 0x103)) {
673 buffer = kmalloc(256, GFP_KERNEL);
Wolfram Sang6714ffa2016-08-25 19:39:18 +0200674 if (!buffer)
Michael Hunda6db5922005-07-29 12:17:20 -0700675 goto error;
Michael Hund2824bd22005-06-27 22:44:22 +0200676 /* usb_string makes SETUP+STALL to leave always ControlReadLoop */
677 usb_string(udev, 255, buffer, 256);
678 kfree(buffer);
679 }
680
681 iface_desc = intf->cur_altsetting;
682
Johan Hovold2707ca12017-03-17 11:35:40 +0100683 res = usb_find_last_int_in_endpoint(iface_desc,
684 &dev->interrupt_in_endpoint);
685 if (res) {
Michael Hund2824bd22005-06-27 22:44:22 +0200686 dev_err(&intf->dev, "Interrupt in endpoint not found\n");
Johan Hovold2707ca12017-03-17 11:35:40 +0100687 retval = res;
Michael Hund2824bd22005-06-27 22:44:22 +0200688 goto error;
689 }
Johan Hovold2707ca12017-03-17 11:35:40 +0100690
691 res = usb_find_last_int_out_endpoint(iface_desc,
692 &dev->interrupt_out_endpoint);
693 if (res)
Michael Hund2824bd22005-06-27 22:44:22 +0200694 dev_warn(&intf->dev, "Interrupt out endpoint not found (using control endpoint instead)\n");
695
Kuninori Morimoto29cc8892011-08-23 03:12:03 -0700696 dev->interrupt_in_endpoint_size = usb_endpoint_maxp(dev->interrupt_in_endpoint);
Michael Hund2824bd22005-06-27 22:44:22 +0200697 dev->ring_buffer = kmalloc(ring_buffer_size*(sizeof(size_t)+dev->interrupt_in_endpoint_size), GFP_KERNEL);
Wolfram Sang6714ffa2016-08-25 19:39:18 +0200698 if (!dev->ring_buffer)
Michael Hund2824bd22005-06-27 22:44:22 +0200699 goto error;
Michael Hund2824bd22005-06-27 22:44:22 +0200700 dev->interrupt_in_buffer = kmalloc(dev->interrupt_in_endpoint_size, GFP_KERNEL);
Wolfram Sang6714ffa2016-08-25 19:39:18 +0200701 if (!dev->interrupt_in_buffer)
Michael Hund2824bd22005-06-27 22:44:22 +0200702 goto error;
Michael Hund2824bd22005-06-27 22:44:22 +0200703 dev->interrupt_in_urb = usb_alloc_urb(0, GFP_KERNEL);
Wolfram Sang2d403902016-08-11 23:14:40 +0200704 if (!dev->interrupt_in_urb)
Michael Hund2824bd22005-06-27 22:44:22 +0200705 goto error;
Kuninori Morimoto29cc8892011-08-23 03:12:03 -0700706 dev->interrupt_out_endpoint_size = dev->interrupt_out_endpoint ? usb_endpoint_maxp(dev->interrupt_out_endpoint) :
Michael Hund2824bd22005-06-27 22:44:22 +0200707 udev->descriptor.bMaxPacketSize0;
708 dev->interrupt_out_buffer = kmalloc(write_buffer_size*dev->interrupt_out_endpoint_size, GFP_KERNEL);
Wolfram Sang6714ffa2016-08-25 19:39:18 +0200709 if (!dev->interrupt_out_buffer)
Michael Hund2824bd22005-06-27 22:44:22 +0200710 goto error;
Michael Hund2824bd22005-06-27 22:44:22 +0200711 dev->interrupt_out_urb = usb_alloc_urb(0, GFP_KERNEL);
Wolfram Sang2d403902016-08-11 23:14:40 +0200712 if (!dev->interrupt_out_urb)
Michael Hund2824bd22005-06-27 22:44:22 +0200713 goto error;
Michael Hund2824bd22005-06-27 22:44:22 +0200714 dev->interrupt_in_interval = min_interrupt_in_interval > dev->interrupt_in_endpoint->bInterval ? min_interrupt_in_interval : dev->interrupt_in_endpoint->bInterval;
715 if (dev->interrupt_out_endpoint)
716 dev->interrupt_out_interval = min_interrupt_out_interval > dev->interrupt_out_endpoint->bInterval ? min_interrupt_out_interval : dev->interrupt_out_endpoint->bInterval;
717
718 /* we can register the device now, as it is ready */
719 usb_set_intfdata(intf, dev);
720
721 retval = usb_register_dev(intf, &ld_usb_class);
722 if (retval) {
723 /* something prevented us from registering this driver */
724 dev_err(&intf->dev, "Not able to get a minor for this device.\n");
725 usb_set_intfdata(intf, NULL);
726 goto error;
727 }
728
729 /* let the user know what node this device is now attached to */
730 dev_info(&intf->dev, "LD USB Device #%d now attached to major %d minor %d\n",
731 (intf->minor - USB_LD_MINOR_BASE), USB_MAJOR, intf->minor);
732
733exit:
734 return retval;
735
736error:
737 ld_usb_delete(dev);
738
739 return retval;
740}
741
742/**
743 * ld_usb_disconnect
744 *
745 * Called by the usb core when the device is removed from the system.
746 */
747static void ld_usb_disconnect(struct usb_interface *intf)
748{
749 struct ld_usb *dev;
750 int minor;
751
Michael Hund2824bd22005-06-27 22:44:22 +0200752 dev = usb_get_intfdata(intf);
753 usb_set_intfdata(intf, NULL);
754
Michael Hund2824bd22005-06-27 22:44:22 +0200755 minor = intf->minor;
756
757 /* give back our minor */
758 usb_deregister_dev(intf, &ld_usb_class);
759
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700760 mutex_lock(&dev->mutex);
Alan Sternd4ead162007-05-22 11:46:41 -0400761
Michael Hund2824bd22005-06-27 22:44:22 +0200762 /* if the device is not opened, then we clean up right now */
763 if (!dev->open_count) {
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700764 mutex_unlock(&dev->mutex);
Michael Hund2824bd22005-06-27 22:44:22 +0200765 ld_usb_delete(dev);
766 } else {
767 dev->intf = NULL;
Oliver Neukumd12b85e2009-07-02 17:01:06 +0200768 /* wake up pollers */
769 wake_up_interruptible_all(&dev->read_wait);
770 wake_up_interruptible_all(&dev->write_wait);
Daniel Walkerce0d7d32008-04-28 10:34:56 -0700771 mutex_unlock(&dev->mutex);
Michael Hund2824bd22005-06-27 22:44:22 +0200772 }
773
Michael Hund2824bd22005-06-27 22:44:22 +0200774 dev_info(&intf->dev, "LD USB Device #%d now disconnected\n",
775 (minor - USB_LD_MINOR_BASE));
776}
777
778/* usb specific object needed to register this driver with the usb subsystem */
779static struct usb_driver ld_usb_driver = {
Michael Hund2824bd22005-06-27 22:44:22 +0200780 .name = "ldusb",
781 .probe = ld_usb_probe,
782 .disconnect = ld_usb_disconnect,
783 .id_table = ld_usb_table,
784};
785
Greg Kroah-Hartman65db4302011-11-18 09:34:02 -0800786module_usb_driver(ld_usb_driver);
Michael Hund2824bd22005-06-27 22:44:22 +0200787