blob: 91d3a94eeaa0130dfea6a057c3a92551e95553c7 [file] [log] [blame]
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -07001/**
2 * drivers/usb/class/usbtmc.c - USB Test & Measurment class driver
3 *
4 * Copyright (C) 2007 Stefan Kopp, Gechingen, Germany
5 * Copyright (C) 2008 Novell, Inc.
6 * Copyright (C) 2008 Greg Kroah-Hartman <gregkh@suse.de>
7 *
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License
10 * as published by the Free Software Foundation; either version 2
11 * of the License, or (at your option) any later version.
12 *
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
17 *
18 * The GNU General Public License is available at
19 * http://www.gnu.org/copyleft/gpl.html.
20 */
21
22#include <linux/init.h>
23#include <linux/module.h>
Ilpo Järvinen857cc4d2008-10-30 13:56:47 +020024#include <linux/kernel.h>
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -070025#include <linux/fs.h>
26#include <linux/uaccess.h>
27#include <linux/kref.h>
28#include <linux/mutex.h>
29#include <linux/usb.h>
30#include <linux/usb/tmc.h>
31
32
33#define USBTMC_MINOR_BASE 176
34
35/*
36 * Size of driver internal IO buffer. Must be multiple of 4 and at least as
37 * large as wMaxPacketSize (which is usually 512 bytes).
38 */
39#define USBTMC_SIZE_IOBUFFER 2048
40
41/* Default USB timeout (in milliseconds) */
42#define USBTMC_TIMEOUT 10
43
44/*
45 * Maximum number of read cycles to empty bulk in endpoint during CLEAR and
46 * ABORT_BULK_IN requests. Ends the loop if (for whatever reason) a short
47 * packet is never read.
48 */
49#define USBTMC_MAX_READS_TO_CLEAR_BULK_IN 100
50
51static struct usb_device_id usbtmc_devices[] = {
52 { USB_INTERFACE_INFO(USB_CLASS_APP_SPEC, 3, 0), },
Greg Kroah-Hartman228dd052009-03-11 13:51:42 -070053 { USB_INTERFACE_INFO(USB_CLASS_APP_SPEC, 3, 1), },
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -070054 { 0, } /* terminating entry */
55};
Greg Kroah-Hartman5413aa42008-12-03 16:33:09 -080056MODULE_DEVICE_TABLE(usb, usbtmc_devices);
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -070057
58/*
59 * This structure is the capabilities for the device
60 * See section 4.2.1.8 of the USBTMC specification for details.
61 */
62struct usbtmc_dev_capabilities {
63 __u8 interface_capabilities;
64 __u8 device_capabilities;
65 __u8 usb488_interface_capabilities;
66 __u8 usb488_device_capabilities;
67};
68
69/* This structure holds private data for each USBTMC device. One copy is
70 * allocated for each USBTMC device in the driver's probe function.
71 */
72struct usbtmc_device_data {
73 const struct usb_device_id *id;
74 struct usb_device *usb_dev;
75 struct usb_interface *intf;
76
77 unsigned int bulk_in;
78 unsigned int bulk_out;
79
80 u8 bTag;
81 u8 bTag_last_write; /* needed for abort */
82 u8 bTag_last_read; /* needed for abort */
83
84 /* attributes from the USB TMC spec for this device */
85 u8 TermChar;
86 bool TermCharEnabled;
87 bool auto_abort;
88
Oliver Neukum86286882009-07-02 11:36:30 +020089 bool zombie; /* fd of disconnected device */
90
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -070091 struct usbtmc_dev_capabilities capabilities;
92 struct kref kref;
93 struct mutex io_mutex; /* only one i/o function running at a time */
94};
95#define to_usbtmc_data(d) container_of(d, struct usbtmc_device_data, kref)
96
97/* Forward declarations */
98static struct usb_driver usbtmc_driver;
99
100static void usbtmc_delete(struct kref *kref)
101{
102 struct usbtmc_device_data *data = to_usbtmc_data(kref);
103
104 usb_put_dev(data->usb_dev);
105 kfree(data);
106}
107
108static int usbtmc_open(struct inode *inode, struct file *filp)
109{
110 struct usb_interface *intf;
111 struct usbtmc_device_data *data;
Greg Kroah-Hartman5b109162009-03-10 20:42:55 -0700112 int retval = 0;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700113
114 intf = usb_find_interface(&usbtmc_driver, iminor(inode));
115 if (!intf) {
116 printk(KERN_ERR KBUILD_MODNAME
117 ": can not find device for minor %d", iminor(inode));
Greg Kroah-Hartman5b109162009-03-10 20:42:55 -0700118 retval = -ENODEV;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700119 goto exit;
120 }
121
122 data = usb_get_intfdata(intf);
123 kref_get(&data->kref);
124
125 /* Store pointer in file structure's private data field */
126 filp->private_data = data;
127
128exit:
129 return retval;
130}
131
132static int usbtmc_release(struct inode *inode, struct file *file)
133{
134 struct usbtmc_device_data *data = file->private_data;
135
136 kref_put(&data->kref, usbtmc_delete);
137 return 0;
138}
139
140static int usbtmc_ioctl_abort_bulk_in(struct usbtmc_device_data *data)
141{
Chris Malleyb361a6e2008-10-25 22:07:32 +0100142 u8 *buffer;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700143 struct device *dev;
144 int rv;
145 int n;
146 int actual;
147 struct usb_host_interface *current_setting;
148 int max_size;
149
150 dev = &data->intf->dev;
151 buffer = kmalloc(USBTMC_SIZE_IOBUFFER, GFP_KERNEL);
152 if (!buffer)
153 return -ENOMEM;
154
155 rv = usb_control_msg(data->usb_dev,
156 usb_rcvctrlpipe(data->usb_dev, 0),
157 USBTMC_REQUEST_INITIATE_ABORT_BULK_IN,
158 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_ENDPOINT,
159 data->bTag_last_read, data->bulk_in,
160 buffer, 2, USBTMC_TIMEOUT);
161
162 if (rv < 0) {
163 dev_err(dev, "usb_control_msg returned %d\n", rv);
164 goto exit;
165 }
166
167 dev_dbg(dev, "INITIATE_ABORT_BULK_IN returned %x\n", buffer[0]);
168
169 if (buffer[0] == USBTMC_STATUS_FAILED) {
170 rv = 0;
171 goto exit;
172 }
173
174 if (buffer[0] != USBTMC_STATUS_SUCCESS) {
175 dev_err(dev, "INITIATE_ABORT_BULK_IN returned %x\n",
176 buffer[0]);
177 rv = -EPERM;
178 goto exit;
179 }
180
181 max_size = 0;
182 current_setting = data->intf->cur_altsetting;
183 for (n = 0; n < current_setting->desc.bNumEndpoints; n++)
184 if (current_setting->endpoint[n].desc.bEndpointAddress ==
185 data->bulk_in)
186 max_size = le16_to_cpu(current_setting->endpoint[n].
187 desc.wMaxPacketSize);
188
189 if (max_size == 0) {
190 dev_err(dev, "Couldn't get wMaxPacketSize\n");
191 rv = -EPERM;
192 goto exit;
193 }
194
195 dev_dbg(&data->intf->dev, "wMaxPacketSize is %d\n", max_size);
196
197 n = 0;
198
199 do {
200 dev_dbg(dev, "Reading from bulk in EP\n");
201
202 rv = usb_bulk_msg(data->usb_dev,
203 usb_rcvbulkpipe(data->usb_dev,
204 data->bulk_in),
205 buffer, USBTMC_SIZE_IOBUFFER,
206 &actual, USBTMC_TIMEOUT);
207
208 n++;
209
210 if (rv < 0) {
211 dev_err(dev, "usb_bulk_msg returned %d\n", rv);
212 goto exit;
213 }
214 } while ((actual == max_size) &&
215 (n < USBTMC_MAX_READS_TO_CLEAR_BULK_IN));
216
217 if (actual == max_size) {
218 dev_err(dev, "Couldn't clear device buffer within %d cycles\n",
219 USBTMC_MAX_READS_TO_CLEAR_BULK_IN);
220 rv = -EPERM;
221 goto exit;
222 }
223
224 n = 0;
225
226usbtmc_abort_bulk_in_status:
227 rv = usb_control_msg(data->usb_dev,
228 usb_rcvctrlpipe(data->usb_dev, 0),
229 USBTMC_REQUEST_CHECK_ABORT_BULK_IN_STATUS,
230 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_ENDPOINT,
231 0, data->bulk_in, buffer, 0x08,
232 USBTMC_TIMEOUT);
233
234 if (rv < 0) {
235 dev_err(dev, "usb_control_msg returned %d\n", rv);
236 goto exit;
237 }
238
239 dev_dbg(dev, "INITIATE_ABORT_BULK_IN returned %x\n", buffer[0]);
240
241 if (buffer[0] == USBTMC_STATUS_SUCCESS) {
242 rv = 0;
243 goto exit;
244 }
245
246 if (buffer[0] != USBTMC_STATUS_PENDING) {
247 dev_err(dev, "INITIATE_ABORT_BULK_IN returned %x\n", buffer[0]);
248 rv = -EPERM;
249 goto exit;
250 }
251
252 if (buffer[1] == 1)
253 do {
254 dev_dbg(dev, "Reading from bulk in EP\n");
255
256 rv = usb_bulk_msg(data->usb_dev,
257 usb_rcvbulkpipe(data->usb_dev,
258 data->bulk_in),
259 buffer, USBTMC_SIZE_IOBUFFER,
260 &actual, USBTMC_TIMEOUT);
261
262 n++;
263
264 if (rv < 0) {
265 dev_err(dev, "usb_bulk_msg returned %d\n", rv);
266 goto exit;
267 }
268 } while ((actual = max_size) &&
269 (n < USBTMC_MAX_READS_TO_CLEAR_BULK_IN));
270
271 if (actual == max_size) {
272 dev_err(dev, "Couldn't clear device buffer within %d cycles\n",
273 USBTMC_MAX_READS_TO_CLEAR_BULK_IN);
274 rv = -EPERM;
275 goto exit;
276 }
277
278 goto usbtmc_abort_bulk_in_status;
279
280exit:
281 kfree(buffer);
282 return rv;
283
284}
285
286static int usbtmc_ioctl_abort_bulk_out(struct usbtmc_device_data *data)
287{
288 struct device *dev;
289 u8 *buffer;
290 int rv;
291 int n;
292
293 dev = &data->intf->dev;
294
295 buffer = kmalloc(8, GFP_KERNEL);
296 if (!buffer)
297 return -ENOMEM;
298
299 rv = usb_control_msg(data->usb_dev,
300 usb_rcvctrlpipe(data->usb_dev, 0),
301 USBTMC_REQUEST_INITIATE_ABORT_BULK_OUT,
302 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_ENDPOINT,
303 data->bTag_last_write, data->bulk_out,
304 buffer, 2, USBTMC_TIMEOUT);
305
306 if (rv < 0) {
307 dev_err(dev, "usb_control_msg returned %d\n", rv);
308 goto exit;
309 }
310
311 dev_dbg(dev, "INITIATE_ABORT_BULK_OUT returned %x\n", buffer[0]);
312
313 if (buffer[0] != USBTMC_STATUS_SUCCESS) {
314 dev_err(dev, "INITIATE_ABORT_BULK_OUT returned %x\n",
315 buffer[0]);
316 rv = -EPERM;
317 goto exit;
318 }
319
320 n = 0;
321
322usbtmc_abort_bulk_out_check_status:
323 rv = usb_control_msg(data->usb_dev,
324 usb_rcvctrlpipe(data->usb_dev, 0),
325 USBTMC_REQUEST_CHECK_ABORT_BULK_OUT_STATUS,
326 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_ENDPOINT,
327 0, data->bulk_out, buffer, 0x08,
328 USBTMC_TIMEOUT);
329 n++;
330 if (rv < 0) {
331 dev_err(dev, "usb_control_msg returned %d\n", rv);
332 goto exit;
333 }
334
335 dev_dbg(dev, "CHECK_ABORT_BULK_OUT returned %x\n", buffer[0]);
336
337 if (buffer[0] == USBTMC_STATUS_SUCCESS)
338 goto usbtmc_abort_bulk_out_clear_halt;
339
340 if ((buffer[0] == USBTMC_STATUS_PENDING) &&
341 (n < USBTMC_MAX_READS_TO_CLEAR_BULK_IN))
342 goto usbtmc_abort_bulk_out_check_status;
343
344 rv = -EPERM;
345 goto exit;
346
347usbtmc_abort_bulk_out_clear_halt:
348 rv = usb_control_msg(data->usb_dev,
349 usb_sndctrlpipe(data->usb_dev, 0),
350 USB_REQ_CLEAR_FEATURE,
351 USB_DIR_OUT | USB_TYPE_STANDARD |
352 USB_RECIP_ENDPOINT,
353 USB_ENDPOINT_HALT, data->bulk_out, buffer,
354 0, USBTMC_TIMEOUT);
355
356 if (rv < 0) {
357 dev_err(dev, "usb_control_msg returned %d\n", rv);
358 goto exit;
359 }
360 rv = 0;
361
362exit:
363 kfree(buffer);
364 return rv;
365}
366
367static ssize_t usbtmc_read(struct file *filp, char __user *buf,
368 size_t count, loff_t *f_pos)
369{
370 struct usbtmc_device_data *data;
371 struct device *dev;
Guus Sliepen665d7662009-07-22 17:39:42 +0200372 u32 n_characters;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700373 u8 *buffer;
374 int actual;
Guus Sliepen665d7662009-07-22 17:39:42 +0200375 size_t done;
376 size_t remaining;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700377 int retval;
Guus Sliepen665d7662009-07-22 17:39:42 +0200378 size_t this_part;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700379
380 /* Get pointer to private data structure */
381 data = filp->private_data;
382 dev = &data->intf->dev;
383
384 buffer = kmalloc(USBTMC_SIZE_IOBUFFER, GFP_KERNEL);
385 if (!buffer)
386 return -ENOMEM;
387
388 mutex_lock(&data->io_mutex);
Oliver Neukum86286882009-07-02 11:36:30 +0200389 if (data->zombie) {
390 retval = -ENODEV;
391 goto exit;
392 }
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700393
394 remaining = count;
395 done = 0;
396
397 while (remaining > 0) {
398 if (remaining > USBTMC_SIZE_IOBUFFER - 12 - 3)
399 this_part = USBTMC_SIZE_IOBUFFER - 12 - 3;
400 else
401 this_part = remaining;
402
403 /* Setup IO buffer for DEV_DEP_MSG_IN message
404 * Refer to class specs for details
405 */
406 buffer[0] = 2;
407 buffer[1] = data->bTag;
408 buffer[2] = ~(data->bTag);
409 buffer[3] = 0; /* Reserved */
Steve Hollandc2cd26e2009-06-18 17:37:49 -0500410 buffer[4] = (this_part) & 255;
411 buffer[5] = ((this_part) >> 8) & 255;
412 buffer[6] = ((this_part) >> 16) & 255;
413 buffer[7] = ((this_part) >> 24) & 255;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700414 buffer[8] = data->TermCharEnabled * 2;
415 /* Use term character? */
416 buffer[9] = data->TermChar;
417 buffer[10] = 0; /* Reserved */
418 buffer[11] = 0; /* Reserved */
419
420 /* Send bulk URB */
421 retval = usb_bulk_msg(data->usb_dev,
422 usb_sndbulkpipe(data->usb_dev,
423 data->bulk_out),
424 buffer, 12, &actual, USBTMC_TIMEOUT);
425
426 /* Store bTag (in case we need to abort) */
427 data->bTag_last_write = data->bTag;
428
429 /* Increment bTag -- and increment again if zero */
430 data->bTag++;
431 if (!data->bTag)
432 (data->bTag)++;
433
434 if (retval < 0) {
435 dev_err(dev, "usb_bulk_msg returned %d\n", retval);
436 if (data->auto_abort)
437 usbtmc_ioctl_abort_bulk_out(data);
438 goto exit;
439 }
440
441 /* Send bulk URB */
442 retval = usb_bulk_msg(data->usb_dev,
443 usb_rcvbulkpipe(data->usb_dev,
444 data->bulk_in),
445 buffer, USBTMC_SIZE_IOBUFFER, &actual,
446 USBTMC_TIMEOUT);
447
448 /* Store bTag (in case we need to abort) */
449 data->bTag_last_read = data->bTag;
450
451 if (retval < 0) {
452 dev_err(dev, "Unable to read data, error %d\n", retval);
453 if (data->auto_abort)
454 usbtmc_ioctl_abort_bulk_in(data);
455 goto exit;
456 }
457
458 /* How many characters did the instrument send? */
459 n_characters = buffer[4] +
460 (buffer[5] << 8) +
461 (buffer[6] << 16) +
462 (buffer[7] << 24);
463
Guus Sliepen665d7662009-07-22 17:39:42 +0200464 /* Ensure the instrument doesn't lie about it */
465 if(n_characters > actual - 12) {
Randy Dunlapa2fbf102009-07-28 11:22:41 -0700466 dev_err(dev, "Device lies about message size: %u > %d\n", n_characters, actual - 12);
Guus Sliepen665d7662009-07-22 17:39:42 +0200467 n_characters = actual - 12;
468 }
469
470 /* Ensure the instrument doesn't send more back than requested */
471 if(n_characters > this_part) {
472 dev_err(dev, "Device returns more than requested: %zu > %zu\n", done + n_characters, done + this_part);
473 n_characters = this_part;
474 }
475
Steve Holland92d07e422009-06-18 17:37:49 -0500476 /* Bound amount of data received by amount of data requested */
477 if (n_characters > this_part)
478 n_characters = this_part;
479
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700480 /* Copy buffer to user space */
481 if (copy_to_user(buf + done, &buffer[12], n_characters)) {
482 /* There must have been an addressing problem */
483 retval = -EFAULT;
484 goto exit;
485 }
486
487 done += n_characters;
488 if (n_characters < USBTMC_SIZE_IOBUFFER)
489 remaining = 0;
Guus Sliepen665d7662009-07-22 17:39:42 +0200490 else
491 remaining -= n_characters;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700492 }
493
494 /* Update file position value */
495 *f_pos = *f_pos + done;
496 retval = done;
497
498exit:
499 mutex_unlock(&data->io_mutex);
500 kfree(buffer);
501 return retval;
502}
503
504static ssize_t usbtmc_write(struct file *filp, const char __user *buf,
505 size_t count, loff_t *f_pos)
506{
507 struct usbtmc_device_data *data;
508 u8 *buffer;
509 int retval;
510 int actual;
511 unsigned long int n_bytes;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700512 int remaining;
513 int done;
514 int this_part;
515
516 data = filp->private_data;
517
518 buffer = kmalloc(USBTMC_SIZE_IOBUFFER, GFP_KERNEL);
519 if (!buffer)
520 return -ENOMEM;
521
522 mutex_lock(&data->io_mutex);
Oliver Neukum86286882009-07-02 11:36:30 +0200523 if (data->zombie) {
524 retval = -ENODEV;
525 goto exit;
526 }
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700527
528 remaining = count;
529 done = 0;
530
531 while (remaining > 0) {
532 if (remaining > USBTMC_SIZE_IOBUFFER - 12) {
533 this_part = USBTMC_SIZE_IOBUFFER - 12;
534 buffer[8] = 0;
535 } else {
536 this_part = remaining;
537 buffer[8] = 1;
538 }
539
540 /* Setup IO buffer for DEV_DEP_MSG_OUT message */
541 buffer[0] = 1;
542 buffer[1] = data->bTag;
543 buffer[2] = ~(data->bTag);
544 buffer[3] = 0; /* Reserved */
545 buffer[4] = this_part & 255;
546 buffer[5] = (this_part >> 8) & 255;
547 buffer[6] = (this_part >> 16) & 255;
548 buffer[7] = (this_part >> 24) & 255;
549 /* buffer[8] is set above... */
550 buffer[9] = 0; /* Reserved */
551 buffer[10] = 0; /* Reserved */
552 buffer[11] = 0; /* Reserved */
553
554 if (copy_from_user(&buffer[12], buf + done, this_part)) {
555 retval = -EFAULT;
556 goto exit;
557 }
558
Ilpo Järvinen857cc4d2008-10-30 13:56:47 +0200559 n_bytes = roundup(12 + this_part, 4);
560 memset(buffer + 12 + this_part, 0, n_bytes - (12 + this_part));
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700561
562 retval = usb_bulk_msg(data->usb_dev,
563 usb_sndbulkpipe(data->usb_dev,
564 data->bulk_out),
565 buffer, n_bytes, &actual, USBTMC_TIMEOUT);
566
567 data->bTag_last_write = data->bTag;
568 data->bTag++;
569
570 if (!data->bTag)
571 data->bTag++;
572
573 if (retval < 0) {
574 dev_err(&data->intf->dev,
575 "Unable to send data, error %d\n", retval);
576 if (data->auto_abort)
577 usbtmc_ioctl_abort_bulk_out(data);
578 goto exit;
579 }
580
581 remaining -= this_part;
582 done += this_part;
583 }
584
585 retval = count;
586exit:
587 mutex_unlock(&data->io_mutex);
588 kfree(buffer);
589 return retval;
590}
591
592static int usbtmc_ioctl_clear(struct usbtmc_device_data *data)
593{
594 struct usb_host_interface *current_setting;
595 struct usb_endpoint_descriptor *desc;
596 struct device *dev;
597 u8 *buffer;
598 int rv;
599 int n;
600 int actual;
601 int max_size;
602
603 dev = &data->intf->dev;
604
605 dev_dbg(dev, "Sending INITIATE_CLEAR request\n");
606
607 buffer = kmalloc(USBTMC_SIZE_IOBUFFER, GFP_KERNEL);
608 if (!buffer)
609 return -ENOMEM;
610
611 rv = usb_control_msg(data->usb_dev,
612 usb_rcvctrlpipe(data->usb_dev, 0),
613 USBTMC_REQUEST_INITIATE_CLEAR,
614 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE,
615 0, 0, buffer, 1, USBTMC_TIMEOUT);
616 if (rv < 0) {
617 dev_err(dev, "usb_control_msg returned %d\n", rv);
618 goto exit;
619 }
620
621 dev_dbg(dev, "INITIATE_CLEAR returned %x\n", buffer[0]);
622
623 if (buffer[0] != USBTMC_STATUS_SUCCESS) {
624 dev_err(dev, "INITIATE_CLEAR returned %x\n", buffer[0]);
625 rv = -EPERM;
626 goto exit;
627 }
628
629 max_size = 0;
630 current_setting = data->intf->cur_altsetting;
631 for (n = 0; n < current_setting->desc.bNumEndpoints; n++) {
632 desc = &current_setting->endpoint[n].desc;
633 if (desc->bEndpointAddress == data->bulk_in)
634 max_size = le16_to_cpu(desc->wMaxPacketSize);
635 }
636
637 if (max_size == 0) {
638 dev_err(dev, "Couldn't get wMaxPacketSize\n");
639 rv = -EPERM;
640 goto exit;
641 }
642
643 dev_dbg(dev, "wMaxPacketSize is %d\n", max_size);
644
645 n = 0;
646
647usbtmc_clear_check_status:
648
649 dev_dbg(dev, "Sending CHECK_CLEAR_STATUS request\n");
650
651 rv = usb_control_msg(data->usb_dev,
652 usb_rcvctrlpipe(data->usb_dev, 0),
653 USBTMC_REQUEST_CHECK_CLEAR_STATUS,
654 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE,
655 0, 0, buffer, 2, USBTMC_TIMEOUT);
656 if (rv < 0) {
657 dev_err(dev, "usb_control_msg returned %d\n", rv);
658 goto exit;
659 }
660
661 dev_dbg(dev, "CHECK_CLEAR_STATUS returned %x\n", buffer[0]);
662
663 if (buffer[0] == USBTMC_STATUS_SUCCESS)
664 goto usbtmc_clear_bulk_out_halt;
665
666 if (buffer[0] != USBTMC_STATUS_PENDING) {
667 dev_err(dev, "CHECK_CLEAR_STATUS returned %x\n", buffer[0]);
668 rv = -EPERM;
669 goto exit;
670 }
671
672 if (buffer[1] == 1)
673 do {
674 dev_dbg(dev, "Reading from bulk in EP\n");
675
676 rv = usb_bulk_msg(data->usb_dev,
677 usb_rcvbulkpipe(data->usb_dev,
678 data->bulk_in),
679 buffer, USBTMC_SIZE_IOBUFFER,
680 &actual, USBTMC_TIMEOUT);
681 n++;
682
683 if (rv < 0) {
684 dev_err(dev, "usb_control_msg returned %d\n",
685 rv);
686 goto exit;
687 }
688 } while ((actual == max_size) &&
689 (n < USBTMC_MAX_READS_TO_CLEAR_BULK_IN));
690
691 if (actual == max_size) {
692 dev_err(dev, "Couldn't clear device buffer within %d cycles\n",
693 USBTMC_MAX_READS_TO_CLEAR_BULK_IN);
694 rv = -EPERM;
695 goto exit;
696 }
697
698 goto usbtmc_clear_check_status;
699
700usbtmc_clear_bulk_out_halt:
701
702 rv = usb_control_msg(data->usb_dev,
703 usb_sndctrlpipe(data->usb_dev, 0),
704 USB_REQ_CLEAR_FEATURE,
705 USB_DIR_OUT | USB_TYPE_STANDARD |
706 USB_RECIP_ENDPOINT,
707 USB_ENDPOINT_HALT,
708 data->bulk_out, buffer, 0,
709 USBTMC_TIMEOUT);
710 if (rv < 0) {
711 dev_err(dev, "usb_control_msg returned %d\n", rv);
712 goto exit;
713 }
714 rv = 0;
715
716exit:
717 kfree(buffer);
718 return rv;
719}
720
721static int usbtmc_ioctl_clear_out_halt(struct usbtmc_device_data *data)
722{
723 u8 *buffer;
724 int rv;
725
726 buffer = kmalloc(2, GFP_KERNEL);
727 if (!buffer)
728 return -ENOMEM;
729
730 rv = usb_control_msg(data->usb_dev,
731 usb_sndctrlpipe(data->usb_dev, 0),
732 USB_REQ_CLEAR_FEATURE,
733 USB_DIR_OUT | USB_TYPE_STANDARD |
734 USB_RECIP_ENDPOINT,
735 USB_ENDPOINT_HALT, data->bulk_out,
736 buffer, 0, USBTMC_TIMEOUT);
737
738 if (rv < 0) {
739 dev_err(&data->usb_dev->dev, "usb_control_msg returned %d\n",
740 rv);
741 goto exit;
742 }
743 rv = 0;
744
745exit:
746 kfree(buffer);
747 return rv;
748}
749
750static int usbtmc_ioctl_clear_in_halt(struct usbtmc_device_data *data)
751{
752 u8 *buffer;
753 int rv;
754
755 buffer = kmalloc(2, GFP_KERNEL);
756 if (!buffer)
757 return -ENOMEM;
758
759 rv = usb_control_msg(data->usb_dev, usb_sndctrlpipe(data->usb_dev, 0),
760 USB_REQ_CLEAR_FEATURE,
761 USB_DIR_OUT | USB_TYPE_STANDARD |
762 USB_RECIP_ENDPOINT,
763 USB_ENDPOINT_HALT, data->bulk_in, buffer, 0,
764 USBTMC_TIMEOUT);
765
766 if (rv < 0) {
767 dev_err(&data->usb_dev->dev, "usb_control_msg returned %d\n",
768 rv);
769 goto exit;
770 }
771 rv = 0;
772
773exit:
774 kfree(buffer);
775 return rv;
776}
777
778static int get_capabilities(struct usbtmc_device_data *data)
779{
780 struct device *dev = &data->usb_dev->dev;
781 char *buffer;
Oliver Neukumca157c42009-07-02 16:41:39 +0200782 int rv = 0;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700783
784 buffer = kmalloc(0x18, GFP_KERNEL);
785 if (!buffer)
786 return -ENOMEM;
787
788 rv = usb_control_msg(data->usb_dev, usb_rcvctrlpipe(data->usb_dev, 0),
789 USBTMC_REQUEST_GET_CAPABILITIES,
790 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE,
791 0, 0, buffer, 0x18, USBTMC_TIMEOUT);
792 if (rv < 0) {
793 dev_err(dev, "usb_control_msg returned %d\n", rv);
Oliver Neukumca157c42009-07-02 16:41:39 +0200794 goto err_out;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700795 }
796
797 dev_dbg(dev, "GET_CAPABILITIES returned %x\n", buffer[0]);
798 dev_dbg(dev, "Interface capabilities are %x\n", buffer[4]);
799 dev_dbg(dev, "Device capabilities are %x\n", buffer[5]);
800 dev_dbg(dev, "USB488 interface capabilities are %x\n", buffer[14]);
801 dev_dbg(dev, "USB488 device capabilities are %x\n", buffer[15]);
802 if (buffer[0] != USBTMC_STATUS_SUCCESS) {
803 dev_err(dev, "GET_CAPABILITIES returned %x\n", buffer[0]);
Oliver Neukumca157c42009-07-02 16:41:39 +0200804 rv = -EPERM;
805 goto err_out;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700806 }
807
808 data->capabilities.interface_capabilities = buffer[4];
809 data->capabilities.device_capabilities = buffer[5];
810 data->capabilities.usb488_interface_capabilities = buffer[14];
811 data->capabilities.usb488_device_capabilities = buffer[15];
812
Oliver Neukumca157c42009-07-02 16:41:39 +0200813err_out:
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700814 kfree(buffer);
Oliver Neukumca157c42009-07-02 16:41:39 +0200815 return rv;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700816}
817
818#define capability_attribute(name) \
819static ssize_t show_##name(struct device *dev, \
820 struct device_attribute *attr, char *buf) \
821{ \
822 struct usb_interface *intf = to_usb_interface(dev); \
823 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
824 \
825 return sprintf(buf, "%d\n", data->capabilities.name); \
826} \
827static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL)
828
829capability_attribute(interface_capabilities);
830capability_attribute(device_capabilities);
831capability_attribute(usb488_interface_capabilities);
832capability_attribute(usb488_device_capabilities);
833
834static struct attribute *capability_attrs[] = {
835 &dev_attr_interface_capabilities.attr,
836 &dev_attr_device_capabilities.attr,
837 &dev_attr_usb488_interface_capabilities.attr,
838 &dev_attr_usb488_device_capabilities.attr,
839 NULL,
840};
841
842static struct attribute_group capability_attr_grp = {
843 .attrs = capability_attrs,
844};
845
846static ssize_t show_TermChar(struct device *dev,
847 struct device_attribute *attr, char *buf)
848{
849 struct usb_interface *intf = to_usb_interface(dev);
850 struct usbtmc_device_data *data = usb_get_intfdata(intf);
851
852 return sprintf(buf, "%c\n", data->TermChar);
853}
854
855static ssize_t store_TermChar(struct device *dev,
856 struct device_attribute *attr,
857 const char *buf, size_t count)
858{
859 struct usb_interface *intf = to_usb_interface(dev);
860 struct usbtmc_device_data *data = usb_get_intfdata(intf);
861
862 if (count < 1)
863 return -EINVAL;
864 data->TermChar = buf[0];
865 return count;
866}
867static DEVICE_ATTR(TermChar, S_IRUGO, show_TermChar, store_TermChar);
868
869#define data_attribute(name) \
870static ssize_t show_##name(struct device *dev, \
871 struct device_attribute *attr, char *buf) \
872{ \
873 struct usb_interface *intf = to_usb_interface(dev); \
874 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
875 \
876 return sprintf(buf, "%d\n", data->name); \
877} \
878static ssize_t store_##name(struct device *dev, \
879 struct device_attribute *attr, \
880 const char *buf, size_t count) \
881{ \
882 struct usb_interface *intf = to_usb_interface(dev); \
883 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
884 ssize_t result; \
885 unsigned val; \
886 \
887 result = sscanf(buf, "%u\n", &val); \
888 if (result != 1) \
889 result = -EINVAL; \
890 data->name = val; \
891 if (result < 0) \
892 return result; \
893 else \
894 return count; \
895} \
896static DEVICE_ATTR(name, S_IRUGO, show_##name, store_##name)
897
898data_attribute(TermCharEnabled);
899data_attribute(auto_abort);
900
901static struct attribute *data_attrs[] = {
902 &dev_attr_TermChar.attr,
903 &dev_attr_TermCharEnabled.attr,
904 &dev_attr_auto_abort.attr,
905 NULL,
906};
907
908static struct attribute_group data_attr_grp = {
909 .attrs = data_attrs,
910};
911
912static int usbtmc_ioctl_indicator_pulse(struct usbtmc_device_data *data)
913{
914 struct device *dev;
915 u8 *buffer;
916 int rv;
917
918 dev = &data->intf->dev;
919
920 buffer = kmalloc(2, GFP_KERNEL);
921 if (!buffer)
922 return -ENOMEM;
923
924 rv = usb_control_msg(data->usb_dev,
925 usb_rcvctrlpipe(data->usb_dev, 0),
926 USBTMC_REQUEST_INDICATOR_PULSE,
927 USB_DIR_IN | USB_TYPE_CLASS | USB_RECIP_INTERFACE,
928 0, 0, buffer, 0x01, USBTMC_TIMEOUT);
929
930 if (rv < 0) {
931 dev_err(dev, "usb_control_msg returned %d\n", rv);
932 goto exit;
933 }
934
935 dev_dbg(dev, "INDICATOR_PULSE returned %x\n", buffer[0]);
936
937 if (buffer[0] != USBTMC_STATUS_SUCCESS) {
938 dev_err(dev, "INDICATOR_PULSE returned %x\n", buffer[0]);
939 rv = -EPERM;
940 goto exit;
941 }
942 rv = 0;
943
944exit:
945 kfree(buffer);
946 return rv;
947}
948
949static long usbtmc_ioctl(struct file *file, unsigned int cmd, unsigned long arg)
950{
951 struct usbtmc_device_data *data;
952 int retval = -EBADRQC;
953
954 data = file->private_data;
955 mutex_lock(&data->io_mutex);
Oliver Neukum86286882009-07-02 11:36:30 +0200956 if (data->zombie) {
957 retval = -ENODEV;
958 goto skip_io_on_zombie;
959 }
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700960
961 switch (cmd) {
962 case USBTMC_IOCTL_CLEAR_OUT_HALT:
963 retval = usbtmc_ioctl_clear_out_halt(data);
Greg Kroah-Hartmana92b63e2009-06-15 13:13:05 -0700964 break;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700965
966 case USBTMC_IOCTL_CLEAR_IN_HALT:
967 retval = usbtmc_ioctl_clear_in_halt(data);
Greg Kroah-Hartmana92b63e2009-06-15 13:13:05 -0700968 break;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700969
970 case USBTMC_IOCTL_INDICATOR_PULSE:
971 retval = usbtmc_ioctl_indicator_pulse(data);
Greg Kroah-Hartmana92b63e2009-06-15 13:13:05 -0700972 break;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700973
974 case USBTMC_IOCTL_CLEAR:
975 retval = usbtmc_ioctl_clear(data);
Greg Kroah-Hartmana92b63e2009-06-15 13:13:05 -0700976 break;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700977
978 case USBTMC_IOCTL_ABORT_BULK_OUT:
979 retval = usbtmc_ioctl_abort_bulk_out(data);
Greg Kroah-Hartmana92b63e2009-06-15 13:13:05 -0700980 break;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700981
982 case USBTMC_IOCTL_ABORT_BULK_IN:
983 retval = usbtmc_ioctl_abort_bulk_in(data);
Greg Kroah-Hartmana92b63e2009-06-15 13:13:05 -0700984 break;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700985 }
986
Oliver Neukum86286882009-07-02 11:36:30 +0200987skip_io_on_zombie:
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -0700988 mutex_unlock(&data->io_mutex);
989 return retval;
990}
991
992static struct file_operations fops = {
993 .owner = THIS_MODULE,
994 .read = usbtmc_read,
995 .write = usbtmc_write,
996 .open = usbtmc_open,
997 .release = usbtmc_release,
998 .unlocked_ioctl = usbtmc_ioctl,
999};
1000
1001static struct usb_class_driver usbtmc_class = {
1002 .name = "usbtmc%d",
1003 .fops = &fops,
1004 .minor_base = USBTMC_MINOR_BASE,
1005};
1006
1007
1008static int usbtmc_probe(struct usb_interface *intf,
1009 const struct usb_device_id *id)
1010{
1011 struct usbtmc_device_data *data;
1012 struct usb_host_interface *iface_desc;
1013 struct usb_endpoint_descriptor *endpoint;
1014 int n;
1015 int retcode;
1016
1017 dev_dbg(&intf->dev, "%s called\n", __func__);
1018
1019 data = kmalloc(sizeof(struct usbtmc_device_data), GFP_KERNEL);
1020 if (!data) {
1021 dev_err(&intf->dev, "Unable to allocate kernel memory\n");
1022 return -ENOMEM;
1023 }
1024
1025 data->intf = intf;
1026 data->id = id;
1027 data->usb_dev = usb_get_dev(interface_to_usbdev(intf));
1028 usb_set_intfdata(intf, data);
1029 kref_init(&data->kref);
1030 mutex_init(&data->io_mutex);
Oliver Neukum86286882009-07-02 11:36:30 +02001031 data->zombie = 0;
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -07001032
1033 /* Initialize USBTMC bTag and other fields */
1034 data->bTag = 1;
1035 data->TermCharEnabled = 0;
1036 data->TermChar = '\n';
1037
1038 /* USBTMC devices have only one setting, so use that */
1039 iface_desc = data->intf->cur_altsetting;
1040
1041 /* Find bulk in endpoint */
1042 for (n = 0; n < iface_desc->desc.bNumEndpoints; n++) {
1043 endpoint = &iface_desc->endpoint[n].desc;
1044
1045 if (usb_endpoint_is_bulk_in(endpoint)) {
1046 data->bulk_in = endpoint->bEndpointAddress;
1047 dev_dbg(&intf->dev, "Found bulk in endpoint at %u\n",
1048 data->bulk_in);
1049 break;
1050 }
1051 }
1052
1053 /* Find bulk out endpoint */
1054 for (n = 0; n < iface_desc->desc.bNumEndpoints; n++) {
1055 endpoint = &iface_desc->endpoint[n].desc;
1056
1057 if (usb_endpoint_is_bulk_out(endpoint)) {
1058 data->bulk_out = endpoint->bEndpointAddress;
1059 dev_dbg(&intf->dev, "Found Bulk out endpoint at %u\n",
1060 data->bulk_out);
1061 break;
1062 }
1063 }
1064
1065 retcode = get_capabilities(data);
1066 if (retcode)
1067 dev_err(&intf->dev, "can't read capabilities\n");
1068 else
1069 retcode = sysfs_create_group(&intf->dev.kobj,
1070 &capability_attr_grp);
1071
1072 retcode = sysfs_create_group(&intf->dev.kobj, &data_attr_grp);
1073
1074 retcode = usb_register_dev(intf, &usbtmc_class);
1075 if (retcode) {
1076 dev_err(&intf->dev, "Not able to get a minor"
1077 " (base %u, slice default): %d\n", USBTMC_MINOR_BASE,
1078 retcode);
1079 goto error_register;
1080 }
1081 dev_dbg(&intf->dev, "Using minor number %d\n", intf->minor);
1082
1083 return 0;
1084
1085error_register:
1086 sysfs_remove_group(&intf->dev.kobj, &capability_attr_grp);
1087 sysfs_remove_group(&intf->dev.kobj, &data_attr_grp);
1088 kref_put(&data->kref, usbtmc_delete);
1089 return retcode;
1090}
1091
1092static void usbtmc_disconnect(struct usb_interface *intf)
1093{
1094 struct usbtmc_device_data *data;
1095
1096 dev_dbg(&intf->dev, "usbtmc_disconnect called\n");
1097
1098 data = usb_get_intfdata(intf);
1099 usb_deregister_dev(intf, &usbtmc_class);
1100 sysfs_remove_group(&intf->dev.kobj, &capability_attr_grp);
1101 sysfs_remove_group(&intf->dev.kobj, &data_attr_grp);
Oliver Neukum86286882009-07-02 11:36:30 +02001102 mutex_lock(&data->io_mutex);
1103 data->zombie = 1;
1104 mutex_unlock(&data->io_mutex);
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -07001105 kref_put(&data->kref, usbtmc_delete);
1106}
1107
Oliver Neukuma4708102009-07-02 11:44:33 +02001108static int usbtmc_suspend (struct usb_interface *intf, pm_message_t message)
1109{
1110 /* this driver does not have pending URBs */
1111 return 0;
1112}
1113
1114static int usbtmc_resume (struct usb_interface *intf)
1115{
1116 return 0;
1117}
1118
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -07001119static struct usb_driver usbtmc_driver = {
1120 .name = "usbtmc",
1121 .id_table = usbtmc_devices,
1122 .probe = usbtmc_probe,
Oliver Neukuma4708102009-07-02 11:44:33 +02001123 .disconnect = usbtmc_disconnect,
1124 .suspend = usbtmc_suspend,
1125 .resume = usbtmc_resume,
Greg Kroah-Hartman5b775f62008-08-26 16:22:06 -07001126};
1127
1128static int __init usbtmc_init(void)
1129{
1130 int retcode;
1131
1132 retcode = usb_register(&usbtmc_driver);
1133 if (retcode)
1134 printk(KERN_ERR KBUILD_MODNAME": Unable to register driver\n");
1135 return retcode;
1136}
1137module_init(usbtmc_init);
1138
1139static void __exit usbtmc_exit(void)
1140{
1141 usb_deregister(&usbtmc_driver);
1142}
1143module_exit(usbtmc_exit);
1144
1145MODULE_LICENSE("GPL");