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
)
386 u8 buffer
[USBTMC_HEADER_SIZE
];
389 /* Setup IO buffer for REQUEST_DEV_DEP_MSG_IN message
390 * Refer to class specs for details
393 buffer
[1] = data
->bTag
;
394 buffer
[2] = ~data
->bTag
;
395 buffer
[3] = 0; /* Reserved */
396 buffer
[4] = transfer_size
>> 0;
397 buffer
[5] = transfer_size
>> 8;
398 buffer
[6] = transfer_size
>> 16;
399 buffer
[7] = transfer_size
>> 24;
400 buffer
[8] = data
->TermCharEnabled
* 2;
401 /* Use term character? */
402 buffer
[9] = data
->TermChar
;
403 buffer
[10] = 0; /* Reserved */
404 buffer
[11] = 0; /* Reserved */
407 retval
= usb_bulk_msg(data
->usb_dev
,
408 usb_sndbulkpipe(data
->usb_dev
,
410 buffer
, USBTMC_HEADER_SIZE
, &actual
, USBTMC_TIMEOUT
);
412 /* Store bTag (in case we need to abort) */
413 data
->bTag_last_write
= data
->bTag
;
415 /* Increment bTag -- and increment again if zero */
421 dev_err(&data
->intf
->dev
, "usb_bulk_msg in send_request_dev_dep_msg_in() returned %d\n", retval
);
428 static ssize_t
usbtmc_read(struct file
*filp
, char __user
*buf
,
429 size_t count
, loff_t
*f_pos
)
431 struct usbtmc_device_data
*data
;
441 /* Get pointer to private data structure */
442 data
= filp
->private_data
;
443 dev
= &data
->intf
->dev
;
445 buffer
= kmalloc(USBTMC_SIZE_IOBUFFER
, GFP_KERNEL
);
449 mutex_lock(&data
->io_mutex
);
455 if (data
->rigol_quirk
) {
456 dev_dbg(dev
, "usb_bulk_msg_in: count(%zu)\n", count
);
458 retval
= send_request_dev_dep_msg_in(data
, count
);
461 if (data
->auto_abort
)
462 usbtmc_ioctl_abort_bulk_out(data
);
467 /* Loop until we have fetched everything we requested */
469 this_part
= remaining
;
472 while (remaining
> 0) {
473 if (!data
->rigol_quirk
) {
474 dev_dbg(dev
, "usb_bulk_msg_in: remaining(%zu), count(%zu)\n", remaining
, count
);
476 if (remaining
> USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
- 3)
477 this_part
= USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
- 3;
479 this_part
= remaining
;
481 retval
= send_request_dev_dep_msg_in(data
, this_part
);
483 dev_err(dev
, "usb_bulk_msg returned %d\n", retval
);
484 if (data
->auto_abort
)
485 usbtmc_ioctl_abort_bulk_out(data
);
491 retval
= usb_bulk_msg(data
->usb_dev
,
492 usb_rcvbulkpipe(data
->usb_dev
,
494 buffer
, USBTMC_SIZE_IOBUFFER
, &actual
,
497 dev_dbg(dev
, "usb_bulk_msg: retval(%u), done(%zu), remaining(%zu), actual(%d)\n", retval
, done
, remaining
, actual
);
499 /* Store bTag (in case we need to abort) */
500 data
->bTag_last_read
= data
->bTag
;
503 dev_dbg(dev
, "Unable to read data, error %d\n", retval
);
504 if (data
->auto_abort
)
505 usbtmc_ioctl_abort_bulk_in(data
);
509 /* Parse header in first packet */
510 if ((done
== 0) || !data
->rigol_quirk
) {
511 /* Sanity checks for the header */
512 if (actual
< USBTMC_HEADER_SIZE
) {
513 dev_err(dev
, "Device sent too small first packet: %u < %u\n", actual
, USBTMC_HEADER_SIZE
);
514 if (data
->auto_abort
)
515 usbtmc_ioctl_abort_bulk_in(data
);
519 if (buffer
[0] != 2) {
520 dev_err(dev
, "Device sent reply with wrong MsgID: %u != 2\n", buffer
[0]);
521 if (data
->auto_abort
)
522 usbtmc_ioctl_abort_bulk_in(data
);
526 if (buffer
[1] != data
->bTag_last_write
) {
527 dev_err(dev
, "Device sent reply with wrong bTag: %u != %u\n", buffer
[1], data
->bTag_last_write
);
528 if (data
->auto_abort
)
529 usbtmc_ioctl_abort_bulk_in(data
);
533 /* How many characters did the instrument send? */
534 n_characters
= buffer
[4] +
539 if (n_characters
> this_part
) {
540 dev_err(dev
, "Device wants to return more data than requested: %u > %zu\n", n_characters
, count
);
541 if (data
->auto_abort
)
542 usbtmc_ioctl_abort_bulk_in(data
);
546 /* Remove the USBTMC header */
547 actual
-= USBTMC_HEADER_SIZE
;
549 /* Check if the message is smaller than requested */
550 if (data
->rigol_quirk
) {
551 if (remaining
> n_characters
)
552 remaining
= n_characters
;
553 /* Remove padding if it exists */
554 if (actual
> remaining
)
558 if (this_part
> n_characters
)
559 this_part
= n_characters
;
560 /* Remove padding if it exists */
561 if (actual
> this_part
)
565 dev_dbg(dev
, "Bulk-IN header: N_characters(%u), bTransAttr(%u)\n", n_characters
, buffer
[8]);
569 /* Terminate if end-of-message bit received from device */
570 if ((buffer
[8] & 0x01) && (actual
>= n_characters
))
573 dev_dbg(dev
, "Bulk-IN header: remaining(%zu), buf(%p), buffer(%p) done(%zu)\n", remaining
,buf
,buffer
,done
);
576 /* Copy buffer to user space */
577 if (copy_to_user(buf
+ done
, &buffer
[USBTMC_HEADER_SIZE
], actual
)) {
578 /* There must have been an addressing problem */
585 if (actual
> remaining
)
590 dev_dbg(dev
, "Bulk-IN header cont: actual(%u), done(%zu), remaining(%zu), buf(%p), buffer(%p)\n", actual
, done
, remaining
,buf
,buffer
);
592 /* Copy buffer to user space */
593 if (copy_to_user(buf
+ done
, buffer
, actual
)) {
594 /* There must have been an addressing problem */
602 /* Update file position value */
603 *f_pos
= *f_pos
+ done
;
607 mutex_unlock(&data
->io_mutex
);
612 static ssize_t
usbtmc_write(struct file
*filp
, const char __user
*buf
,
613 size_t count
, loff_t
*f_pos
)
615 struct usbtmc_device_data
*data
;
619 unsigned long int n_bytes
;
624 data
= filp
->private_data
;
626 buffer
= kmalloc(USBTMC_SIZE_IOBUFFER
, GFP_KERNEL
);
630 mutex_lock(&data
->io_mutex
);
639 while (remaining
> 0) {
640 if (remaining
> USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
) {
641 this_part
= USBTMC_SIZE_IOBUFFER
- USBTMC_HEADER_SIZE
;
644 this_part
= remaining
;
648 /* Setup IO buffer for DEV_DEP_MSG_OUT message */
650 buffer
[1] = data
->bTag
;
651 buffer
[2] = ~data
->bTag
;
652 buffer
[3] = 0; /* Reserved */
653 buffer
[4] = this_part
>> 0;
654 buffer
[5] = this_part
>> 8;
655 buffer
[6] = this_part
>> 16;
656 buffer
[7] = this_part
>> 24;
657 /* buffer[8] is set above... */
658 buffer
[9] = 0; /* Reserved */
659 buffer
[10] = 0; /* Reserved */
660 buffer
[11] = 0; /* Reserved */
662 if (copy_from_user(&buffer
[USBTMC_HEADER_SIZE
], buf
+ done
, this_part
)) {
667 n_bytes
= roundup(USBTMC_HEADER_SIZE
+ this_part
, 4);
668 memset(buffer
+ USBTMC_HEADER_SIZE
+ this_part
, 0, n_bytes
- (USBTMC_HEADER_SIZE
+ this_part
));
671 retval
= usb_bulk_msg(data
->usb_dev
,
672 usb_sndbulkpipe(data
->usb_dev
,
675 &actual
, USBTMC_TIMEOUT
);
681 data
->bTag_last_write
= data
->bTag
;
688 dev_err(&data
->intf
->dev
,
689 "Unable to send data, error %d\n", retval
);
690 if (data
->auto_abort
)
691 usbtmc_ioctl_abort_bulk_out(data
);
695 remaining
-= this_part
;
701 mutex_unlock(&data
->io_mutex
);
706 static int usbtmc_ioctl_clear(struct usbtmc_device_data
*data
)
708 struct usb_host_interface
*current_setting
;
709 struct usb_endpoint_descriptor
*desc
;
717 dev
= &data
->intf
->dev
;
719 dev_dbg(dev
, "Sending INITIATE_CLEAR request\n");
721 buffer
= kmalloc(USBTMC_SIZE_IOBUFFER
, GFP_KERNEL
);
725 rv
= usb_control_msg(data
->usb_dev
,
726 usb_rcvctrlpipe(data
->usb_dev
, 0),
727 USBTMC_REQUEST_INITIATE_CLEAR
,
728 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
729 0, 0, buffer
, 1, USBTMC_TIMEOUT
);
731 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
735 dev_dbg(dev
, "INITIATE_CLEAR returned %x\n", buffer
[0]);
737 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
738 dev_err(dev
, "INITIATE_CLEAR returned %x\n", buffer
[0]);
744 current_setting
= data
->intf
->cur_altsetting
;
745 for (n
= 0; n
< current_setting
->desc
.bNumEndpoints
; n
++) {
746 desc
= ¤t_setting
->endpoint
[n
].desc
;
747 if (desc
->bEndpointAddress
== data
->bulk_in
)
748 max_size
= usb_endpoint_maxp(desc
);
752 dev_err(dev
, "Couldn't get wMaxPacketSize\n");
757 dev_dbg(dev
, "wMaxPacketSize is %d\n", max_size
);
761 usbtmc_clear_check_status
:
763 dev_dbg(dev
, "Sending CHECK_CLEAR_STATUS request\n");
765 rv
= usb_control_msg(data
->usb_dev
,
766 usb_rcvctrlpipe(data
->usb_dev
, 0),
767 USBTMC_REQUEST_CHECK_CLEAR_STATUS
,
768 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
769 0, 0, buffer
, 2, USBTMC_TIMEOUT
);
771 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
775 dev_dbg(dev
, "CHECK_CLEAR_STATUS returned %x\n", buffer
[0]);
777 if (buffer
[0] == USBTMC_STATUS_SUCCESS
)
778 goto usbtmc_clear_bulk_out_halt
;
780 if (buffer
[0] != USBTMC_STATUS_PENDING
) {
781 dev_err(dev
, "CHECK_CLEAR_STATUS returned %x\n", buffer
[0]);
788 dev_dbg(dev
, "Reading from bulk in EP\n");
790 rv
= usb_bulk_msg(data
->usb_dev
,
791 usb_rcvbulkpipe(data
->usb_dev
,
793 buffer
, USBTMC_SIZE_IOBUFFER
,
794 &actual
, USBTMC_TIMEOUT
);
798 dev_err(dev
, "usb_control_msg returned %d\n",
802 } while ((actual
== max_size
) &&
803 (n
< USBTMC_MAX_READS_TO_CLEAR_BULK_IN
));
805 if (actual
== max_size
) {
806 dev_err(dev
, "Couldn't clear device buffer within %d cycles\n",
807 USBTMC_MAX_READS_TO_CLEAR_BULK_IN
);
812 goto usbtmc_clear_check_status
;
814 usbtmc_clear_bulk_out_halt
:
816 rv
= usb_clear_halt(data
->usb_dev
,
817 usb_sndbulkpipe(data
->usb_dev
, data
->bulk_out
));
819 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
829 static int usbtmc_ioctl_clear_out_halt(struct usbtmc_device_data
*data
)
833 rv
= usb_clear_halt(data
->usb_dev
,
834 usb_sndbulkpipe(data
->usb_dev
, data
->bulk_out
));
837 dev_err(&data
->usb_dev
->dev
, "usb_control_msg returned %d\n",
844 static int usbtmc_ioctl_clear_in_halt(struct usbtmc_device_data
*data
)
848 rv
= usb_clear_halt(data
->usb_dev
,
849 usb_rcvbulkpipe(data
->usb_dev
, data
->bulk_in
));
852 dev_err(&data
->usb_dev
->dev
, "usb_control_msg returned %d\n",
859 static int get_capabilities(struct usbtmc_device_data
*data
)
861 struct device
*dev
= &data
->usb_dev
->dev
;
865 buffer
= kmalloc(0x18, GFP_KERNEL
);
869 rv
= usb_control_msg(data
->usb_dev
, usb_rcvctrlpipe(data
->usb_dev
, 0),
870 USBTMC_REQUEST_GET_CAPABILITIES
,
871 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
872 0, 0, buffer
, 0x18, USBTMC_TIMEOUT
);
874 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
878 dev_dbg(dev
, "GET_CAPABILITIES returned %x\n", buffer
[0]);
879 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
880 dev_err(dev
, "GET_CAPABILITIES returned %x\n", buffer
[0]);
884 dev_dbg(dev
, "Interface capabilities are %x\n", buffer
[4]);
885 dev_dbg(dev
, "Device capabilities are %x\n", buffer
[5]);
886 dev_dbg(dev
, "USB488 interface capabilities are %x\n", buffer
[14]);
887 dev_dbg(dev
, "USB488 device capabilities are %x\n", buffer
[15]);
889 data
->capabilities
.interface_capabilities
= buffer
[4];
890 data
->capabilities
.device_capabilities
= buffer
[5];
891 data
->capabilities
.usb488_interface_capabilities
= buffer
[14];
892 data
->capabilities
.usb488_device_capabilities
= buffer
[15];
900 #define capability_attribute(name) \
901 static ssize_t name##_show(struct device *dev, \
902 struct device_attribute *attr, char *buf) \
904 struct usb_interface *intf = to_usb_interface(dev); \
905 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
907 return sprintf(buf, "%d\n", data->capabilities.name); \
909 static DEVICE_ATTR_RO(name)
911 capability_attribute(interface_capabilities
);
912 capability_attribute(device_capabilities
);
913 capability_attribute(usb488_interface_capabilities
);
914 capability_attribute(usb488_device_capabilities
);
916 static struct attribute
*capability_attrs
[] = {
917 &dev_attr_interface_capabilities
.attr
,
918 &dev_attr_device_capabilities
.attr
,
919 &dev_attr_usb488_interface_capabilities
.attr
,
920 &dev_attr_usb488_device_capabilities
.attr
,
924 static struct attribute_group capability_attr_grp
= {
925 .attrs
= capability_attrs
,
928 static ssize_t
TermChar_show(struct device
*dev
,
929 struct device_attribute
*attr
, char *buf
)
931 struct usb_interface
*intf
= to_usb_interface(dev
);
932 struct usbtmc_device_data
*data
= usb_get_intfdata(intf
);
934 return sprintf(buf
, "%c\n", data
->TermChar
);
937 static ssize_t
TermChar_store(struct device
*dev
,
938 struct device_attribute
*attr
,
939 const char *buf
, size_t count
)
941 struct usb_interface
*intf
= to_usb_interface(dev
);
942 struct usbtmc_device_data
*data
= usb_get_intfdata(intf
);
946 data
->TermChar
= buf
[0];
949 static DEVICE_ATTR_RW(TermChar
);
951 #define data_attribute(name) \
952 static ssize_t name##_show(struct device *dev, \
953 struct device_attribute *attr, char *buf) \
955 struct usb_interface *intf = to_usb_interface(dev); \
956 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
958 return sprintf(buf, "%d\n", data->name); \
960 static ssize_t name##_store(struct device *dev, \
961 struct device_attribute *attr, \
962 const char *buf, size_t count) \
964 struct usb_interface *intf = to_usb_interface(dev); \
965 struct usbtmc_device_data *data = usb_get_intfdata(intf); \
969 result = sscanf(buf, "%u\n", &val); \
978 static DEVICE_ATTR_RW(name)
980 data_attribute(TermCharEnabled
);
981 data_attribute(auto_abort
);
983 static struct attribute
*data_attrs
[] = {
984 &dev_attr_TermChar
.attr
,
985 &dev_attr_TermCharEnabled
.attr
,
986 &dev_attr_auto_abort
.attr
,
990 static struct attribute_group data_attr_grp
= {
994 static int usbtmc_ioctl_indicator_pulse(struct usbtmc_device_data
*data
)
1000 dev
= &data
->intf
->dev
;
1002 buffer
= kmalloc(2, GFP_KERNEL
);
1006 rv
= usb_control_msg(data
->usb_dev
,
1007 usb_rcvctrlpipe(data
->usb_dev
, 0),
1008 USBTMC_REQUEST_INDICATOR_PULSE
,
1009 USB_DIR_IN
| USB_TYPE_CLASS
| USB_RECIP_INTERFACE
,
1010 0, 0, buffer
, 0x01, USBTMC_TIMEOUT
);
1013 dev_err(dev
, "usb_control_msg returned %d\n", rv
);
1017 dev_dbg(dev
, "INDICATOR_PULSE returned %x\n", buffer
[0]);
1019 if (buffer
[0] != USBTMC_STATUS_SUCCESS
) {
1020 dev_err(dev
, "INDICATOR_PULSE returned %x\n", buffer
[0]);
1031 static long usbtmc_ioctl(struct file
*file
, unsigned int cmd
, unsigned long arg
)
1033 struct usbtmc_device_data
*data
;
1034 int retval
= -EBADRQC
;
1036 data
= file
->private_data
;
1037 mutex_lock(&data
->io_mutex
);
1040 goto skip_io_on_zombie
;
1044 case USBTMC_IOCTL_CLEAR_OUT_HALT
:
1045 retval
= usbtmc_ioctl_clear_out_halt(data
);
1048 case USBTMC_IOCTL_CLEAR_IN_HALT
:
1049 retval
= usbtmc_ioctl_clear_in_halt(data
);
1052 case USBTMC_IOCTL_INDICATOR_PULSE
:
1053 retval
= usbtmc_ioctl_indicator_pulse(data
);
1056 case USBTMC_IOCTL_CLEAR
:
1057 retval
= usbtmc_ioctl_clear(data
);
1060 case USBTMC_IOCTL_ABORT_BULK_OUT
:
1061 retval
= usbtmc_ioctl_abort_bulk_out(data
);
1064 case USBTMC_IOCTL_ABORT_BULK_IN
:
1065 retval
= usbtmc_ioctl_abort_bulk_in(data
);
1070 mutex_unlock(&data
->io_mutex
);
1074 static const struct file_operations fops
= {
1075 .owner
= THIS_MODULE
,
1076 .read
= usbtmc_read
,
1077 .write
= usbtmc_write
,
1078 .open
= usbtmc_open
,
1079 .release
= usbtmc_release
,
1080 .unlocked_ioctl
= usbtmc_ioctl
,
1081 .llseek
= default_llseek
,
1084 static struct usb_class_driver usbtmc_class
= {
1087 .minor_base
= USBTMC_MINOR_BASE
,
1091 static int usbtmc_probe(struct usb_interface
*intf
,
1092 const struct usb_device_id
*id
)
1094 struct usbtmc_device_data
*data
;
1095 struct usb_host_interface
*iface_desc
;
1096 struct usb_endpoint_descriptor
*endpoint
;
1100 dev_dbg(&intf
->dev
, "%s called\n", __func__
);
1102 data
= devm_kzalloc(&intf
->dev
, sizeof(*data
), GFP_KERNEL
);
1104 dev_err(&intf
->dev
, "Unable to allocate kernel memory\n");
1110 data
->usb_dev
= usb_get_dev(interface_to_usbdev(intf
));
1111 usb_set_intfdata(intf
, data
);
1112 kref_init(&data
->kref
);
1113 mutex_init(&data
->io_mutex
);
1116 /* Determine if it is a Rigol or not */
1117 data
->rigol_quirk
= 0;
1118 dev_dbg(&intf
->dev
, "Trying to find if device Vendor 0x%04X Product 0x%04X has the RIGOL quirk\n",
1119 le16_to_cpu(data
->usb_dev
->descriptor
.idVendor
),
1120 le16_to_cpu(data
->usb_dev
->descriptor
.idProduct
));
1121 for(n
= 0; usbtmc_id_quirk
[n
].idVendor
> 0; n
++) {
1122 if ((usbtmc_id_quirk
[n
].idVendor
== le16_to_cpu(data
->usb_dev
->descriptor
.idVendor
)) &&
1123 (usbtmc_id_quirk
[n
].idProduct
== le16_to_cpu(data
->usb_dev
->descriptor
.idProduct
))) {
1124 dev_dbg(&intf
->dev
, "Setting this device as having the RIGOL quirk\n");
1125 data
->rigol_quirk
= 1;
1130 /* Initialize USBTMC bTag and other fields */
1132 data
->TermCharEnabled
= 0;
1133 data
->TermChar
= '\n';
1135 /* USBTMC devices have only one setting, so use that */
1136 iface_desc
= data
->intf
->cur_altsetting
;
1138 /* Find bulk in endpoint */
1139 for (n
= 0; n
< iface_desc
->desc
.bNumEndpoints
; n
++) {
1140 endpoint
= &iface_desc
->endpoint
[n
].desc
;
1142 if (usb_endpoint_is_bulk_in(endpoint
)) {
1143 data
->bulk_in
= endpoint
->bEndpointAddress
;
1144 dev_dbg(&intf
->dev
, "Found bulk in endpoint at %u\n",
1150 /* Find bulk out endpoint */
1151 for (n
= 0; n
< iface_desc
->desc
.bNumEndpoints
; n
++) {
1152 endpoint
= &iface_desc
->endpoint
[n
].desc
;
1154 if (usb_endpoint_is_bulk_out(endpoint
)) {
1155 data
->bulk_out
= endpoint
->bEndpointAddress
;
1156 dev_dbg(&intf
->dev
, "Found Bulk out endpoint at %u\n",
1162 retcode
= get_capabilities(data
);
1164 dev_err(&intf
->dev
, "can't read capabilities\n");
1166 retcode
= sysfs_create_group(&intf
->dev
.kobj
,
1167 &capability_attr_grp
);
1169 retcode
= sysfs_create_group(&intf
->dev
.kobj
, &data_attr_grp
);
1171 retcode
= usb_register_dev(intf
, &usbtmc_class
);
1173 dev_err(&intf
->dev
, "Not able to get a minor"
1174 " (base %u, slice default): %d\n", USBTMC_MINOR_BASE
,
1176 goto error_register
;
1178 dev_dbg(&intf
->dev
, "Using minor number %d\n", intf
->minor
);
1183 sysfs_remove_group(&intf
->dev
.kobj
, &capability_attr_grp
);
1184 sysfs_remove_group(&intf
->dev
.kobj
, &data_attr_grp
);
1185 kref_put(&data
->kref
, usbtmc_delete
);
1189 static void usbtmc_disconnect(struct usb_interface
*intf
)
1191 struct usbtmc_device_data
*data
;
1193 dev_dbg(&intf
->dev
, "usbtmc_disconnect called\n");
1195 data
= usb_get_intfdata(intf
);
1196 usb_deregister_dev(intf
, &usbtmc_class
);
1197 sysfs_remove_group(&intf
->dev
.kobj
, &capability_attr_grp
);
1198 sysfs_remove_group(&intf
->dev
.kobj
, &data_attr_grp
);
1199 mutex_lock(&data
->io_mutex
);
1201 mutex_unlock(&data
->io_mutex
);
1202 kref_put(&data
->kref
, usbtmc_delete
);
1205 static int usbtmc_suspend(struct usb_interface
*intf
, pm_message_t message
)
1207 /* this driver does not have pending URBs */
1211 static int usbtmc_resume(struct usb_interface
*intf
)
1216 static struct usb_driver usbtmc_driver
= {
1218 .id_table
= usbtmc_devices
,
1219 .probe
= usbtmc_probe
,
1220 .disconnect
= usbtmc_disconnect
,
1221 .suspend
= usbtmc_suspend
,
1222 .resume
= usbtmc_resume
,
1225 module_usb_driver(usbtmc_driver
);
1227 MODULE_LICENSE("GPL");