usb: misc: EHSET Test Fixture device driver for host compliance
authorManu Gautam <mgautam@codeaurora.org>
Wed, 3 Jul 2013 03:13:51 +0000 (20:13 -0700)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Thu, 25 Jul 2013 18:49:30 +0000 (11:49 -0700)
An Embedded Host High-Speed Electrical Test (EHSET) test fixture is
used to initiate test modes on a host controller in order to perform
the high speed electrical testing procedure for USB-IF compliance.
When this test fixture is connected to a host, it can enumerate as
one of several selectable VID/PID pairs, each corresponding to one
of the following test modes:

* TEST_SE0_NAK
* TEST_J
* TEST_K
* TEST_PACKET
* HS_HOST_PORT_SUSPEND_RESUME
* SINGLE_STEP_GET_DEV_DESC
* SINGLE_STEP_SET_FEATURE

The USB EHSET procedure can be found here:
http://www.usb.org/developers/onthego/EHSET_v1.01.pdf

Signed-off-by: Manu Gautam <mgautam@codeaurora.org>
[jackp@codeaurora.org: imported from commit 073c9409 on codeaurora.org;
 minor cleanup and updated author email]
Signed-off-by: Jack Pham <jackp@codeaurora.org>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
drivers/usb/misc/Kconfig
drivers/usb/misc/Makefile
drivers/usb/misc/ehset.c [new file with mode: 0644]

index a51e7d6afda97ab9bbf28a46fd788ca9c43602c6..ca91420f5c214e83244f91324a5667e6b9014c93 100644 (file)
@@ -200,6 +200,19 @@ config USB_TEST
          See <http://www.linux-usb.org/usbtest/> for more information,
          including sample test device firmware and "how to use it".
 
+config USB_EHSET_TEST_FIXTURE
+        tristate "USB EHSET Test Fixture driver"
+        help
+         Say Y here if you want to support the special test fixture device
+         used for the USB-IF Embedded Host High-Speed Electrical Test procedure.
+
+         When the test fixture is connected, it can enumerate as one of several
+         VID/PID pairs. This driver then initiates a corresponding test mode on
+         the downstream port to which the test fixture is attached.
+
+         See <http://www.usb.org/developers/onthego/EHSET_v1.01.pdf> for more
+         information.
+
 config USB_ISIGHTFW
        tristate "iSight firmware loading support"
        select FW_LOADER
index 5a896f3191183864b88d3bd0f564564d0b7af484..e748fd5dbe94e0f44f20f194cd7cc43756e2f821 100644 (file)
@@ -19,6 +19,7 @@ obj-$(CONFIG_USB_LED)                 += usbled.o
 obj-$(CONFIG_USB_LEGOTOWER)            += legousbtower.o
 obj-$(CONFIG_USB_RIO500)               += rio500.o
 obj-$(CONFIG_USB_TEST)                 += usbtest.o
+obj-$(CONFIG_USB_EHSET_TEST_FIXTURE)    += ehset.o
 obj-$(CONFIG_USB_TRANCEVIBRATOR)       += trancevibrator.o
 obj-$(CONFIG_USB_USS720)               += uss720.o
 obj-$(CONFIG_USB_SEVSEG)               += usbsevseg.o
diff --git a/drivers/usb/misc/ehset.c b/drivers/usb/misc/ehset.c
new file mode 100644 (file)
index 0000000..d2864b3
--- /dev/null
@@ -0,0 +1,134 @@
+/*
+ * Copyright (c) 2010-2013, The Linux Foundation. All rights reserved.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2 and
+ * only version 2 as published by the Free Software Foundation.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ */
+
+#include <linux/kernel.h>
+#include <linux/errno.h>
+#include <linux/module.h>
+#include <linux/slab.h>
+#include <linux/usb.h>
+#include <linux/usb/ch11.h>
+
+#define TEST_SE0_NAK_PID                       0x0101
+#define TEST_J_PID                             0x0102
+#define TEST_K_PID                             0x0103
+#define TEST_PACKET_PID                                0x0104
+#define TEST_HS_HOST_PORT_SUSPEND_RESUME       0x0106
+#define TEST_SINGLE_STEP_GET_DEV_DESC          0x0107
+#define TEST_SINGLE_STEP_SET_FEATURE           0x0108
+
+static int ehset_probe(struct usb_interface *intf,
+                      const struct usb_device_id *id)
+{
+       int ret = -EINVAL;
+       struct usb_device *dev = interface_to_usbdev(intf);
+       struct usb_device *hub_udev = dev->parent;
+       struct usb_device_descriptor *buf;
+       u8 portnum = dev->portnum;
+       u16 test_pid = le16_to_cpu(dev->descriptor.idProduct);
+
+       switch (test_pid) {
+       case TEST_SE0_NAK_PID:
+               ret = usb_control_msg(hub_udev, usb_sndctrlpipe(hub_udev, 0),
+                                       USB_REQ_SET_FEATURE, USB_RT_PORT,
+                                       USB_PORT_FEAT_TEST,
+                                       (TEST_SE0_NAK << 8) | portnum,
+                                       NULL, 0, 1000);
+               break;
+       case TEST_J_PID:
+               ret = usb_control_msg(hub_udev, usb_sndctrlpipe(hub_udev, 0),
+                                       USB_REQ_SET_FEATURE, USB_RT_PORT,
+                                       USB_PORT_FEAT_TEST,
+                                       (TEST_J << 8) | portnum,
+                                       NULL, 0, 1000);
+               break;
+       case TEST_K_PID:
+               ret = usb_control_msg(hub_udev, usb_sndctrlpipe(hub_udev, 0),
+                                       USB_REQ_SET_FEATURE, USB_RT_PORT,
+                                       USB_PORT_FEAT_TEST,
+                                       (TEST_K << 8) | portnum,
+                                       NULL, 0, 1000);
+               break;
+       case TEST_PACKET_PID:
+               ret = usb_control_msg(hub_udev, usb_sndctrlpipe(hub_udev, 0),
+                                       USB_REQ_SET_FEATURE, USB_RT_PORT,
+                                       USB_PORT_FEAT_TEST,
+                                       (TEST_PACKET << 8) | portnum,
+                                       NULL, 0, 1000);
+               break;
+       case TEST_HS_HOST_PORT_SUSPEND_RESUME:
+               /* Test: wait for 15secs -> suspend -> 15secs delay -> resume */
+               msleep(15 * 1000);
+               ret = usb_control_msg(hub_udev, usb_sndctrlpipe(hub_udev, 0),
+                                       USB_REQ_SET_FEATURE, USB_RT_PORT,
+                                       USB_PORT_FEAT_SUSPEND, portnum,
+                                       NULL, 0, 1000);
+               if (ret < 0)
+                       break;
+
+               msleep(15 * 1000);
+               ret = usb_control_msg(hub_udev, usb_sndctrlpipe(hub_udev, 0),
+                                       USB_REQ_CLEAR_FEATURE, USB_RT_PORT,
+                                       USB_PORT_FEAT_SUSPEND, portnum,
+                                       NULL, 0, 1000);
+               break;
+       case TEST_SINGLE_STEP_GET_DEV_DESC:
+               /* Test: wait for 15secs -> GetDescriptor request */
+               msleep(15 * 1000);
+               buf = kmalloc(USB_DT_DEVICE_SIZE, GFP_KERNEL);
+               if (!buf)
+                       return -ENOMEM;
+
+               ret = usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
+                                       USB_REQ_GET_DESCRIPTOR, USB_DIR_IN,
+                                       USB_DT_DEVICE << 8, 0,
+                                       buf, USB_DT_DEVICE_SIZE,
+                                       USB_CTRL_GET_TIMEOUT);
+               kfree(buf);
+               break;
+       case TEST_SINGLE_STEP_SET_FEATURE:
+               /* unsupported for now */
+       default:
+               dev_err(&intf->dev, "%s: unsupported PID: 0x%x\n",
+                       __func__, test_pid);
+       }
+
+       return (ret < 0) ? ret : 0;
+}
+
+static void ehset_disconnect(struct usb_interface *intf)
+{
+}
+
+static const struct usb_device_id ehset_id_table[] = {
+       { USB_DEVICE(0x1a0a, TEST_SE0_NAK_PID) },
+       { USB_DEVICE(0x1a0a, TEST_J_PID) },
+       { USB_DEVICE(0x1a0a, TEST_K_PID) },
+       { USB_DEVICE(0x1a0a, TEST_PACKET_PID) },
+       { USB_DEVICE(0x1a0a, TEST_HS_HOST_PORT_SUSPEND_RESUME) },
+       { USB_DEVICE(0x1a0a, TEST_SINGLE_STEP_GET_DEV_DESC) },
+       { USB_DEVICE(0x1a0a, TEST_SINGLE_STEP_SET_FEATURE) },
+       { }                     /* Terminating entry */
+};
+MODULE_DEVICE_TABLE(usb, ehset_id_table);
+
+static struct usb_driver ehset_driver = {
+       .name =         "usb_ehset_test",
+       .probe =        ehset_probe,
+       .disconnect =   ehset_disconnect,
+       .id_table =     ehset_id_table,
+};
+
+module_usb_driver(ehset_driver);
+
+MODULE_DESCRIPTION("USB Driver for EHSET Test Fixture");
+MODULE_LICENSE("GPL v2");