USB: add USB test and measurement class driver

This driver was originaly written by Stefan Kopp, but massively
reworked by Greg for submission.

Thanks to Felipe Balbi <me@felipebalbi.com> for lots of work in cleaning
up this driver.

Thanks to Oliver Neukum <oliver@neukum.org> for reviewing previous
versions and pointing out problems.


Cc: Stefan Kopp <stefan_kopp@agilent.com>
Cc: Marcel Janssen <korgull@home.nl>
Cc: Felipe Balbi <me@felipebalbi.com>
Cc: Oliver Neukum <oliver@neukum.org>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>

3 files changed, 67 insertions, 0 deletions

diff --git a/Documentation/ABI/stable/sysfs-driver-usb-usbtmc b/Documentation/ABI/stable/sysfs-driver-usb-usbtmc
new file mode 100644
index 000000000000..9a75fb22187d
--- /dev/null
+++ b/Documentation/ABI/stable/sysfs-driver-usb-usbtmc
@@ -0,0 +1,62 @@
+What:           /sys/bus/usb/drivers/usbtmc/devices/*/interface_capabilities
+What:           /sys/bus/usb/drivers/usbtmc/devices/*/device_capabilities
+Date:           August 2008
+Contact:        Greg Kroah-Hartman <gregkh@suse.de>
+Description:
+                These files show the various USB TMC capabilities as described
+                by the device itself.  The full description of the bitfields
+                can be found in the USB TMC documents from the USB-IF entitled
+                "Universal Serial Bus Test and Measurement Class Specification
+                (USBTMC) Revision 1.0" section 4.2.1.8.
+
+                The files are read only.
+
+
+What:           /sys/bus/usb/drivers/usbtmc/devices/*/usb488_interface_capabilities
+What:           /sys/bus/usb/drivers/usbtmc/devices/*/usb488_device_capabilities
+Date:           August 2008
+Contact:        Greg Kroah-Hartman <gregkh@suse.de>
+Description:
+                These files show the various USB TMC capabilities as described
+                by the device itself.  The full description of the bitfields
+                can be found in the USB TMC documents from the USB-IF entitled
+                "Universal Serial Bus Test and Measurement Class, Subclass
+                USB488 Specification (USBTMC-USB488) Revision 1.0" section
+                4.2.2.
+
+                The files are read only.
+
+
+What:           /sys/bus/usb/drivers/usbtmc/devices/*/TermChar
+Date:           August 2008
+Contact:        Greg Kroah-Hartman <gregkh@suse.de>
+Description:
+                This file is the TermChar value to be sent to the USB TMC
+                device as described by the document, "Universal Serial Bus Test
+                and Measurement Class Specification
+                (USBTMC) Revision 1.0" as published by the USB-IF.
+
+                Note that the TermCharEnabled file determines if this value is
+                sent to the device or not.
+
+
+What:           /sys/bus/usb/drivers/usbtmc/devices/*/TermCharEnabled
+Date:           August 2008
+Contact:        Greg Kroah-Hartman <gregkh@suse.de>
+Description:
+                This file determines if the TermChar is to be sent to the
+                device on every transaction or not.  For more details about
+                this, please see the document, "Universal Serial Bus Test and
+                Measurement Class Specification (USBTMC) Revision 1.0" as
+                published by the USB-IF.
+
+
+What:           /sys/bus/usb/drivers/usbtmc/devices/*/auto_abort
+Date:           August 2008
+Contact:        Greg Kroah-Hartman <gregkh@suse.de>
+Description:
+                This file determines if the the transaction of the USB TMC
+                device is to be automatically aborted if there is any error.
+                For more details about this, please see the document,
+                "Universal Serial Bus Test and Measurement Class Specification
+                (USBTMC) Revision 1.0" as published by the USB-IF.
diff --git a/Documentation/devices.txt b/Documentation/devices.txt
index 05c80645e4ee..2be08240ee80 100644
--- a/Documentation/devices.txt
+++ b/Documentation/devices.txt
@@ -2571,6 +2571,9 @@ Your cooperation is appreciated.
                 160 = /dev/usb/legousbtower0    1st USB Legotower device
                     ...
                 175 = /dev/usb/legousbtower15   16th USB Legotower device
+                176 = /dev/usb/usbtmc1  First USB TMC device
+                   ...
+                192 = /dev/usb/usbtmc16 16th USB TMC device
                 240 = /dev/usb/dabusb0  First daubusb device
                     ...
                 243 = /dev/usb/dabusb3  Fourth dabusb device
diff --git a/Documentation/ioctl-number.txt b/Documentation/ioctl-number.txt
index 1c6b545635a2..f8deb85eef6e 100644
--- a/Documentation/ioctl-number.txt
+++ b/Documentation/ioctl-number.txt
@@ -110,6 +110,8 @@ Code	Seq#	Include File		Comments
 'W'     00-1F   linux/wanrouter.h       conflict!
 'X'     all     linux/xfs_fs.h
 'Y'     all     linux/cyclades.h
+'['     00-07   linux/usb/usbtmc.h      USB Test and Measurement Devices
+                                        <mailto:gregkh@suse.de>
 'a'     all                             ATM on linux
                                         <http://lrcwww.epfl.ch/linux-atm/magic.html>
 'b'     00-FF                           bit3 vme host bridge