linux/drivers/usb/misc/iowarrior.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0
   2/*
   3 *  Native support for the I/O-Warrior USB devices
   4 *
   5 *  Copyright (c) 2003-2005  Code Mercenaries GmbH
   6 *  written by Christian Lucht <lucht@codemercs.com>
   7 *
   8 *  based on
   9
  10 *  usb-skeleton.c by Greg Kroah-Hartman  <greg@kroah.com>
  11 *  brlvger.c by Stephane Dalton  <sdalton@videotron.ca>
  12 *           and St�hane Doyon   <s.doyon@videotron.ca>
  13 *
  14 *  Released under the GPLv2.
  15 */
  16
  17#include <linux/module.h>
  18#include <linux/usb.h>
  19#include <linux/slab.h>
  20#include <linux/sched.h>
  21#include <linux/mutex.h>
  22#include <linux/poll.h>
  23#include <linux/usb/iowarrior.h>
  24
  25#define DRIVER_AUTHOR "Christian Lucht <lucht@codemercs.com>"
  26#define DRIVER_DESC "USB IO-Warrior driver"
  27
  28#define USB_VENDOR_ID_CODEMERCS         1984
  29/* low speed iowarrior */
  30#define USB_DEVICE_ID_CODEMERCS_IOW40   0x1500
  31#define USB_DEVICE_ID_CODEMERCS_IOW24   0x1501
  32#define USB_DEVICE_ID_CODEMERCS_IOWPV1  0x1511
  33#define USB_DEVICE_ID_CODEMERCS_IOWPV2  0x1512
  34/* full speed iowarrior */
  35#define USB_DEVICE_ID_CODEMERCS_IOW56   0x1503
  36
  37/* Get a minor range for your devices from the usb maintainer */
  38#ifdef CONFIG_USB_DYNAMIC_MINORS
  39#define IOWARRIOR_MINOR_BASE    0
  40#else
  41#define IOWARRIOR_MINOR_BASE    208     // SKELETON_MINOR_BASE 192 + 16, not official yet
  42#endif
  43
  44/* interrupt input queue size */
  45#define MAX_INTERRUPT_BUFFER 16
  46/*
  47   maximum number of urbs that are submitted for writes at the same time,
  48   this applies to the IOWarrior56 only!
  49   IOWarrior24 and IOWarrior40 use synchronous usb_control_msg calls.
  50*/
  51#define MAX_WRITES_IN_FLIGHT 4
  52
  53MODULE_AUTHOR(DRIVER_AUTHOR);
  54MODULE_DESCRIPTION(DRIVER_DESC);
  55MODULE_LICENSE("GPL");
  56
  57/* Module parameters */
  58static DEFINE_MUTEX(iowarrior_mutex);
  59
  60static struct usb_driver iowarrior_driver;
  61static DEFINE_MUTEX(iowarrior_open_disc_lock);
  62
  63/*--------------*/
  64/*     data     */
  65/*--------------*/
  66
  67/* Structure to hold all of our device specific stuff */
  68struct iowarrior {
  69        struct mutex mutex;                     /* locks this structure */
  70        struct usb_device *udev;                /* save off the usb device pointer */
  71        struct usb_interface *interface;        /* the interface for this device */
  72        unsigned char minor;                    /* the starting minor number for this device */
  73        struct usb_endpoint_descriptor *int_out_endpoint;       /* endpoint for reading (needed for IOW56 only) */
  74        struct usb_endpoint_descriptor *int_in_endpoint;        /* endpoint for reading */
  75        struct urb *int_in_urb;         /* the urb for reading data */
  76        unsigned char *int_in_buffer;   /* buffer for data to be read */
  77        unsigned char serial_number;    /* to detect lost packages */
  78        unsigned char *read_queue;      /* size is MAX_INTERRUPT_BUFFER * packet size */
  79        wait_queue_head_t read_wait;
  80        wait_queue_head_t write_wait;   /* wait-queue for writing to the device */
  81        atomic_t write_busy;            /* number of write-urbs submitted */
  82        atomic_t read_idx;
  83        atomic_t intr_idx;
  84        spinlock_t intr_idx_lock;       /* protects intr_idx */
  85        atomic_t overflow_flag;         /* signals an index 'rollover' */
  86        int present;                    /* this is 1 as long as the device is connected */
  87        int opened;                     /* this is 1 if the device is currently open */
  88        char chip_serial[9];            /* the serial number string of the chip connected */
  89        int report_size;                /* number of bytes in a report */
  90        u16 product_id;
  91};
  92
  93/*--------------*/
  94/*    globals   */
  95/*--------------*/
  96
  97/*
  98 *  USB spec identifies 5 second timeouts.
  99 */
 100#define GET_TIMEOUT 5
 101#define USB_REQ_GET_REPORT  0x01
 102//#if 0
 103static int usb_get_report(struct usb_device *dev,
 104                          struct usb_host_interface *inter, unsigned char type,
 105                          unsigned char id, void *buf, int size)
 106{
 107        return usb_control_msg(dev, usb_rcvctrlpipe(dev, 0),
 108                               USB_REQ_GET_REPORT,
 109                               USB_DIR_IN | USB_TYPE_CLASS |
 110                               USB_RECIP_INTERFACE, (type << 8) + id,
 111                               inter->desc.bInterfaceNumber, buf, size,
 112                               GET_TIMEOUT*HZ);
 113}
 114//#endif
 115
 116#define USB_REQ_SET_REPORT 0x09
 117
 118static int usb_set_report(struct usb_interface *intf, unsigned char type,
 119                          unsigned char id, void *buf, int size)
 120{
 121        return usb_control_msg(interface_to_usbdev(intf),
 122                               usb_sndctrlpipe(interface_to_usbdev(intf), 0),
 123                               USB_REQ_SET_REPORT,
 124                               USB_TYPE_CLASS | USB_RECIP_INTERFACE,
 125                               (type << 8) + id,
 126                               intf->cur_altsetting->desc.bInterfaceNumber, buf,
 127                               size, HZ);
 128}
 129
 130/*---------------------*/
 131/* driver registration */
 132/*---------------------*/
 133/* table of devices that work with this driver */
 134static const struct usb_device_id iowarrior_ids[] = {
 135        {USB_DEVICE(USB_VENDOR_ID_CODEMERCS, USB_DEVICE_ID_CODEMERCS_IOW40)},
 136        {USB_DEVICE(USB_VENDOR_ID_CODEMERCS, USB_DEVICE_ID_CODEMERCS_IOW24)},
 137        {USB_DEVICE(USB_VENDOR_ID_CODEMERCS, USB_DEVICE_ID_CODEMERCS_IOWPV1)},
 138        {USB_DEVICE(USB_VENDOR_ID_CODEMERCS, USB_DEVICE_ID_CODEMERCS_IOWPV2)},
 139        {USB_DEVICE(USB_VENDOR_ID_CODEMERCS, USB_DEVICE_ID_CODEMERCS_IOW56)},
 140        {}                      /* Terminating entry */
 141};
 142MODULE_DEVICE_TABLE(usb, iowarrior_ids);
 143
 144/*
 145 * USB callback handler for reading data
 146 */
 147static void iowarrior_callback(struct urb *urb)
 148{
 149        struct iowarrior *dev = urb->context;
 150        int intr_idx;
 151        int read_idx;
 152        int aux_idx;
 153        int offset;
 154        int status = urb->status;
 155        int retval;
 156
 157        switch (status) {
 158        case 0:
 159                /* success */
 160                break;
 161        case -ECONNRESET:
 162        case -ENOENT:
 163        case -ESHUTDOWN:
 164                return;
 165        default:
 166                goto exit;
 167        }
 168
 169        spin_lock(&dev->intr_idx_lock);
 170        intr_idx = atomic_read(&dev->intr_idx);
 171        /* aux_idx become previous intr_idx */
 172        aux_idx = (intr_idx == 0) ? (MAX_INTERRUPT_BUFFER - 1) : (intr_idx - 1);
 173        read_idx = atomic_read(&dev->read_idx);
 174
 175        /* queue is not empty and it's interface 0 */
 176        if ((intr_idx != read_idx)
 177            && (dev->interface->cur_altsetting->desc.bInterfaceNumber == 0)) {
 178                /* + 1 for serial number */
 179                offset = aux_idx * (dev->report_size + 1);
 180                if (!memcmp
 181                    (dev->read_queue + offset, urb->transfer_buffer,
 182                     dev->report_size)) {
 183                        /* equal values on interface 0 will be ignored */
 184                        spin_unlock(&dev->intr_idx_lock);
 185                        goto exit;
 186                }
 187        }
 188
 189        /* aux_idx become next intr_idx */
 190        aux_idx = (intr_idx == (MAX_INTERRUPT_BUFFER - 1)) ? 0 : (intr_idx + 1);
 191        if (read_idx == aux_idx) {
 192                /* queue full, dropping oldest input */
 193                read_idx = (++read_idx == MAX_INTERRUPT_BUFFER) ? 0 : read_idx;
 194                atomic_set(&dev->read_idx, read_idx);
 195                atomic_set(&dev->overflow_flag, 1);
 196        }
 197
 198        /* +1 for serial number */
 199        offset = intr_idx * (dev->report_size + 1);
 200        memcpy(dev->read_queue + offset, urb->transfer_buffer,
 201               dev->report_size);
 202        *(dev->read_queue + offset + (dev->report_size)) = dev->serial_number++;
 203
 204        atomic_set(&dev->intr_idx, aux_idx);
 205        spin_unlock(&dev->intr_idx_lock);
 206        /* tell the blocking read about the new data */
 207        wake_up_interruptible(&dev->read_wait);
 208
 209exit:
 210        retval = usb_submit_urb(urb, GFP_ATOMIC);
 211        if (retval)
 212                dev_err(&dev->interface->dev, "%s - usb_submit_urb failed with result %d\n",
 213                        __func__, retval);
 214
 215}
 216
 217/*
 218 * USB Callback handler for write-ops
 219 */
 220static void iowarrior_write_callback(struct urb *urb)
 221{
 222        struct iowarrior *dev;
 223        int status = urb->status;
 224
 225        dev = urb->context;
 226        /* sync/async unlink faults aren't errors */
 227        if (status &&
 228            !(status == -ENOENT ||
 229              status == -ECONNRESET || status == -ESHUTDOWN)) {
 230                dev_dbg(&dev->interface->dev,
 231                        "nonzero write bulk status received: %d\n", status);
 232        }
 233        /* free up our allocated buffer */
 234        usb_free_coherent(urb->dev, urb->transfer_buffer_length,
 235                          urb->transfer_buffer, urb->transfer_dma);
 236        /* tell a waiting writer the interrupt-out-pipe is available again */
 237        atomic_dec(&dev->write_busy);
 238        wake_up_interruptible(&dev->write_wait);
 239}
 240
 241/**
 242 *      iowarrior_delete
 243 */
 244static inline void iowarrior_delete(struct iowarrior *dev)
 245{
 246        dev_dbg(&dev->interface->dev, "minor %d\n", dev->minor);
 247        kfree(dev->int_in_buffer);
 248        usb_free_urb(dev->int_in_urb);
 249        kfree(dev->read_queue);
 250        kfree(dev);
 251}
 252
 253/*---------------------*/
 254/* fops implementation */
 255/*---------------------*/
 256
 257static int read_index(struct iowarrior *dev)
 258{
 259        int intr_idx, read_idx;
 260
 261        read_idx = atomic_read(&dev->read_idx);
 262        intr_idx = atomic_read(&dev->intr_idx);
 263
 264        return (read_idx == intr_idx ? -1 : read_idx);
 265}
 266
 267/**
 268 *  iowarrior_read
 269 */
 270static ssize_t iowarrior_read(struct file *file, char __user *buffer,
 271                              size_t count, loff_t *ppos)
 272{
 273        struct iowarrior *dev;
 274        int read_idx;
 275        int offset;
 276
 277        dev = file->private_data;
 278
 279        /* verify that the device wasn't unplugged */
 280        if (!dev || !dev->present)
 281                return -ENODEV;
 282
 283        dev_dbg(&dev->interface->dev, "minor %d, count = %zd\n",
 284                dev->minor, count);
 285
 286        /* read count must be packet size (+ time stamp) */
 287        if ((count != dev->report_size)
 288            && (count != (dev->report_size + 1)))
 289                return -EINVAL;
 290
 291        /* repeat until no buffer overrun in callback handler occur */
 292        do {
 293                atomic_set(&dev->overflow_flag, 0);
 294                if ((read_idx = read_index(dev)) == -1) {
 295                        /* queue empty */
 296                        if (file->f_flags & O_NONBLOCK)
 297                                return -EAGAIN;
 298                        else {
 299                                //next line will return when there is either new data, or the device is unplugged
 300                                int r = wait_event_interruptible(dev->read_wait,
 301                                                                 (!dev->present
 302                                                                  || (read_idx =
 303                                                                      read_index
 304                                                                      (dev)) !=
 305                                                                  -1));
 306                                if (r) {
 307                                        //we were interrupted by a signal
 308                                        return -ERESTART;
 309                                }
 310                                if (!dev->present) {
 311                                        //The device was unplugged
 312                                        return -ENODEV;
 313                                }
 314                                if (read_idx == -1) {
 315                                        // Can this happen ???
 316                                        return 0;
 317                                }
 318                        }
 319                }
 320
 321                offset = read_idx * (dev->report_size + 1);
 322                if (copy_to_user(buffer, dev->read_queue + offset, count)) {
 323                        return -EFAULT;
 324                }
 325        } while (atomic_read(&dev->overflow_flag));
 326
 327        read_idx = ++read_idx == MAX_INTERRUPT_BUFFER ? 0 : read_idx;
 328        atomic_set(&dev->read_idx, read_idx);
 329        return count;
 330}
 331
 332/*
 333 * iowarrior_write
 334 */
 335static ssize_t iowarrior_write(struct file *file,
 336                               const char __user *user_buffer,
 337                               size_t count, loff_t *ppos)
 338{
 339        struct iowarrior *dev;
 340        int retval = 0;
 341        char *buf = NULL;       /* for IOW24 and IOW56 we need a buffer */
 342        struct urb *int_out_urb = NULL;
 343
 344        dev = file->private_data;
 345
 346        mutex_lock(&dev->mutex);
 347        /* verify that the device wasn't unplugged */
 348        if (!dev->present) {
 349                retval = -ENODEV;
 350                goto exit;
 351        }
 352        dev_dbg(&dev->interface->dev, "minor %d, count = %zd\n",
 353                dev->minor, count);
 354        /* if count is 0 we're already done */
 355        if (count == 0) {
 356                retval = 0;
 357                goto exit;
 358        }
 359        /* We only accept full reports */
 360        if (count != dev->report_size) {
 361                retval = -EINVAL;
 362                goto exit;
 363        }
 364        switch (dev->product_id) {
 365        case USB_DEVICE_ID_CODEMERCS_IOW24:
 366        case USB_DEVICE_ID_CODEMERCS_IOWPV1:
 367        case USB_DEVICE_ID_CODEMERCS_IOWPV2:
 368        case USB_DEVICE_ID_CODEMERCS_IOW40:
 369                /* IOW24 and IOW40 use a synchronous call */
 370                buf = memdup_user(user_buffer, count);
 371                if (IS_ERR(buf)) {
 372                        retval = PTR_ERR(buf);
 373                        goto exit;
 374                }
 375                retval = usb_set_report(dev->interface, 2, 0, buf, count);
 376                kfree(buf);
 377                goto exit;
 378                break;
 379        case USB_DEVICE_ID_CODEMERCS_IOW56:
 380                /* The IOW56 uses asynchronous IO and more urbs */
 381                if (atomic_read(&dev->write_busy) == MAX_WRITES_IN_FLIGHT) {
 382                        /* Wait until we are below the limit for submitted urbs */
 383                        if (file->f_flags & O_NONBLOCK) {
 384                                retval = -EAGAIN;
 385                                goto exit;
 386                        } else {
 387                                retval = wait_event_interruptible(dev->write_wait,
 388                                                                  (!dev->present || (atomic_read (&dev-> write_busy) < MAX_WRITES_IN_FLIGHT)));
 389                                if (retval) {
 390                                        /* we were interrupted by a signal */
 391                                        retval = -ERESTART;
 392                                        goto exit;
 393                                }
 394                                if (!dev->present) {
 395                                        /* The device was unplugged */
 396                                        retval = -ENODEV;
 397                                        goto exit;
 398                                }
 399                                if (!dev->opened) {
 400                                        /* We were closed while waiting for an URB */
 401                                        retval = -ENODEV;
 402                                        goto exit;
 403                                }
 404                        }
 405                }
 406                atomic_inc(&dev->write_busy);
 407                int_out_urb = usb_alloc_urb(0, GFP_KERNEL);
 408                if (!int_out_urb) {
 409                        retval = -ENOMEM;
 410                        goto error_no_urb;
 411                }
 412                buf = usb_alloc_coherent(dev->udev, dev->report_size,
 413                                         GFP_KERNEL, &int_out_urb->transfer_dma);
 414                if (!buf) {
 415                        retval = -ENOMEM;
 416                        dev_dbg(&dev->interface->dev,
 417                                "Unable to allocate buffer\n");
 418                        goto error_no_buffer;
 419                }
 420                usb_fill_int_urb(int_out_urb, dev->udev,
 421                                 usb_sndintpipe(dev->udev,
 422                                                dev->int_out_endpoint->bEndpointAddress),
 423                                 buf, dev->report_size,
 424                                 iowarrior_write_callback, dev,
 425                                 dev->int_out_endpoint->bInterval);
 426                int_out_urb->transfer_flags |= URB_NO_TRANSFER_DMA_MAP;
 427                if (copy_from_user(buf, user_buffer, count)) {
 428                        retval = -EFAULT;
 429                        goto error;
 430                }
 431                retval = usb_submit_urb(int_out_urb, GFP_KERNEL);
 432                if (retval) {
 433                        dev_dbg(&dev->interface->dev,
 434                                "submit error %d for urb nr.%d\n",
 435                                retval, atomic_read(&dev->write_busy));
 436                        goto error;
 437                }
 438                /* submit was ok */
 439                retval = count;
 440                usb_free_urb(int_out_urb);
 441                goto exit;
 442                break;
 443        default:
 444                /* what do we have here ? An unsupported Product-ID ? */
 445                dev_err(&dev->interface->dev, "%s - not supported for product=0x%x\n",
 446                        __func__, dev->product_id);
 447                retval = -EFAULT;
 448                goto exit;
 449                break;
 450        }
 451error:
 452        usb_free_coherent(dev->udev, dev->report_size, buf,
 453                          int_out_urb->transfer_dma);
 454error_no_buffer:
 455        usb_free_urb(int_out_urb);
 456error_no_urb:
 457        atomic_dec(&dev->write_busy);
 458        wake_up_interruptible(&dev->write_wait);
 459exit:
 460        mutex_unlock(&dev->mutex);
 461        return retval;
 462}
 463
 464/**
 465 *      iowarrior_ioctl
 466 */
 467static long iowarrior_ioctl(struct file *file, unsigned int cmd,
 468                                                        unsigned long arg)
 469{
 470        struct iowarrior *dev = NULL;
 471        __u8 *buffer;
 472        __u8 __user *user_buffer;
 473        int retval;
 474        int io_res;             /* checks for bytes read/written and copy_to/from_user results */
 475
 476        dev = file->private_data;
 477        if (!dev)
 478                return -ENODEV;
 479
 480        buffer = kzalloc(dev->report_size, GFP_KERNEL);
 481        if (!buffer)
 482                return -ENOMEM;
 483
 484        /* lock this object */
 485        mutex_lock(&iowarrior_mutex);
 486        mutex_lock(&dev->mutex);
 487
 488        /* verify that the device wasn't unplugged */
 489        if (!dev->present) {
 490                retval = -ENODEV;
 491                goto error_out;
 492        }
 493
 494        dev_dbg(&dev->interface->dev, "minor %d, cmd 0x%.4x, arg %ld\n",
 495                dev->minor, cmd, arg);
 496
 497        retval = 0;
 498        io_res = 0;
 499        switch (cmd) {
 500        case IOW_WRITE:
 501                if (dev->product_id == USB_DEVICE_ID_CODEMERCS_IOW24 ||
 502                    dev->product_id == USB_DEVICE_ID_CODEMERCS_IOWPV1 ||
 503                    dev->product_id == USB_DEVICE_ID_CODEMERCS_IOWPV2 ||
 504                    dev->product_id == USB_DEVICE_ID_CODEMERCS_IOW40) {
 505                        user_buffer = (__u8 __user *)arg;
 506                        io_res = copy_from_user(buffer, user_buffer,
 507                                                dev->report_size);
 508                        if (io_res) {
 509                                retval = -EFAULT;
 510                        } else {
 511                                io_res = usb_set_report(dev->interface, 2, 0,
 512                                                        buffer,
 513                                                        dev->report_size);
 514                                if (io_res < 0)
 515                                        retval = io_res;
 516                        }
 517                } else {
 518                        retval = -EINVAL;
 519                        dev_err(&dev->interface->dev,
 520                                "ioctl 'IOW_WRITE' is not supported for product=0x%x.\n",
 521                                dev->product_id);
 522                }
 523                break;
 524        case IOW_READ:
 525                user_buffer = (__u8 __user *)arg;
 526                io_res = usb_get_report(dev->udev,
 527                                        dev->interface->cur_altsetting, 1, 0,
 528                                        buffer, dev->report_size);
 529                if (io_res < 0)
 530                        retval = io_res;
 531                else {
 532                        io_res = copy_to_user(user_buffer, buffer, dev->report_size);
 533                        if (io_res)
 534                                retval = -EFAULT;
 535                }
 536                break;
 537        case IOW_GETINFO:
 538                {
 539                        /* Report available information for the device */
 540                        struct iowarrior_info info;
 541                        /* needed for power consumption */
 542                        struct usb_config_descriptor *cfg_descriptor = &dev->udev->actconfig->desc;
 543
 544                        memset(&info, 0, sizeof(info));
 545                        /* directly from the descriptor */
 546                        info.vendor = le16_to_cpu(dev->udev->descriptor.idVendor);
 547                        info.product = dev->product_id;
 548                        info.revision = le16_to_cpu(dev->udev->descriptor.bcdDevice);
 549
 550                        /* 0==UNKNOWN, 1==LOW(usb1.1) ,2=FULL(usb1.1), 3=HIGH(usb2.0) */
 551                        info.speed = dev->udev->speed;
 552                        info.if_num = dev->interface->cur_altsetting->desc.bInterfaceNumber;
 553                        info.report_size = dev->report_size;
 554
 555                        /* serial number string has been read earlier 8 chars or empty string */
 556                        memcpy(info.serial, dev->chip_serial,
 557                               sizeof(dev->chip_serial));
 558                        if (cfg_descriptor == NULL) {
 559                                info.power = -1;        /* no information available */
 560                        } else {
 561                                /* the MaxPower is stored in units of 2mA to make it fit into a byte-value */
 562                                info.power = cfg_descriptor->bMaxPower * 2;
 563                        }
 564                        io_res = copy_to_user((struct iowarrior_info __user *)arg, &info,
 565                                         sizeof(struct iowarrior_info));
 566                        if (io_res)
 567                                retval = -EFAULT;
 568                        break;
 569                }
 570        default:
 571                /* return that we did not understand this ioctl call */
 572                retval = -ENOTTY;
 573                break;
 574        }
 575error_out:
 576        /* unlock the device */
 577        mutex_unlock(&dev->mutex);
 578        mutex_unlock(&iowarrior_mutex);
 579        kfree(buffer);
 580        return retval;
 581}
 582
 583/**
 584 *      iowarrior_open
 585 */
 586static int iowarrior_open(struct inode *inode, struct file *file)
 587{
 588        struct iowarrior *dev = NULL;
 589        struct usb_interface *interface;
 590        int subminor;
 591        int retval = 0;
 592
 593        mutex_lock(&iowarrior_mutex);
 594        subminor = iminor(inode);
 595
 596        interface = usb_find_interface(&iowarrior_driver, subminor);
 597        if (!interface) {
 598                mutex_unlock(&iowarrior_mutex);
 599                printk(KERN_ERR "%s - error, can't find device for minor %d\n",
 600                       __func__, subminor);
 601                return -ENODEV;
 602        }
 603
 604        mutex_lock(&iowarrior_open_disc_lock);
 605        dev = usb_get_intfdata(interface);
 606        if (!dev) {
 607                mutex_unlock(&iowarrior_open_disc_lock);
 608                mutex_unlock(&iowarrior_mutex);
 609                return -ENODEV;
 610        }
 611
 612        mutex_lock(&dev->mutex);
 613        mutex_unlock(&iowarrior_open_disc_lock);
 614
 615        /* Only one process can open each device, no sharing. */
 616        if (dev->opened) {
 617                retval = -EBUSY;
 618                goto out;
 619        }
 620
 621        /* setup interrupt handler for receiving values */
 622        if ((retval = usb_submit_urb(dev->int_in_urb, GFP_KERNEL)) < 0) {
 623                dev_err(&interface->dev, "Error %d while submitting URB\n", retval);
 624                retval = -EFAULT;
 625                goto out;
 626        }
 627        /* increment our usage count for the driver */
 628        ++dev->opened;
 629        /* save our object in the file's private structure */
 630        file->private_data = dev;
 631        retval = 0;
 632
 633out:
 634        mutex_unlock(&dev->mutex);
 635        mutex_unlock(&iowarrior_mutex);
 636        return retval;
 637}
 638
 639/**
 640 *      iowarrior_release
 641 */
 642static int iowarrior_release(struct inode *inode, struct file *file)
 643{
 644        struct iowarrior *dev;
 645        int retval = 0;
 646
 647        dev = file->private_data;
 648        if (!dev)
 649                return -ENODEV;
 650
 651        dev_dbg(&dev->interface->dev, "minor %d\n", dev->minor);
 652
 653        /* lock our device */
 654        mutex_lock(&dev->mutex);
 655
 656        if (dev->opened <= 0) {
 657                retval = -ENODEV;       /* close called more than once */
 658                mutex_unlock(&dev->mutex);
 659        } else {
 660                dev->opened = 0;        /* we're closing now */
 661                retval = 0;
 662                if (dev->present) {
 663                        /*
 664                           The device is still connected so we only shutdown
 665                           pending read-/write-ops.
 666                         */
 667                        usb_kill_urb(dev->int_in_urb);
 668                        wake_up_interruptible(&dev->read_wait);
 669                        wake_up_interruptible(&dev->write_wait);
 670                        mutex_unlock(&dev->mutex);
 671                } else {
 672                        /* The device was unplugged, cleanup resources */
 673                        mutex_unlock(&dev->mutex);
 674                        iowarrior_delete(dev);
 675                }
 676        }
 677        return retval;
 678}
 679
 680static __poll_t iowarrior_poll(struct file *file, poll_table * wait)
 681{
 682        struct iowarrior *dev = file->private_data;
 683        __poll_t mask = 0;
 684
 685        if (!dev->present)
 686                return EPOLLERR | EPOLLHUP;
 687
 688        poll_wait(file, &dev->read_wait, wait);
 689        poll_wait(file, &dev->write_wait, wait);
 690
 691        if (!dev->present)
 692                return EPOLLERR | EPOLLHUP;
 693
 694        if (read_index(dev) != -1)
 695                mask |= EPOLLIN | EPOLLRDNORM;
 696
 697        if (atomic_read(&dev->write_busy) < MAX_WRITES_IN_FLIGHT)
 698                mask |= EPOLLOUT | EPOLLWRNORM;
 699        return mask;
 700}
 701
 702/*
 703 * File operations needed when we register this driver.
 704 * This assumes that this driver NEEDS file operations,
 705 * of course, which means that the driver is expected
 706 * to have a node in the /dev directory. If the USB
 707 * device were for a network interface then the driver
 708 * would use "struct net_driver" instead, and a serial
 709 * device would use "struct tty_driver".
 710 */
 711static const struct file_operations iowarrior_fops = {
 712        .owner = THIS_MODULE,
 713        .write = iowarrior_write,
 714        .read = iowarrior_read,
 715        .unlocked_ioctl = iowarrior_ioctl,
 716        .open = iowarrior_open,
 717        .release = iowarrior_release,
 718        .poll = iowarrior_poll,
 719        .llseek = noop_llseek,
 720};
 721
 722static char *iowarrior_devnode(struct device *dev, umode_t *mode)
 723{
 724        return kasprintf(GFP_KERNEL, "usb/%s", dev_name(dev));
 725}
 726
 727/*
 728 * usb class driver info in order to get a minor number from the usb core,
 729 * and to have the device registered with devfs and the driver core
 730 */
 731static struct usb_class_driver iowarrior_class = {
 732        .name = "iowarrior%d",
 733        .devnode = iowarrior_devnode,
 734        .fops = &iowarrior_fops,
 735        .minor_base = IOWARRIOR_MINOR_BASE,
 736};
 737
 738/*---------------------------------*/
 739/*  probe and disconnect functions */
 740/*---------------------------------*/
 741/**
 742 *      iowarrior_probe
 743 *
 744 *      Called by the usb core when a new device is connected that it thinks
 745 *      this driver might be interested in.
 746 */
 747static int iowarrior_probe(struct usb_interface *interface,
 748                           const struct usb_device_id *id)
 749{
 750        struct usb_device *udev = interface_to_usbdev(interface);
 751        struct iowarrior *dev = NULL;
 752        struct usb_host_interface *iface_desc;
 753        int retval = -ENOMEM;
 754        int res;
 755
 756        /* allocate memory for our device state and initialize it */
 757        dev = kzalloc(sizeof(struct iowarrior), GFP_KERNEL);
 758        if (!dev)
 759                return retval;
 760
 761        mutex_init(&dev->mutex);
 762
 763        atomic_set(&dev->intr_idx, 0);
 764        atomic_set(&dev->read_idx, 0);
 765        spin_lock_init(&dev->intr_idx_lock);
 766        atomic_set(&dev->overflow_flag, 0);
 767        init_waitqueue_head(&dev->read_wait);
 768        atomic_set(&dev->write_busy, 0);
 769        init_waitqueue_head(&dev->write_wait);
 770
 771        dev->udev = udev;
 772        dev->interface = interface;
 773
 774        iface_desc = interface->cur_altsetting;
 775        dev->product_id = le16_to_cpu(udev->descriptor.idProduct);
 776
 777        res = usb_find_last_int_in_endpoint(iface_desc, &dev->int_in_endpoint);
 778        if (res) {
 779                dev_err(&interface->dev, "no interrupt-in endpoint found\n");
 780                retval = res;
 781                goto error;
 782        }
 783
 784        if (dev->product_id == USB_DEVICE_ID_CODEMERCS_IOW56) {
 785                res = usb_find_last_int_out_endpoint(iface_desc,
 786                                &dev->int_out_endpoint);
 787                if (res) {
 788                        dev_err(&interface->dev, "no interrupt-out endpoint found\n");
 789                        retval = res;
 790                        goto error;
 791                }
 792        }
 793
 794        /* we have to check the report_size often, so remember it in the endianness suitable for our machine */
 795        dev->report_size = usb_endpoint_maxp(dev->int_in_endpoint);
 796        if ((dev->interface->cur_altsetting->desc.bInterfaceNumber == 0) &&
 797            (dev->product_id == USB_DEVICE_ID_CODEMERCS_IOW56))
 798                /* IOWarrior56 has wMaxPacketSize different from report size */
 799                dev->report_size = 7;
 800
 801        /* create the urb and buffer for reading */
 802        dev->int_in_urb = usb_alloc_urb(0, GFP_KERNEL);
 803        if (!dev->int_in_urb)
 804                goto error;
 805        dev->int_in_buffer = kmalloc(dev->report_size, GFP_KERNEL);
 806        if (!dev->int_in_buffer)
 807                goto error;
 808        usb_fill_int_urb(dev->int_in_urb, dev->udev,
 809                         usb_rcvintpipe(dev->udev,
 810                                        dev->int_in_endpoint->bEndpointAddress),
 811                         dev->int_in_buffer, dev->report_size,
 812                         iowarrior_callback, dev,
 813                         dev->int_in_endpoint->bInterval);
 814        /* create an internal buffer for interrupt data from the device */
 815        dev->read_queue =
 816            kmalloc(((dev->report_size + 1) * MAX_INTERRUPT_BUFFER),
 817                    GFP_KERNEL);
 818        if (!dev->read_queue)
 819                goto error;
 820        /* Get the serial-number of the chip */
 821        memset(dev->chip_serial, 0x00, sizeof(dev->chip_serial));
 822        usb_string(udev, udev->descriptor.iSerialNumber, dev->chip_serial,
 823                   sizeof(dev->chip_serial));
 824        if (strlen(dev->chip_serial) != 8)
 825                memset(dev->chip_serial, 0x00, sizeof(dev->chip_serial));
 826
 827        /* Set the idle timeout to 0, if this is interface 0 */
 828        if (dev->interface->cur_altsetting->desc.bInterfaceNumber == 0) {
 829            usb_control_msg(udev, usb_sndctrlpipe(udev, 0),
 830                            0x0A,
 831                            USB_TYPE_CLASS | USB_RECIP_INTERFACE, 0,
 832                            0, NULL, 0, USB_CTRL_SET_TIMEOUT);
 833        }
 834        /* allow device read and ioctl */
 835        dev->present = 1;
 836
 837        /* we can register the device now, as it is ready */
 838        usb_set_intfdata(interface, dev);
 839
 840        retval = usb_register_dev(interface, &iowarrior_class);
 841        if (retval) {
 842                /* something prevented us from registering this driver */
 843                dev_err(&interface->dev, "Not able to get a minor for this device.\n");
 844                usb_set_intfdata(interface, NULL);
 845                goto error;
 846        }
 847
 848        dev->minor = interface->minor;
 849
 850        /* let the user know what node this device is now attached to */
 851        dev_info(&interface->dev, "IOWarrior product=0x%x, serial=%s interface=%d "
 852                 "now attached to iowarrior%d\n", dev->product_id, dev->chip_serial,
 853                 iface_desc->desc.bInterfaceNumber, dev->minor - IOWARRIOR_MINOR_BASE);
 854        return retval;
 855
 856error:
 857        iowarrior_delete(dev);
 858        return retval;
 859}
 860
 861/**
 862 *      iowarrior_disconnect
 863 *
 864 *      Called by the usb core when the device is removed from the system.
 865 */
 866static void iowarrior_disconnect(struct usb_interface *interface)
 867{
 868        struct iowarrior *dev;
 869        int minor;
 870
 871        dev = usb_get_intfdata(interface);
 872        mutex_lock(&iowarrior_open_disc_lock);
 873        usb_set_intfdata(interface, NULL);
 874
 875        minor = dev->minor;
 876
 877        /* give back our minor */
 878        usb_deregister_dev(interface, &iowarrior_class);
 879
 880        mutex_lock(&dev->mutex);
 881
 882        /* prevent device read, write and ioctl */
 883        dev->present = 0;
 884
 885        mutex_unlock(&dev->mutex);
 886        mutex_unlock(&iowarrior_open_disc_lock);
 887
 888        if (dev->opened) {
 889                /* There is a process that holds a filedescriptor to the device ,
 890                   so we only shutdown read-/write-ops going on.
 891                   Deleting the device is postponed until close() was called.
 892                 */
 893                usb_kill_urb(dev->int_in_urb);
 894                wake_up_interruptible(&dev->read_wait);
 895                wake_up_interruptible(&dev->write_wait);
 896        } else {
 897                /* no process is using the device, cleanup now */
 898                iowarrior_delete(dev);
 899        }
 900
 901        dev_info(&interface->dev, "I/O-Warror #%d now disconnected\n",
 902                 minor - IOWARRIOR_MINOR_BASE);
 903}
 904
 905/* usb specific object needed to register this driver with the usb subsystem */
 906static struct usb_driver iowarrior_driver = {
 907        .name = "iowarrior",
 908        .probe = iowarrior_probe,
 909        .disconnect = iowarrior_disconnect,
 910        .id_table = iowarrior_ids,
 911};
 912
 913module_usb_driver(iowarrior_driver);
 914