USB: add driver for Meywa-Denki & Kayac YUREX
authorTomoki Sekiyama <tomoki.sekiyama@gmail.com>
Wed, 29 Sep 2010 03:16:50 +0000 (12:16 +0900)
committerGreg Kroah-Hartman <gregkh@suse.de>
Fri, 22 Oct 2010 17:21:51 +0000 (10:21 -0700)
Meywa-Denki/Kayac YUREX is a leg-shakes sensor device.
See http://bbu.kayac.com/en/about/ for further information.
This driver support read/write the leg-shakes counter in the device
via a device file /dev/yurex[0-9]*.

[minor coding style cleanups fixed by gregkh]

Signed-off-by: Tomoki Sekiyama <tomoki.sekiyama@gmail.com>
Cc: Jiri Kosina <jkosina@suse.cz>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
drivers/hid/hid-core.c
drivers/hid/hid-ids.h
drivers/usb/misc/Kconfig
drivers/usb/misc/Makefile
drivers/usb/misc/yurex.c [new file with mode: 0644]

index a0dea3d..3cb6632 100644 (file)
@@ -1662,6 +1662,7 @@ static const struct hid_device_id hid_ignore_list[] = {
        { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1006) },
        { HID_USB_DEVICE(USB_VENDOR_ID_GTCO, USB_DEVICE_ID_GTCO_1007) },
        { HID_USB_DEVICE(USB_VENDOR_ID_IMATION, USB_DEVICE_ID_DISC_STAKKA) },
+       { HID_USB_DEVICE(USB_VENDOR_ID_JESS, USB_DEVICE_ID_JESS_YUREX) },
        { HID_USB_DEVICE(USB_VENDOR_ID_KBGEAR, USB_DEVICE_ID_KBGEAR_JAMSTUDIO) },
        { HID_USB_DEVICE(USB_VENDOR_ID_KWORLD, USB_DEVICE_ID_KWORLD_RADIO_FM700) },
        { HID_USB_DEVICE(USB_VENDOR_ID_KYE, USB_DEVICE_ID_KYE_GPEN_560) },
index c5ae5f1..855aa8e 100644 (file)
 #define USB_VENDOR_ID_IMATION          0x0718
 #define USB_DEVICE_ID_DISC_STAKKA      0xd000
 
+#define USB_VENDOR_ID_JESS             0x0c45
+#define USB_DEVICE_ID_JESS_YUREX       0x1010
+
 #define USB_VENDOR_ID_KBGEAR           0x084e
 #define USB_DEVICE_ID_KBGEAR_JAMSTUDIO 0x1001
 
index 55660ea..1bfcd02 100644 (file)
@@ -231,3 +231,16 @@ config USB_ISIGHTFW
          driver beforehand. Tools for doing so are available at
          http://bersace03.free.fr
 
+config USB_YUREX
+       tristate "USB YUREX driver support"
+       depends on USB
+       help
+         Say Y here if you want to connect a YUREX to your computer's
+         USB port. The YUREX is a leg-shakes sensor. See
+         <http://bbu.kayac.com/en/> for further information.
+         This driver supports read/write of leg-shakes counter and
+         fasync for the counter update via a device file /dev/yurex*.
+
+         To compile this driver as a module, choose M here: the
+         module will be called yurex.
+
index 717703e..d203ff6 100644 (file)
@@ -22,6 +22,7 @@ obj-$(CONFIG_USB_TEST)                += usbtest.o
 obj-$(CONFIG_USB_TRANCEVIBRATOR)       += trancevibrator.o
 obj-$(CONFIG_USB_USS720)       += uss720.o
 obj-$(CONFIG_USB_SEVSEG)       += usbsevseg.o
+obj-$(CONFIG_USB_YUREX)                += yurex.o
 
 obj-$(CONFIG_USB_SISUSBVGA)    += sisusbvga/
 
diff --git a/drivers/usb/misc/yurex.c b/drivers/usb/misc/yurex.c
new file mode 100644 (file)
index 0000000..76b8ab4
--- /dev/null
@@ -0,0 +1,552 @@
+/*
+ * Driver for Meywa-Denki & KAYAC YUREX
+ *
+ * Copyright (C) 2010 Tomoki Sekiyama (tomoki.sekiyama@gmail.com)
+ *
+ *     This program is free software; you can redistribute it and/or
+ *     modify it under the terms of the GNU General Public License as
+ *     published by the Free Software Foundation, version 2.
+ *
+ */
+
+#include <linux/kernel.h>
+#include <linux/errno.h>
+#include <linux/init.h>
+#include <linux/slab.h>
+#include <linux/module.h>
+#include <linux/kref.h>
+#include <linux/mutex.h>
+#include <linux/uaccess.h>
+#include <linux/usb.h>
+#include <linux/hid.h>
+
+#define DRIVER_AUTHOR "Tomoki Sekiyama"
+#define DRIVER_DESC "Driver for Meywa-Denki & KAYAC YUREX"
+
+#define YUREX_VENDOR_ID                0x0c45
+#define YUREX_PRODUCT_ID       0x1010
+
+#define CMD_ACK                '!'
+#define CMD_ANIMATE    'A'
+#define CMD_COUNT      'C'
+#define CMD_LED                'L'
+#define CMD_READ       'R'
+#define CMD_SET                'S'
+#define CMD_VERSION    'V'
+#define CMD_EOF                0x0d
+#define CMD_PADDING    0xff
+
+#define YUREX_BUF_SIZE         8
+#define YUREX_WRITE_TIMEOUT    (HZ)
+
+/* table of devices that work with this driver */
+static struct usb_device_id yurex_table[] = {
+       { USB_DEVICE(YUREX_VENDOR_ID, YUREX_PRODUCT_ID) },
+       { }                                     /* Terminating entry */
+};
+MODULE_DEVICE_TABLE(usb, yurex_table);
+
+#ifdef CONFIG_USB_DYNAMIC_MINORS
+#define YUREX_MINOR_BASE       0
+#else
+#define YUREX_MINOR_BASE       224  /* not official yet */
+#endif
+
+/* Structure to hold all of our device specific stuff */
+struct usb_yurex {
+       struct usb_device       *udev;
+       struct usb_interface    *interface;
+       __u8                    int_in_endpointAddr;
+       struct urb              *urb;           /* URB for interrupt in */
+       unsigned char           *int_buffer;    /* buffer for intterupt in */
+       struct urb              *cntl_urb;      /* URB for control msg */
+       struct usb_ctrlrequest  *cntl_req;      /* req for control msg */
+       unsigned char           *cntl_buffer;   /* buffer for control msg */
+
+       struct kref             kref;
+       struct mutex            io_mutex;
+       struct fasync_struct    *async_queue;
+       wait_queue_head_t       waitq;
+
+       spinlock_t              lock;
+       __s64                   bbu;            /* BBU from device */
+};
+#define to_yurex_dev(d) container_of(d, struct usb_yurex, kref)
+
+static struct usb_driver yurex_driver;
+static const struct file_operations yurex_fops;
+
+
+static void yurex_control_callback(struct urb *urb)
+{
+       struct usb_yurex *dev = urb->context;
+       int status = urb->status;
+
+       if (status) {
+               err("%s - control failed: %d¥n", __func__, status);
+               wake_up_interruptible(&dev->waitq);
+               return;
+       }
+       /* on success, sender woken up by CMD_ACK int in, or timeout */
+}
+
+static void yurex_delete(struct kref *kref)
+{
+       struct usb_yurex *dev = to_yurex_dev(kref);
+
+       dbg("yurex_delete");
+
+       usb_put_dev(dev->udev);
+       if (dev->urb) {
+               usb_kill_urb(dev->urb);
+               if (dev->int_buffer)
+                       usb_free_coherent(dev->udev, YUREX_BUF_SIZE,
+                               dev->int_buffer, dev->urb->transfer_dma);
+               usb_free_urb(dev->urb);
+       }
+       kfree(dev);
+}
+
+/*
+ * usb class driver info in order to get a minor number from the usb core,
+ * and to have the device registered with the driver core
+ */
+static struct usb_class_driver yurex_class = {
+       .name =         "yurex%d",
+       .fops =         &yurex_fops,
+       .minor_base =   YUREX_MINOR_BASE,
+};
+
+static void yurex_interrupt(struct urb *urb)
+{
+       struct usb_yurex *dev = urb->context;
+       unsigned char *buf = dev->int_buffer;
+       int status = urb->status;
+       unsigned long flags;
+       int retval, i;
+
+       switch (status) {
+       case 0: /*success*/
+               break;
+       case -EOVERFLOW:
+               err("%s - overflow with length %d, actual length is %d",
+                   __func__, YUREX_BUF_SIZE, dev->urb->actual_length);
+       case -ECONNRESET:
+       case -ENOENT:
+       case -ESHUTDOWN:
+       case -EILSEQ:
+               /* The device is terminated, clean up */
+               return;
+       default:
+               err("%s - unknown status received: %d", __func__, status);
+               goto exit;
+       }
+
+       /* handle received message */
+       switch (buf[0]) {
+       case CMD_COUNT:
+       case CMD_READ:
+               if (buf[6] == CMD_EOF) {
+                       spin_lock_irqsave(&dev->lock, flags);
+                       dev->bbu = 0;
+                       for (i = 1; i < 6; i++) {
+                               dev->bbu += buf[i];
+                               if (i != 5)
+                                       dev->bbu <<= 8;
+                       }
+                       dbg("%s count: %lld", __func__, dev->bbu);
+                       spin_unlock_irqrestore(&dev->lock, flags);
+
+                       kill_fasync(&dev->async_queue, SIGIO, POLL_IN);
+               }
+               else
+                       dbg("data format error - no EOF");
+               break;
+       case CMD_ACK:
+               dbg("%s ack: %c", __func__, buf[1]);
+               wake_up_interruptible(&dev->waitq);
+               break;
+       }
+
+exit:
+       retval = usb_submit_urb(dev->urb, GFP_ATOMIC);
+       if (retval) {
+               err("%s - usb_submit_urb failed: %d",
+                       __func__, retval);
+       }
+}
+
+static int yurex_probe(struct usb_interface *interface, const struct usb_device_id *id)
+{
+       struct usb_yurex *dev;
+       struct usb_host_interface *iface_desc;
+       struct usb_endpoint_descriptor *endpoint;
+       int retval = -ENOMEM;
+       int i;
+       DEFINE_WAIT(wait);
+
+       /* allocate memory for our device state and initialize it */
+       dev = kzalloc(sizeof(*dev), GFP_KERNEL);
+       if (!dev) {
+               err("Out of memory");
+               goto error;
+       }
+       kref_init(&dev->kref);
+       mutex_init(&dev->io_mutex);
+       spin_lock_init(&dev->lock);
+       init_waitqueue_head(&dev->waitq);
+
+       dev->udev = usb_get_dev(interface_to_usbdev(interface));
+       dev->interface = interface;
+
+       /* set up the endpoint information */
+       iface_desc = interface->cur_altsetting;
+       for (i = 0; i < iface_desc->desc.bNumEndpoints; i++) {
+               endpoint = &iface_desc->endpoint[i].desc;
+
+               if (usb_endpoint_is_int_in(endpoint)) {
+                       dev->int_in_endpointAddr = endpoint->bEndpointAddress;
+                       break;
+               }
+       }
+       if (!dev->int_in_endpointAddr) {
+               retval = -ENODEV;
+               err("Could not find endpoints");
+               goto error;
+       }
+
+
+       /* allocate control URB */
+       dev->cntl_urb = usb_alloc_urb(0, GFP_KERNEL);
+       if (!dev->cntl_urb) {
+               err("Could not allocate control URB");
+               goto error;
+       }
+
+       /* allocate buffer for control req */
+       dev->cntl_req = usb_alloc_coherent(dev->udev, YUREX_BUF_SIZE,
+                                          GFP_KERNEL,
+                                          &dev->cntl_urb->setup_dma);
+       if (!dev->cntl_req) {
+               err("Could not allocate cntl_req");
+               goto error;
+       }
+
+       /* allocate buffer for control msg */
+       dev->cntl_buffer = usb_alloc_coherent(dev->udev, YUREX_BUF_SIZE,
+                                             GFP_KERNEL,
+                                             &dev->cntl_urb->transfer_dma);
+       if (!dev->cntl_buffer) {
+               err("Could not allocate cntl_buffer");
+               goto error;
+       }
+
+       /* configure control URB */
+       dev->cntl_req->bRequestType = USB_DIR_OUT | USB_TYPE_CLASS |
+                                     USB_RECIP_INTERFACE;
+       dev->cntl_req->bRequest = HID_REQ_SET_REPORT;
+       dev->cntl_req->wValue   = cpu_to_le16((HID_OUTPUT_REPORT + 1) << 8);
+       dev->cntl_req->wIndex   = cpu_to_le16(iface_desc->desc.bInterfaceNumber);
+       dev->cntl_req->wLength  = cpu_to_le16(YUREX_BUF_SIZE);
+
+       usb_fill_control_urb(dev->cntl_urb, dev->udev,
+                            usb_sndctrlpipe(dev->udev, 0),
+                            (void *)dev->cntl_req, dev->cntl_buffer,
+                            YUREX_BUF_SIZE, yurex_control_callback, dev);
+       dev->cntl_urb->transfer_flags   |= URB_NO_TRANSFER_DMA_MAP;
+
+
+       /* allocate interrupt URB */
+       dev->urb = usb_alloc_urb(0, GFP_KERNEL);
+       if (!dev->urb) {
+               err("Could not allocate URB");
+               goto error;
+       }
+
+       /* allocate buffer for interrupt in */
+       dev->int_buffer = usb_alloc_coherent(dev->udev, YUREX_BUF_SIZE,
+                                       GFP_KERNEL, &dev->urb->transfer_dma);
+       if (!dev->int_buffer) {
+               err("Could not allocate int_buffer");
+               goto error;
+       }
+
+       /* configure interrupt URB */
+       usb_fill_int_urb(dev->urb, dev->udev,
+                        usb_rcvintpipe(dev->udev, dev->int_in_endpointAddr),
+                        dev->int_buffer, YUREX_BUF_SIZE, yurex_interrupt,
+                        dev, 1);
+       if (usb_submit_urb(dev->urb, GFP_KERNEL)) {
+               retval = -EIO;
+               err("Could not submitting URB");
+               goto error;
+       }
+
+       /* save our data pointer in this interface device */
+       usb_set_intfdata(interface, dev);
+
+       /* we can register the device now, as it is ready */
+       retval = usb_register_dev(interface, &yurex_class);
+       if (retval) {
+               err("Not able to get a minor for this device.");
+               usb_set_intfdata(interface, NULL);
+               goto error;
+       }
+
+       dev->bbu = -1;
+
+       dev_info(&interface->dev,
+                "USB Yurex device now attached to Yurex-%d¥n",
+                interface->minor);
+
+       return 0;
+
+error:
+       if (dev)
+               /* this frees allocated memory */
+               kref_put(&dev->kref, yurex_delete);
+       return retval;
+}
+
+static void yurex_disconnect(struct usb_interface *interface)
+{
+       struct usb_yurex *dev;
+       int minor = interface->minor;
+
+       dev = usb_get_intfdata(interface);
+       usb_set_intfdata(interface, NULL);
+
+       /* give back our minor */
+       usb_deregister_dev(interface, &yurex_class);
+
+       /* prevent more I/O from starting */
+       mutex_lock(&dev->io_mutex);
+       dev->interface = NULL;
+       mutex_unlock(&dev->io_mutex);
+
+       /* wakeup waiters */
+       kill_fasync(&dev->async_queue, SIGIO, POLL_IN);
+       wake_up_interruptible(&dev->waitq);
+
+       /* decrement our usage count */
+       kref_put(&dev->kref, yurex_delete);
+
+       dev_info(&interface->dev, "USB Yurex #%d now disconnected", minor);
+}
+
+static struct usb_driver yurex_driver = {
+       .name =         "yurex",
+       .probe =        yurex_probe,
+       .disconnect =   yurex_disconnect,
+       .id_table =     yurex_table,
+};
+
+
+static int yurex_fasync(int fd, struct file *file, int on)
+{
+       struct usb_yurex *dev;
+
+       dev = (struct usb_yurex *)file->private_data;
+       return fasync_helper(fd, file, on, &dev->async_queue);
+}
+
+static int yurex_open(struct inode *inode, struct file *file)
+{
+       struct usb_yurex *dev;
+       struct usb_interface *interface;
+       int subminor;
+       int retval = 0;
+
+       subminor = iminor(inode);
+
+       interface = usb_find_interface(&yurex_driver, subminor);
+       if (!interface) {
+               err("%s - error, can't find device for minor %d",
+                   __func__, subminor);
+               retval = -ENODEV;
+               goto exit;
+       }
+
+       dev = usb_get_intfdata(interface);
+       if (!dev) {
+               retval = -ENODEV;
+               goto exit;
+       }
+
+       /* increment our usage count for the device */
+       kref_get(&dev->kref);
+
+       /* save our object in the file's private structure */
+       mutex_lock(&dev->io_mutex);
+       file->private_data = dev;
+       mutex_unlock(&dev->io_mutex);
+
+exit:
+       return retval;
+}
+
+static int yurex_release(struct inode *inode, struct file *file)
+{
+       struct usb_yurex *dev;
+
+       dev = (struct usb_yurex *)file->private_data;
+       if (dev == NULL)
+               return -ENODEV;
+
+       yurex_fasync(-1, file, 0);
+
+       /* decrement the count on our device */
+       kref_put(&dev->kref, yurex_delete);
+       return 0;
+}
+
+static ssize_t yurex_read(struct file *file, char *buffer, size_t count, loff_t *ppos)
+{
+       struct usb_yurex *dev;
+       int retval = 0;
+       int bytes_read = 0;
+       char in_buffer[20];
+       unsigned long flags;
+
+       dev = (struct usb_yurex *)file->private_data;
+
+       mutex_lock(&dev->io_mutex);
+       if (!dev->interface) {          /* already disconnected */
+               retval = -ENODEV;
+               goto exit;
+       }
+
+       spin_lock_irqsave(&dev->lock, flags);
+       bytes_read = snprintf(in_buffer, 20, "%lld¥n", dev->bbu);
+       spin_unlock_irqrestore(&dev->lock, flags);
+
+       if (*ppos < bytes_read) {
+               if (copy_to_user(buffer, in_buffer + *ppos, bytes_read - *ppos))
+                       retval = -EFAULT;
+               else {
+                       retval = bytes_read - *ppos;
+                       *ppos += bytes_read;
+               }
+       }
+
+exit:
+       mutex_unlock(&dev->io_mutex);
+       return retval;
+}
+
+static ssize_t yurex_write(struct file *file, const char *user_buffer, size_t count, loff_t *ppos)
+{
+       struct usb_yurex *dev;
+       int i, set = 0, retval = 0;
+       char buffer[16];
+       char *data = buffer;
+       unsigned long long c, c2 = 0;
+       signed long timeout = 0;
+       DEFINE_WAIT(wait);
+
+       count = min(sizeof(buffer), count);
+       dev = (struct usb_yurex *)file->private_data;
+
+       /* verify that we actually have some data to write */
+       if (count == 0)
+               goto error;
+
+       mutex_lock(&dev->io_mutex);
+       if (!dev->interface) {          /* alreaday disconnected */
+               mutex_unlock(&dev->io_mutex);
+               retval = -ENODEV;
+               goto error;
+       }
+
+       if (copy_from_user(buffer, user_buffer, count)) {
+               mutex_unlock(&dev->io_mutex);
+               retval = -EFAULT;
+               goto error;
+       }
+       memset(dev->cntl_buffer, CMD_PADDING, YUREX_BUF_SIZE);
+
+       switch (buffer[0]) {
+       case CMD_ANIMATE:
+       case CMD_LED:
+               dev->cntl_buffer[0] = buffer[0];
+               dev->cntl_buffer[1] = buffer[1];
+               dev->cntl_buffer[2] = CMD_EOF;
+               break;
+       case CMD_READ:
+       case CMD_VERSION:
+               dev->cntl_buffer[0] = buffer[0];
+               dev->cntl_buffer[1] = 0x00;
+               dev->cntl_buffer[2] = CMD_EOF;
+               break;
+       case CMD_SET:
+               data++;
+               /* FALL THROUGH */
+       case '0' ... '9':
+               set = 1;
+               c = c2 = simple_strtoull(data, NULL, 0);
+               dev->cntl_buffer[0] = CMD_SET;
+               for (i = 1; i < 6; i++) {
+                       dev->cntl_buffer[i] = (c>>32) & 0xff;
+                       c <<= 8;
+               }
+               buffer[6] = CMD_EOF;
+               break;
+       default:
+               mutex_unlock(&dev->io_mutex);
+               return -EINVAL;
+       }
+
+       /* send the data as the control msg */
+       prepare_to_wait(&dev->waitq, &wait, TASK_INTERRUPTIBLE);
+       dbg("%s - submit %c", __func__, dev->cntl_buffer[0]);
+       retval = usb_submit_urb(dev->cntl_urb, GFP_KERNEL);
+       if (retval >= 0)
+               timeout = schedule_timeout(YUREX_WRITE_TIMEOUT);
+       finish_wait(&dev->waitq, &wait);
+
+       mutex_unlock(&dev->io_mutex);
+
+       if (retval < 0) {
+               err("%s - failed to send bulk msg, error %d", __func__, retval);
+               goto error;
+       }
+       if (set && timeout)
+               dev->bbu = c2;
+       return timeout ? count : -EIO;
+
+error:
+       return retval;
+}
+
+static const struct file_operations yurex_fops = {
+       .owner =        THIS_MODULE,
+       .read =         yurex_read,
+       .write =        yurex_write,
+       .open =         yurex_open,
+       .release =      yurex_release,
+       .fasync =       yurex_fasync,
+};
+
+
+static int __init usb_yurex_init(void)
+{
+       int result;
+
+       /* register this driver with the USB subsystem */
+       result = usb_register(&yurex_driver);
+       if (result)
+               err("usb_register failed. Error number %d", result);
+
+       return result;
+}
+
+static void __exit usb_yurex_exit(void)
+{
+       /* deregister this driver with the USB subsystem */
+       usb_deregister(&yurex_driver);
+}
+
+module_init(usb_yurex_init);
+module_exit(usb_yurex_exit);
+
+MODULE_LICENSE("GPL");