2 * drivers/usb/class/usbtmc.c - USB Test & Measurement class driver
4 * Copyright (C) 2007 Stefan Kopp, Gechingen, Germany
5 * Copyright (C) 2008 Novell, Inc.
6 * Copyright (C) 2008 Greg Kroah-Hartman <gregkh@suse.de>
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.
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.
18 * The GNU General Public License is available at
19 * http://www.gnu.org/copyleft/gpl.html.
22 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
24 #include <linux/module.h>
25 #include <linux/kernel.h>
27 #include <linux/uaccess.h>
28 #include <linux/kref.h>
29 #include <linux/slab.h>
30 #include <linux/mutex.h>
31 #include <linux/usb.h>
32 #include <linux/usb/tmc.h>
36 #define USBTMC_HEADER_SIZE 12
37 #define USBTMC_MINOR_BASE 176
40 * Size of driver internal IO buffer. Must be multiple of 4 and at least as
41 * large as wMaxPacketSize (which is usually 512 bytes).
43 #define USBTMC_SIZE_IOBUFFER 2048
45 /* Default USB timeout (in milliseconds) */
46 #define USBTMC_TIMEOUT 5000
49 * Maximum number of read cycles to empty bulk in endpoint during CLEAR and
50 * ABORT_BULK_IN requests. Ends the loop if (for whatever reason) a short
51 * packet is never read.
53 #define USBTMC_MAX_READS_TO_CLEAR_BULK_IN 100
55 static const struct usb_device_id usbtmc_devices
[] = {
56 { USB_INTERFACE_INFO(USB_CLASS_APP_SPEC
, 3, 0), },
57 { USB_INTERFACE_INFO(USB_CLASS_APP_SPEC
, 3, 1), },
58 { 0, } /* terminating entry */
60 MODULE_DEVICE_TABLE(usb
, usbtmc_devices
);
63 * This structure is the capabilities for the device
64 * See section 4.2.1.8 of the USBTMC specification,
65 * and section 4.2.2 of the USBTMC usb488 subclass
66 * specification for details.
68 struct usbtmc_dev_capabilities
{
69 __u8 interface_capabilities
;
70 __u8 device_capabilities
;
71 __u8 usb488_interface_capabilities
;
72 __u8 usb488_device_capabilities
;
75 /* This structure holds private data for each USBTMC device. One copy is
76 * allocated for each USBTMC device in the driver's probe function.
78 struct usbtmc_device_data
{
79 const struct usb_device_id
*id
;
80 struct usb_device
*usb_dev
;
81 struct usb_interface
*intf
;
84 unsigned int bulk_out
;
87 u8 bTag_last_write
; /* needed for abort */
88 u8 bTag_last_read
; /* needed for abort */
92 /* attributes from the USB TMC spec for this device */
97 bool zombie
; /* fd of disconnected device */
99 struct usbtmc_dev_capabilities capabilities
;
101 struct mutex io_mutex
; /* only one i/o function running at a time */
103 #define to_usbtmc_data(d) container_of(d, struct usbtmc_device_data, kref)
105 struct usbtmc_ID_rigol_quirk
{
110 static const struct usbtmc_ID_rigol_quirk usbtmc_id_quirk
[] = {
115 /* Forward declarations */
116 static struct usb_driver usbtmc_driver
;
118 static void usbtmc_delete(struct kref
*kref
)
120 struct usbtmc_device_data
*data
= to_usbtmc_data(kref
);
122 usb_put_dev(data
->usb_dev
);
125 static int usbtmc_open(struct inode
*inode
, struct file
*filp
)
127 struct usb_interface
*intf
;
128 struct usbtmc_device_data
*data
;
131 intf
= usb_find_interface(&usbtmc_driver
, iminor(inode
));
133 pr_err("can not find device for minor %d", iminor(inode
));
137 data
= usb_get_intfdata(intf
);
138 kref_get(&data
->kref
);
140 /* Store pointer in file structure's private data field */
141 filp
->private_data
= data
;
146 static int usbtmc_release(struct inode
*inode
, struct file
*file
)
148 struct usbtmc_device_data
*data
= file
->private_data
;
150 kref_put(&data
->kref
, usbtmc_delete
);
154 static int usbtmc_ioctl_abort_bulk_in(struct usbtmc_device_data
*data
)
161 struct usb_host_interface
*current_setting
;
164 dev
= &data
->intf
->dev
;
165 buffer
= kmalloc(USBTMC_SIZE_IOBUFFER
, GFP_KERNEL
);
169 rv
= usb_control_msg(data
->usb_dev
,
170 usb_rcvctrlpipe(data
->usb_dev
, 0),
171 USBTMC_REQUEST_INITIATE_ABORT_BULK_IN
,
172 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_ENDPOINT
,
173 data
->bTag_last_read
, data
->bulk_in
,
174 buffer
, 2, USBTMC_TIMEOUT
);
177 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
181 dev_dbg(dev
, "INITIATE_ABORT_BULK_IN returned %x\n", buffer
[0]);
183 if (buffer
[0] == USBTMC_STATUS_FAILED
) {
188 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
189 dev_err(dev
, "INITIATE_ABORT_BULK_IN returned %x\n",
196 current_setting
= data
->intf
->cur_altsetting
;
197 for (n
= 0; n
< current_setting
->desc
.bNumEndpoints
; n
++)
198 if (current_setting
->endpoint
[n
].desc
.bEndpointAddress
==
200 max_size
= usb_endpoint_maxp(¤t_setting
->endpoint
[n
].desc
);
203 dev_err(dev
, "Couldn't get wMaxPacketSize\n");
208 dev_dbg(&data
->intf
->dev
, "wMaxPacketSize is %d\n", max_size
);
213 dev_dbg(dev
, "Reading from bulk in EP\n");
215 rv
= usb_bulk_msg(data
->usb_dev
,
216 usb_rcvbulkpipe(data
->usb_dev
,
218 buffer
, USBTMC_SIZE_IOBUFFER
,
219 &actual
, USBTMC_TIMEOUT
);
224 dev_err(dev
, "usb_bulk_msg returned %d\n", rv
);
227 } while ((actual
== max_size
) &&
228 (n
< USBTMC_MAX_READS_TO_CLEAR_BULK_IN
));
230 if (actual
== max_size
) {
231 dev_err(dev
, "Couldn't clear device buffer within %d cycles\n",
232 USBTMC_MAX_READS_TO_CLEAR_BULK_IN
);
239 usbtmc_abort_bulk_in_status
:
240 rv
= usb_control_msg(data
->usb_dev
,
241 usb_rcvctrlpipe(data
->usb_dev
, 0),
242 USBTMC_REQUEST_CHECK_ABORT_BULK_IN_STATUS
,
243 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_ENDPOINT
,
244 0, data
->bulk_in
, buffer
, 0x08,
248 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
252 dev_dbg(dev
, "INITIATE_ABORT_BULK_IN returned %x\n", buffer
[0]);
254 if (buffer
[0] == USBTMC_STATUS_SUCCESS
) {
259 if (buffer
[0] != USBTMC_STATUS_PENDING
) {
260 dev_err(dev
, "INITIATE_ABORT_BULK_IN returned %x\n", buffer
[0]);
267 dev_dbg(dev
, "Reading from bulk in EP\n");
269 rv
= usb_bulk_msg(data
->usb_dev
,
270 usb_rcvbulkpipe(data
->usb_dev
,
272 buffer
, USBTMC_SIZE_IOBUFFER
,
273 &actual
, USBTMC_TIMEOUT
);
278 dev_err(dev
, "usb_bulk_msg returned %d\n", rv
);
281 } while ((actual
== max_size
) &&
282 (n
< USBTMC_MAX_READS_TO_CLEAR_BULK_IN
));
284 if (actual
== max_size
) {
285 dev_err(dev
, "Couldn't clear device buffer within %d cycles\n",
286 USBTMC_MAX_READS_TO_CLEAR_BULK_IN
);
291 goto usbtmc_abort_bulk_in_status
;
299 static int usbtmc_ioctl_abort_bulk_out(struct usbtmc_device_data
*data
)
306 dev
= &data
->intf
->dev
;
308 buffer
= kmalloc(8, GFP_KERNEL
);
312 rv
= usb_control_msg(data
->usb_dev
,
313 usb_rcvctrlpipe(data
->usb_dev
, 0),
314 USBTMC_REQUEST_INITIATE_ABORT_BULK_OUT
,
315 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_ENDPOINT
,
316 data
->bTag_last_write
, data
->bulk_out
,
317 buffer
, 2, USBTMC_TIMEOUT
);
320 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
324 dev_dbg(dev
, "INITIATE_ABORT_BULK_OUT returned %x\n", buffer
[0]);
326 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
327 dev_err(dev
, "INITIATE_ABORT_BULK_OUT returned %x\n",
335 usbtmc_abort_bulk_out_check_status
:
336 rv
= usb_control_msg(data
->usb_dev
,
337 usb_rcvctrlpipe(data
->usb_dev
, 0),
338 USBTMC_REQUEST_CHECK_ABORT_BULK_OUT_STATUS
,
339 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_ENDPOINT
,
340 0, data
->bulk_out
, buffer
, 0x08,
344 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
348 dev_dbg(dev
, "CHECK_ABORT_BULK_OUT returned %x\n", buffer
[0]);
350 if (buffer
[0] == USBTMC_STATUS_SUCCESS
)
351 goto usbtmc_abort_bulk_out_clear_halt
;
353 if ((buffer
[0] == USBTMC_STATUS_PENDING
) &&
354 (n
< USBTMC_MAX_READS_TO_CLEAR_BULK_IN
))
355 goto usbtmc_abort_bulk_out_check_status
;
360 usbtmc_abort_bulk_out_clear_halt
:
361 rv
= usb_clear_halt(data
->usb_dev
,
362 usb_sndbulkpipe(data
->usb_dev
, data
->bulk_out
));
365 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
376 * Sends a REQUEST_DEV_DEP_MSG_IN message on the Bulk-IN endpoint.
377 * @transfer_size: number of bytes to request from the device.
379 * See the USBTMC specification, Table 4.
381 * Also updates bTag_last_write.
383 static int send_request_dev_dep_msg_in(struct usbtmc_device_data
*data
, size_t transfer_size
)
389 buffer
= kmalloc(USBTMC_HEADER_SIZE
, GFP_KERNEL
);
392 /* Setup IO buffer for REQUEST_DEV_DEP_MSG_IN message
393 * Refer to class specs for details
396 buffer
[1] = data
->bTag
;
397 buffer
[2] = ~data
->bTag
;
398 buffer
[3] = 0; /* Reserved */
399 buffer
[4] = transfer_size
>> 0;
400 buffer
[5] = transfer_size
>> 8;
401 buffer
[6] = transfer_size
>> 16;
402 buffer
[7] = transfer_size
>> 24;
403 buffer
[8] = data
->TermCharEnabled
* 2;
404 /* Use term character? */
405 buffer
[9] = data
->TermChar
;
406 buffer
[10] = 0; /* Reserved */
407 buffer
[11] = 0; /* Reserved */
410 retval
= usb_bulk_msg(data
->usb_dev
,
411 usb_sndbulkpipe(data
->usb_dev
,
413 buffer
, USBTMC_HEADER_SIZE
, &actual
, USBTMC_TIMEOUT
);
415 /* Store bTag (in case we need to abort) */
416 data
->bTag_last_write
= data
->bTag
;
418 /* Increment bTag -- and increment again if zero */
425 dev_err(&data
->intf
->dev
, "usb_bulk_msg in send_request_dev_dep_msg_in() returned %d\n", retval
);
432 static ssize_t
usbtmc_read(struct file
*filp
, char __user
*buf
,
433 size_t count
, loff_t
*f_pos
)
435 struct usbtmc_device_data
*data
;
445 /* Get pointer to private data structure */
446 data
= filp
->private_data
;
447 dev
= &data
->intf
->dev
;
449 buffer
= kmalloc(USBTMC_SIZE_IOBUFFER
, GFP_KERNEL
);
453 mutex_lock(&data
->io_mutex
);
459 if (data
->rigol_quirk
) {
460 dev_dbg(dev
, "usb_bulk_msg_in: count(%zu)\n", count
);
462 retval
= send_request_dev_dep_msg_in(data
, count
);
465 if (data
->auto_abort
)
466 usbtmc_ioctl_abort_bulk_out(data
);
471 /* Loop until we have fetched everything we requested */
473 this_part
= remaining
;
476 while (remaining
> 0) {
477 if (!data
->rigol_quirk
) {
478 dev_dbg(dev
, "usb_bulk_msg_in: remaining(%zu), count(%zu)\n", remaining
, count
);
480 if (remaining
> USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
- 3)
481 this_part
= USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
- 3;
483 this_part
= remaining
;
485 retval
= send_request_dev_dep_msg_in(data
, this_part
);
487 dev_err(dev
, "usb_bulk_msg returned %d\n", retval
);
488 if (data
->auto_abort
)
489 usbtmc_ioctl_abort_bulk_out(data
);
495 retval
= usb_bulk_msg(data
->usb_dev
,
496 usb_rcvbulkpipe(data
->usb_dev
,
498 buffer
, USBTMC_SIZE_IOBUFFER
, &actual
,
501 dev_dbg(dev
, "usb_bulk_msg: retval(%u), done(%zu), remaining(%zu), actual(%d)\n", retval
, done
, remaining
, actual
);
503 /* Store bTag (in case we need to abort) */
504 data
->bTag_last_read
= data
->bTag
;
507 dev_dbg(dev
, "Unable to read data, error %d\n", retval
);
508 if (data
->auto_abort
)
509 usbtmc_ioctl_abort_bulk_in(data
);
513 /* Parse header in first packet */
514 if ((done
== 0) || !data
->rigol_quirk
) {
515 /* Sanity checks for the header */
516 if (actual
< USBTMC_HEADER_SIZE
) {
517 dev_err(dev
, "Device sent too small first packet: %u < %u\n", actual
, USBTMC_HEADER_SIZE
);
518 if (data
->auto_abort
)
519 usbtmc_ioctl_abort_bulk_in(data
);
523 if (buffer
[0] != 2) {
524 dev_err(dev
, "Device sent reply with wrong MsgID: %u != 2\n", buffer
[0]);
525 if (data
->auto_abort
)
526 usbtmc_ioctl_abort_bulk_in(data
);
530 if (buffer
[1] != data
->bTag_last_write
) {
531 dev_err(dev
, "Device sent reply with wrong bTag: %u != %u\n", buffer
[1], data
->bTag_last_write
);
532 if (data
->auto_abort
)
533 usbtmc_ioctl_abort_bulk_in(data
);
537 /* How many characters did the instrument send? */
538 n_characters
= buffer
[4] +
543 if (n_characters
> this_part
) {
544 dev_err(dev
, "Device wants to return more data than requested: %u > %zu\n", n_characters
, count
);
545 if (data
->auto_abort
)
546 usbtmc_ioctl_abort_bulk_in(data
);
550 /* Remove the USBTMC header */
551 actual
-= USBTMC_HEADER_SIZE
;
553 /* Check if the message is smaller than requested */
554 if (data
->rigol_quirk
) {
555 if (remaining
> n_characters
)
556 remaining
= n_characters
;
557 /* Remove padding if it exists */
558 if (actual
> remaining
)
562 if (this_part
> n_characters
)
563 this_part
= n_characters
;
564 /* Remove padding if it exists */
565 if (actual
> this_part
)
569 dev_dbg(dev
, "Bulk-IN header: N_characters(%u), bTransAttr(%u)\n", n_characters
, buffer
[8]);
573 /* Terminate if end-of-message bit received from device */
574 if ((buffer
[8] & 0x01) && (actual
>= n_characters
))
577 dev_dbg(dev
, "Bulk-IN header: remaining(%zu), buf(%p), buffer(%p) done(%zu)\n", remaining
,buf
,buffer
,done
);
580 /* Copy buffer to user space */
581 if (copy_to_user(buf
+ done
, &buffer
[USBTMC_HEADER_SIZE
], actual
)) {
582 /* There must have been an addressing problem */
589 if (actual
> remaining
)
594 dev_dbg(dev
, "Bulk-IN header cont: actual(%u), done(%zu), remaining(%zu), buf(%p), buffer(%p)\n", actual
, done
, remaining
,buf
,buffer
);
596 /* Copy buffer to user space */
597 if (copy_to_user(buf
+ done
, buffer
, actual
)) {
598 /* There must have been an addressing problem */
606 /* Update file position value */
607 *f_pos
= *f_pos
+ done
;
611 mutex_unlock(&data
->io_mutex
);
616 static ssize_t
usbtmc_write(struct file
*filp
, const char __user
*buf
,
617 size_t count
, loff_t
*f_pos
)
619 struct usbtmc_device_data
*data
;
623 unsigned long int n_bytes
;
628 data
= filp
->private_data
;
630 buffer
= kmalloc(USBTMC_SIZE_IOBUFFER
, GFP_KERNEL
);
634 mutex_lock(&data
->io_mutex
);
643 while (remaining
> 0) {
644 if (remaining
> USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
) {
645 this_part
= USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
;
648 this_part
= remaining
;
652 /* Setup IO buffer for DEV_DEP_MSG_OUT message */
654 buffer
[1] = data
->bTag
;
655 buffer
[2] = ~data
->bTag
;
656 buffer
[3] = 0; /* Reserved */
657 buffer
[4] = this_part
>> 0;
658 buffer
[5] = this_part
>> 8;
659 buffer
[6] = this_part
>> 16;
660 buffer
[7] = this_part
>> 24;
661 /* buffer[8] is set above... */
662 buffer
[9] = 0; /* Reserved */
663 buffer
[10] = 0; /* Reserved */
664 buffer
[11] = 0; /* Reserved */
666 if (copy_from_user(&buffer
[USBTMC_HEADER_SIZE
], buf
+ done
, this_part
)) {
671 n_bytes
= roundup(USBTMC_HEADER_SIZE
+ this_part
, 4);
672 memset(buffer
+ USBTMC_HEADER_SIZE
+ this_part
, 0, n_bytes
- (USBTMC_HEADER_SIZE
+ this_part
));
675 retval
= usb_bulk_msg(data
->usb_dev
,
676 usb_sndbulkpipe(data
->usb_dev
,
679 &actual
, USBTMC_TIMEOUT
);
685 data
->bTag_last_write
= data
->bTag
;
692 dev_err(&data
->intf
->dev
,
693 "Unable to send data, error %d\n", retval
);
694 if (data
->auto_abort
)
695 usbtmc_ioctl_abort_bulk_out(data
);
699 remaining
-= this_part
;
705 mutex_unlock(&data
->io_mutex
);
710 static int usbtmc_ioctl_clear(struct usbtmc_device_data
*data
)
712 struct usb_host_interface
*current_setting
;
713 struct usb_endpoint_descriptor
*desc
;
721 dev
= &data
->intf
->dev
;
723 dev_dbg(dev
, "Sending INITIATE_CLEAR request\n");
725 buffer
= kmalloc(USBTMC_SIZE_IOBUFFER
, GFP_KERNEL
);
729 rv
= usb_control_msg(data
->usb_dev
,
730 usb_rcvctrlpipe(data
->usb_dev
, 0),
731 USBTMC_REQUEST_INITIATE_CLEAR
,
732 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
733 0, 0, buffer
, 1, USBTMC_TIMEOUT
);
735 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
739 dev_dbg(dev
, "INITIATE_CLEAR returned %x\n", buffer
[0]);
741 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
742 dev_err(dev
, "INITIATE_CLEAR returned %x\n", buffer
[0]);
748 current_setting
= data
->intf
->cur_altsetting
;
749 for (n
= 0; n
< current_setting
->desc
.bNumEndpoints
; n
++) {
750 desc
= ¤t_setting
->endpoint
[n
].desc
;
751 if (desc
->bEndpointAddress
== data
->bulk_in
)
752 max_size
= usb_endpoint_maxp(desc
);
756 dev_err(dev
, "Couldn't get wMaxPacketSize\n");
761 dev_dbg(dev
, "wMaxPacketSize is %d\n", max_size
);
765 usbtmc_clear_check_status
:
767 dev_dbg(dev
, "Sending CHECK_CLEAR_STATUS request\n");
769 rv
= usb_control_msg(data
->usb_dev
,
770 usb_rcvctrlpipe(data
->usb_dev
, 0),
771 USBTMC_REQUEST_CHECK_CLEAR_STATUS
,
772 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
773 0, 0, buffer
, 2, USBTMC_TIMEOUT
);
775 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
779 dev_dbg(dev
, "CHECK_CLEAR_STATUS returned %x\n", buffer
[0]);
781 if (buffer
[0] == USBTMC_STATUS_SUCCESS
)
782 goto usbtmc_clear_bulk_out_halt
;
784 if (buffer
[0] != USBTMC_STATUS_PENDING
) {
785 dev_err(dev
, "CHECK_CLEAR_STATUS returned %x\n", buffer
[0]);
792 dev_dbg(dev
, "Reading from bulk in EP\n");
794 rv
= usb_bulk_msg(data
->usb_dev
,
795 usb_rcvbulkpipe(data
->usb_dev
,
797 buffer
, USBTMC_SIZE_IOBUFFER
,
798 &actual
, USBTMC_TIMEOUT
);
802 dev_err(dev
, "usb_control_msg returned %d\n",
806 } while ((actual
== max_size
) &&
807 (n
< USBTMC_MAX_READS_TO_CLEAR_BULK_IN
));
809 if (actual
== max_size
) {
810 dev_err(dev
, "Couldn't clear device buffer within %d cycles\n",
811 USBTMC_MAX_READS_TO_CLEAR_BULK_IN
);
816 goto usbtmc_clear_check_status
;
818 usbtmc_clear_bulk_out_halt
:
820 rv
= usb_clear_halt(data
->usb_dev
,
821 usb_sndbulkpipe(data
->usb_dev
, data
->bulk_out
));
823 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
833 static int usbtmc_ioctl_clear_out_halt(struct usbtmc_device_data
*data
)
837 rv
= usb_clear_halt(data
->usb_dev
,
838 usb_sndbulkpipe(data
->usb_dev
, data
->bulk_out
));
841 dev_err(&data
->usb_dev
->dev
, "usb_control_msg returned %d\n",
848 static int usbtmc_ioctl_clear_in_halt(struct usbtmc_device_data
*data
)
852 rv
= usb_clear_halt(data
->usb_dev
,
853 usb_rcvbulkpipe(data
->usb_dev
, data
->bulk_in
));
856 dev_err(&data
->usb_dev
->dev
, "usb_control_msg returned %d\n",
863 static int get_capabilities(struct usbtmc_device_data
*data
)
865 struct device
*dev
= &data
->usb_dev
->dev
;
869 buffer
= kmalloc(0x18, GFP_KERNEL
);
873 rv
= usb_control_msg(data
->usb_dev
, usb_rcvctrlpipe(data
->usb_dev
, 0),
874 USBTMC_REQUEST_GET_CAPABILITIES
,
875 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
876 0, 0, buffer
, 0x18, USBTMC_TIMEOUT
);
878 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
882 dev_dbg(dev
, "GET_CAPABILITIES returned %x\n", buffer
[0]);
883 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
884 dev_err(dev
, "GET_CAPABILITIES returned %x\n", buffer
[0]);
888 dev_dbg(dev
, "Interface capabilities are %x\n", buffer
[4]);
889 dev_dbg(dev
, "Device capabilities are %x\n", buffer
[5]);
890 dev_dbg(dev
, "USB488 interface capabilities are %x\n", buffer
[14]);
891 dev_dbg(dev
, "USB488 device capabilities are %x\n", buffer
[15]);
893 data
->capabilities
.interface_capabilities
= buffer
[4];
894 data
->capabilities
.device_capabilities
= buffer
[5];
895 data
->capabilities
.usb488_interface_capabilities
= buffer
[14];
896 data
->capabilities
.usb488_device_capabilities
= buffer
[15];
904 #define capability_attribute(name) \
905 static ssize_t name##_show(struct device *dev, \
906 struct device_attribute *attr, char *buf) \
908 struct usb_interface *intf = to_usb_interface(dev); \
909 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
911 return sprintf(buf, "%d\n", data->capabilities.name); \
913 static DEVICE_ATTR_RO(name)
915 capability_attribute(interface_capabilities
);
916 capability_attribute(device_capabilities
);
917 capability_attribute(usb488_interface_capabilities
);
918 capability_attribute(usb488_device_capabilities
);
920 static struct attribute
*capability_attrs
[] = {
921 &dev_attr_interface_capabilities
.attr
,
922 &dev_attr_device_capabilities
.attr
,
923 &dev_attr_usb488_interface_capabilities
.attr
,
924 &dev_attr_usb488_device_capabilities
.attr
,
928 static struct attribute_group capability_attr_grp
= {
929 .attrs
= capability_attrs
,
932 static ssize_t
TermChar_show(struct device
*dev
,
933 struct device_attribute
*attr
, char *buf
)
935 struct usb_interface
*intf
= to_usb_interface(dev
);
936 struct usbtmc_device_data
*data
= usb_get_intfdata(intf
);
938 return sprintf(buf
, "%c\n", data
->TermChar
);
941 static ssize_t
TermChar_store(struct device
*dev
,
942 struct device_attribute
*attr
,
943 const char *buf
, size_t count
)
945 struct usb_interface
*intf
= to_usb_interface(dev
);
946 struct usbtmc_device_data
*data
= usb_get_intfdata(intf
);
950 data
->TermChar
= buf
[0];
953 static DEVICE_ATTR_RW(TermChar
);
955 #define data_attribute(name) \
956 static ssize_t name##_show(struct device *dev, \
957 struct device_attribute *attr, char *buf) \
959 struct usb_interface *intf = to_usb_interface(dev); \
960 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
962 return sprintf(buf, "%d\n", data->name); \
964 static ssize_t name##_store(struct device *dev, \
965 struct device_attribute *attr, \
966 const char *buf, size_t count) \
968 struct usb_interface *intf = to_usb_interface(dev); \
969 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
973 result = sscanf(buf, "%u\n", &val); \
982 static DEVICE_ATTR_RW(name)
984 data_attribute(TermCharEnabled
);
985 data_attribute(auto_abort
);
987 static struct attribute
*data_attrs
[] = {
988 &dev_attr_TermChar
.attr
,
989 &dev_attr_TermCharEnabled
.attr
,
990 &dev_attr_auto_abort
.attr
,
994 static struct attribute_group data_attr_grp
= {
998 static int usbtmc_ioctl_indicator_pulse(struct usbtmc_device_data
*data
)
1004 dev
= &data
->intf
->dev
;
1006 buffer
= kmalloc(2, GFP_KERNEL
);
1010 rv
= usb_control_msg(data
->usb_dev
,
1011 usb_rcvctrlpipe(data
->usb_dev
, 0),
1012 USBTMC_REQUEST_INDICATOR_PULSE
,
1013 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
1014 0, 0, buffer
, 0x01, USBTMC_TIMEOUT
);
1017 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
1021 dev_dbg(dev
, "INDICATOR_PULSE returned %x\n", buffer
[0]);
1023 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
1024 dev_err(dev
, "INDICATOR_PULSE returned %x\n", buffer
[0]);
1035 static long usbtmc_ioctl(struct file
*file
, unsigned int cmd
, unsigned long arg
)
1037 struct usbtmc_device_data
*data
;
1038 int retval
= -EBADRQC
;
1040 data
= file
->private_data
;
1041 mutex_lock(&data
->io_mutex
);
1044 goto skip_io_on_zombie
;
1048 case USBTMC_IOCTL_CLEAR_OUT_HALT
:
1049 retval
= usbtmc_ioctl_clear_out_halt(data
);
1052 case USBTMC_IOCTL_CLEAR_IN_HALT
:
1053 retval
= usbtmc_ioctl_clear_in_halt(data
);
1056 case USBTMC_IOCTL_INDICATOR_PULSE
:
1057 retval
= usbtmc_ioctl_indicator_pulse(data
);
1060 case USBTMC_IOCTL_CLEAR
:
1061 retval
= usbtmc_ioctl_clear(data
);
1064 case USBTMC_IOCTL_ABORT_BULK_OUT
:
1065 retval
= usbtmc_ioctl_abort_bulk_out(data
);
1068 case USBTMC_IOCTL_ABORT_BULK_IN
:
1069 retval
= usbtmc_ioctl_abort_bulk_in(data
);
1074 mutex_unlock(&data
->io_mutex
);
1078 static const struct file_operations fops
= {
1079 .owner
= THIS_MODULE
,
1080 .read
= usbtmc_read
,
1081 .write
= usbtmc_write
,
1082 .open
= usbtmc_open
,
1083 .release
= usbtmc_release
,
1084 .unlocked_ioctl
= usbtmc_ioctl
,
1085 .llseek
= default_llseek
,
1088 static struct usb_class_driver usbtmc_class
= {
1091 .minor_base
= USBTMC_MINOR_BASE
,
1095 static int usbtmc_probe(struct usb_interface
*intf
,
1096 const struct usb_device_id
*id
)
1098 struct usbtmc_device_data
*data
;
1099 struct usb_host_interface
*iface_desc
;
1100 struct usb_endpoint_descriptor
*endpoint
;
1104 dev_dbg(&intf
->dev
, "%s called\n", __func__
);
1106 data
= devm_kzalloc(&intf
->dev
, sizeof(*data
), GFP_KERNEL
);
1112 data
->usb_dev
= usb_get_dev(interface_to_usbdev(intf
));
1113 usb_set_intfdata(intf
, data
);
1114 kref_init(&data
->kref
);
1115 mutex_init(&data
->io_mutex
);
1118 /* Determine if it is a Rigol or not */
1119 data
->rigol_quirk
= 0;
1120 dev_dbg(&intf
->dev
, "Trying to find if device Vendor 0x%04X Product 0x%04X has the RIGOL quirk\n",
1121 le16_to_cpu(data
->usb_dev
->descriptor
.idVendor
),
1122 le16_to_cpu(data
->usb_dev
->descriptor
.idProduct
));
1123 for(n
= 0; usbtmc_id_quirk
[n
].idVendor
> 0; n
++) {
1124 if ((usbtmc_id_quirk
[n
].idVendor
== le16_to_cpu(data
->usb_dev
->descriptor
.idVendor
)) &&
1125 (usbtmc_id_quirk
[n
].idProduct
== le16_to_cpu(data
->usb_dev
->descriptor
.idProduct
))) {
1126 dev_dbg(&intf
->dev
, "Setting this device as having the RIGOL quirk\n");
1127 data
->rigol_quirk
= 1;
1132 /* Initialize USBTMC bTag and other fields */
1134 data
->TermCharEnabled
= 0;
1135 data
->TermChar
= '\n';
1137 /* USBTMC devices have only one setting, so use that */
1138 iface_desc
= data
->intf
->cur_altsetting
;
1140 /* Find bulk in endpoint */
1141 for (n
= 0; n
< iface_desc
->desc
.bNumEndpoints
; n
++) {
1142 endpoint
= &iface_desc
->endpoint
[n
].desc
;
1144 if (usb_endpoint_is_bulk_in(endpoint
)) {
1145 data
->bulk_in
= endpoint
->bEndpointAddress
;
1146 dev_dbg(&intf
->dev
, "Found bulk in endpoint at %u\n",
1152 /* Find bulk out endpoint */
1153 for (n
= 0; n
< iface_desc
->desc
.bNumEndpoints
; n
++) {
1154 endpoint
= &iface_desc
->endpoint
[n
].desc
;
1156 if (usb_endpoint_is_bulk_out(endpoint
)) {
1157 data
->bulk_out
= endpoint
->bEndpointAddress
;
1158 dev_dbg(&intf
->dev
, "Found Bulk out endpoint at %u\n",
1164 retcode
= get_capabilities(data
);
1166 dev_err(&intf
->dev
, "can't read capabilities\n");
1168 retcode
= sysfs_create_group(&intf
->dev
.kobj
,
1169 &capability_attr_grp
);
1171 retcode
= sysfs_create_group(&intf
->dev
.kobj
, &data_attr_grp
);
1173 retcode
= usb_register_dev(intf
, &usbtmc_class
);
1175 dev_err(&intf
->dev
, "Not able to get a minor"
1176 " (base %u, slice default): %d\n", USBTMC_MINOR_BASE
,
1178 goto error_register
;
1180 dev_dbg(&intf
->dev
, "Using minor number %d\n", intf
->minor
);
1185 sysfs_remove_group(&intf
->dev
.kobj
, &capability_attr_grp
);
1186 sysfs_remove_group(&intf
->dev
.kobj
, &data_attr_grp
);
1187 kref_put(&data
->kref
, usbtmc_delete
);
1191 static void usbtmc_disconnect(struct usb_interface
*intf
)
1193 struct usbtmc_device_data
*data
;
1195 dev_dbg(&intf
->dev
, "usbtmc_disconnect called\n");
1197 data
= usb_get_intfdata(intf
);
1198 usb_deregister_dev(intf
, &usbtmc_class
);
1199 sysfs_remove_group(&intf
->dev
.kobj
, &capability_attr_grp
);
1200 sysfs_remove_group(&intf
->dev
.kobj
, &data_attr_grp
);
1201 mutex_lock(&data
->io_mutex
);
1203 mutex_unlock(&data
->io_mutex
);
1204 kref_put(&data
->kref
, usbtmc_delete
);
1207 static int usbtmc_suspend(struct usb_interface
*intf
, pm_message_t message
)
1209 /* this driver does not have pending URBs */
1213 static int usbtmc_resume(struct usb_interface
*intf
)
1218 static struct usb_driver usbtmc_driver
= {
1220 .id_table
= usbtmc_devices
,
1221 .probe
= usbtmc_probe
,
1222 .disconnect
= usbtmc_disconnect
,
1223 .suspend
= usbtmc_suspend
,
1224 .resume
= usbtmc_resume
,
1227 module_usb_driver(usbtmc_driver
);
1229 MODULE_LICENSE("GPL");