drivers/usb/gadget/dummy_hcd.c

   1 /*
   2  * dummy_hcd.c -- Dummy/Loopback USB host and device emulator driver.
   3  *
   4  * Maintainer: Alan Stern <stern@rowland.harvard.edu>
   5  *
   6  * Copyright (C) 2003 David Brownell
   7  * Copyright (C) 2003, 2004 Alan Stern
   8  *
   9  * This program is free software; you can redistribute it and/or modify
  10  * it under the terms of the GNU General Public License as published by
  11  * the Free Software Foundation; either version 2 of the License, or
  12  * (at your option) any later version.
  13  *
  14  * This program is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  * GNU General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU General Public License
  20  * along with this program; if not, write to the Free Software
  21  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  22  */
  23
  24
  25 /*
  26  * This exposes a device side "USB gadget" API, driven by requests to a
  27  * Linux-USB host controller driver.  USB traffic is simulated; there's
  28  * no need for USB hardware.  Use this with two other drivers:
  29  *
  30  *  - Gadget driver, responding to requests (slave);
  31  *  - Host-side device driver, as already familiar in Linux.
  32  *
  33  * Having this all in one kernel can help some stages of development,
  34  * bypassing some hardware (and driver) issues.  UML could help too.
  35  */
  36
  37 #define DEBUG
  38
  39 #include <linux/config.h>
  40 #include <linux/module.h>
  41 #include <linux/kernel.h>
  42 #include <linux/delay.h>
  43 #include <linux/ioport.h>
  44 #include <linux/sched.h>
  45 #include <linux/slab.h>
  46 #include <linux/smp_lock.h>
  47 #include <linux/errno.h>
  48 #include <linux/init.h>
  49 #include <linux/timer.h>
  50 #include <linux/list.h>
  51 #include <linux/interrupt.h>
  52 #include <linux/version.h>
  53
  54 #include <linux/usb.h>
  55 #include <linux/usb_gadget.h>
  56
  57 #include <asm/byteorder.h>
  58 #include <asm/io.h>
  59 #include <asm/irq.h>
  60 #include <asm/system.h>
  61 #include <asm/unaligned.h>
  62
  63
  64 #include "../core/hcd.h"
  65
  66
  67 #define DRIVER_DESC     "USB Host+Gadget Emulator"
  68 #define DRIVER_VERSION  "14 Mar 2004"
  69
  70 static const char       driver_name [] = "dummy_hcd";
  71 static const char       driver_desc [] = "USB Host+Gadget Emulator";
  72
  73 static const char       gadget_name [] = "dummy_udc";
  74
  75 MODULE_DESCRIPTION (DRIVER_DESC);
  76 MODULE_AUTHOR ("David Brownell");
  77 MODULE_LICENSE ("GPL");
  78
  79 /*-------------------------------------------------------------------------*/
  80
  81 /* gadget side driver data structres */
  82 struct dummy_ep {
  83         struct list_head                queue;
  84         unsigned long                   last_io;        /* jiffies timestamp */
  85         struct usb_gadget               *gadget;
  86         const struct usb_endpoint_descriptor *desc;
  87         struct usb_ep                   ep;
  88         unsigned                        halted : 1;
  89         unsigned                        already_seen : 1;
  90         unsigned                        setup_stage : 1;
  91 };
  92
  93 struct dummy_request {
  94         struct list_head                queue;          /* ep's requests */
  95         struct usb_request              req;
  96 };
  97
  98 /*-------------------------------------------------------------------------*/
  99
 100 /*
 101  * Every device has ep0 for control requests, plus up to 30 more endpoints,
 102  * in one of two types:
 103  *
 104  *   - Configurable:  direction (in/out), type (bulk, iso, etc), and endpoint
 105  *     number can be changed.  Names like "ep-a" are used for this type.
 106  *
 107  *   - Fixed Function:  in other cases.  some characteristics may be mutable;
 108  *     that'd be hardware-specific.  Names like "ep12out-bulk" are used.
 109  *
 110  * Gadget drivers are responsible for not setting up conflicting endpoint
 111  * configurations, illegal or unsupported packet lengths, and so on.
 112  */
 113
 114 static const char ep0name [] = "ep0";
 115
 116 static const char *const ep_name [] = {
 117         ep0name,                                /* everyone has ep0 */
 118
 119         /* act like a net2280: high speed, six configurable endpoints */
 120         "ep-a", "ep-b", "ep-c", "ep-d", "ep-e", "ep-f",
 121
 122         /* or like pxa250: fifteen fixed function endpoints */
 123         "ep1in-bulk", "ep2out-bulk", "ep3in-iso", "ep4out-iso", "ep5in-int",
 124         "ep6in-bulk", "ep7out-bulk", "ep8in-iso", "ep9out-iso", "ep10in-int",
 125         "ep11in-bulk", "ep12out-bulk", "ep13in-iso", "ep14out-iso",
 126                 "ep15in-int",
 127
 128         /* or like sa1100: two fixed function endpoints */
 129         "ep1out-bulk", "ep2in-bulk",
 130 };
 131 #define DUMMY_ENDPOINTS (sizeof(ep_name)/sizeof(char *))
 132
 133 #define FIFO_SIZE               64
 134
 135 struct dummy {
 136         spinlock_t                      lock;
 137
 138         /*
 139          * SLAVE/GADGET side support
 140          */
 141         struct dummy_ep                 ep [DUMMY_ENDPOINTS];
 142         int                             address;
 143         struct usb_gadget               gadget;
 144         struct usb_gadget_driver        *driver;
 145         struct dummy_request            fifo_req;
 146         u8                              fifo_buf [FIFO_SIZE];
 147         u16                             devstatus;
 148
 149         /*
 150          * MASTER/HOST side support
 151          */
 152         struct usb_hcd                  hcd;
 153         struct platform_device          pdev;
 154         struct timer_list               timer;
 155         u32                             port_status;
 156         int                             started;
 157         struct completion               released;
 158         unsigned                        resuming:1;
 159         unsigned long                   re_timeout;
 160
 161         struct usb_device               *udev;
 162 };
 163
 164 static struct dummy     *the_controller;
 165
 166 static inline struct dummy *ep_to_dummy (struct dummy_ep *ep)
 167 {
 168         return container_of (ep->gadget, struct dummy, gadget);
 169 }
 170
 171 static inline struct dummy *gadget_dev_to_dummy (struct device *dev)
 172 {
 173         return container_of (dev, struct dummy, gadget.dev);
 174 }
 175
 176 /*
 177  * This "hardware" may look a bit odd in diagnostics since it's got both
 178  * host and device sides; and it binds different drivers to each side.
 179  */
 180 #define hardware        (&the_controller->pdev.dev)
 181
 182 /*-------------------------------------------------------------------------*/
 183
 184 static struct device_driver dummy_driver = {
 185         .name           = (char *) driver_name,
 186         .bus            = &platform_bus_type,
 187 };
 188
 189 /*-------------------------------------------------------------------------*/
 190
 191 /* SLAVE/GADGET SIDE DRIVER
 192  *
 193  * This only tracks gadget state.  All the work is done when the host
 194  * side tries some (emulated) i/o operation.  Real device controller
 195  * drivers would do real i/o using dma, fifos, irqs, timers, etc.
 196  */
 197
 198 #define is_enabled() \
 199         (the_controller->port_status & USB_PORT_STAT_ENABLE)
 200
 201 static int
 202 dummy_enable (struct usb_ep *_ep, const struct usb_endpoint_descriptor *desc)
 203 {
 204         struct dummy            *dum;
 205         struct dummy_ep         *ep;
 206         unsigned                max;
 207         int                     retval;
 208
 209         ep = container_of (_ep, struct dummy_ep, ep);
 210         if (!_ep || !desc || ep->desc || _ep->name == ep0name
 211                         || desc->bDescriptorType != USB_DT_ENDPOINT)
 212         if (!the_controller->driver || !is_enabled ())
 213                 return -ESHUTDOWN;
 214         max = desc->wMaxPacketSize & 0x3ff;
 215
 216         /* drivers must not request bad settings, since lower levels
 217          * (hardware or its drivers) may not check.  some endpoints
 218          * can't do iso, many have maxpacket limitations, etc.
 219          *
 220          * since this "hardware" driver is here to help debugging, we
 221          * have some extra sanity checks.  (there could be more though,
 222          * especially for "ep9out" style fixed function ones.)
 223          */
 224         dum = container_of (ep->gadget, struct dummy, gadget);
 225         retval = -EINVAL;
 226         switch (desc->bmAttributes & 0x03) {
 227         case USB_ENDPOINT_XFER_BULK:
 228                 if (strstr (ep->ep.name, "-iso")
 229                                 || strstr (ep->ep.name, "-int")) {
 230                         goto done;
 231                 }
 232                 switch (dum->gadget.speed) {
 233                 case USB_SPEED_HIGH:
 234                         if (max == 512)
 235                                 break;
 236                         /* conserve return statements */
 237                 default:
 238                         switch (max) {
 239                         case 8: case 16: case 32: case 64:
 240                                 /* we'll fake any legal size */
 241                                 break;
 242                         default:
 243                 case USB_SPEED_LOW:
 244                                 goto done;
 245                         }
 246                 }
 247                 break;
 248         case USB_ENDPOINT_XFER_INT:
 249                 if (strstr (ep->ep.name, "-iso")) /* bulk is ok */
 250                         goto done;
 251                 /* real hardware might not handle all packet sizes */
 252                 switch (dum->gadget.speed) {
 253                 case USB_SPEED_HIGH:
 254                         if (max <= 1024)
 255                                 break;
 256                         /* save a return statement */
 257                 case USB_SPEED_FULL:
 258                         if (max <= 64)
 259                                 break;
 260                         /* save a return statement */
 261                 default:
 262                         if (max <= 8)
 263                                 break;
 264                         goto done;
 265                 }
 266                 break;
 267         case USB_ENDPOINT_XFER_ISOC:
 268                 if (strstr (ep->ep.name, "-bulk")
 269                                 || strstr (ep->ep.name, "-int"))
 270                         goto done;
 271                 /* real hardware might not handle all packet sizes */
 272                 switch (dum->gadget.speed) {
 273                 case USB_SPEED_HIGH:
 274                         if (max <= 1024)
 275                                 break;
 276                         /* save a return statement */
 277                 case USB_SPEED_FULL:
 278                         if (max <= 1023)
 279                                 break;
 280                         /* save a return statement */
 281                 default:
 282                         goto done;
 283                 }
 284                 break;
 285         default:
 286                 /* few chips support control except on ep0 */
 287                 goto done;
 288         }
 289
 290         _ep->maxpacket = max;
 291         ep->desc = desc;
 292
 293         dev_dbg (hardware, "enabled %s (ep%d%s-%s) maxpacket %d\n",
 294                 _ep->name,
 295                 desc->bEndpointAddress & 0x0f,
 296                 (desc->bEndpointAddress & USB_DIR_IN) ? "in" : "out",
 297                 ({ char *val;
 298                  switch (desc->bmAttributes & 0x03) {
 299                  case USB_ENDPOINT_XFER_BULK: val = "bulk"; break;
 300                  case USB_ENDPOINT_XFER_ISOC: val = "iso"; break;
 301                  case USB_ENDPOINT_XFER_INT: val = "intr"; break;
 302                  default: val = "ctrl"; break;
 303                  }; val; }),
 304                 max);
 305
 306         /* at this point real hardware should be NAKing transfers
 307          * to that endpoint, until a buffer is queued to it.
 308          */
 309         retval = 0;
 310 done:
 311         return retval;
 312 }
 313
 314 /* called with spinlock held */
 315 static void nuke (struct dummy *dum, struct dummy_ep *ep)
 316 {
 317         while (!list_empty (&ep->queue)) {
 318                 struct dummy_request    *req;
 319
 320                 req = list_entry (ep->queue.next, struct dummy_request, queue);
 321                 list_del_init (&req->queue);
 322                 req->req.status = -ESHUTDOWN;
 323
 324                 spin_unlock (&dum->lock);
 325                 req->req.complete (&ep->ep, &req->req);
 326                 spin_lock (&dum->lock);
 327         }
 328 }
 329
 330 static int dummy_disable (struct usb_ep *_ep)
 331 {
 332         struct dummy_ep         *ep;
 333         struct dummy            *dum;
 334         unsigned long           flags;
 335         int                     retval;
 336
 337         ep = container_of (_ep, struct dummy_ep, ep);
 338         if (!_ep || !ep->desc || _ep->name == ep0name)
 339                 return -EINVAL;
 340         dum = ep_to_dummy (ep);
 341
 342         spin_lock_irqsave (&dum->lock, flags);
 343         ep->desc = 0;
 344         retval = 0;
 345         nuke (dum, ep);
 346         spin_unlock_irqrestore (&dum->lock, flags);
 347
 348         dev_dbg (hardware, "disabled %s\n", _ep->name);
 349         return retval;
 350 }
 351
 352 static struct usb_request *
 353 dummy_alloc_request (struct usb_ep *_ep, int mem_flags)
 354 {
 355         struct dummy_ep         *ep;
 356         struct dummy_request    *req;
 357
 358         ep = container_of (_ep, struct dummy_ep, ep);
 359         if (!_ep)
 360                 return 0;
 361
 362         req = kmalloc (sizeof *req, mem_flags);
 363         if (!req)
 364                 return 0;
 365         memset (req, 0, sizeof *req);
 366         INIT_LIST_HEAD (&req->queue);
 367         return &req->req;
 368 }
 369
 370 static void
 371 dummy_free_request (struct usb_ep *_ep, struct usb_request *_req)
 372 {
 373         struct dummy_ep         *ep;
 374         struct dummy_request    *req;
 375
 376         ep = container_of (_ep, struct dummy_ep, ep);
 377         if (!ep || !_req || (!ep->desc && _ep->name != ep0name))
 378                 return;
 379
 380         req = container_of (_req, struct dummy_request, req);
 381         WARN_ON (!list_empty (&req->queue));
 382         kfree (req);
 383 }
 384
 385 static void *
 386 dummy_alloc_buffer (
 387         struct usb_ep *_ep,
 388         unsigned bytes,
 389         dma_addr_t *dma,
 390         int mem_flags
 391 ) {
 392         char *retval;
 393
 394         if (!the_controller->driver)
 395                 return 0;
 396         retval = kmalloc (bytes, mem_flags);
 397         *dma = (dma_addr_t) retval;
 398         return retval;
 399 }
 400
 401 static void
 402 dummy_free_buffer (
 403         struct usb_ep *_ep,
 404         void *buf,
 405         dma_addr_t dma,
 406         unsigned bytes
 407 ) {
 408         if (bytes)
 409                 kfree (buf);
 410 }
 411
 412 static void
 413 fifo_complete (struct usb_ep *ep, struct usb_request *req)
 414 {
 415 #if 0
 416         dev_dbg (hardware, "fifo_complete: %d\n", req->status);
 417 #endif
 418 }
 419
 420 static int
 421 dummy_queue (struct usb_ep *_ep, struct usb_request *_req, int mem_flags)
 422 {
 423         struct dummy_ep         *ep;
 424         struct dummy_request    *req;
 425         struct dummy            *dum;
 426         unsigned long           flags;
 427
 428         req = container_of (_req, struct dummy_request, req);
 429         if (!_req || !list_empty (&req->queue) || !_req->complete)
 430                 return -EINVAL;
 431
 432         ep = container_of (_ep, struct dummy_ep, ep);
 433         if (!_ep || (!ep->desc && _ep->name != ep0name))
 434                 return -EINVAL;
 435
 436         if (!the_controller->driver || !is_enabled ())
 437                 return -ESHUTDOWN;
 438
 439         dum = container_of (ep->gadget, struct dummy, gadget);
 440
 441 #if 0
 442         dev_dbg (hardware, "ep %p queue req %p to %s, len %d buf %p\n",
 443                         ep, _req, _ep->name, _req->length, _req->buf);
 444 #endif
 445
 446         _req->status = -EINPROGRESS;
 447         _req->actual = 0;
 448         spin_lock_irqsave (&dum->lock, flags);
 449
 450         /* implement an emulated single-request FIFO */
 451         if (ep->desc && (ep->desc->bEndpointAddress & USB_DIR_IN) &&
 452                         list_empty (&dum->fifo_req.queue) &&
 453                         list_empty (&ep->queue) &&
 454                         _req->length <= FIFO_SIZE) {
 455                 req = &dum->fifo_req;
 456                 req->req = *_req;
 457                 req->req.buf = dum->fifo_buf;
 458                 memcpy (dum->fifo_buf, _req->buf, _req->length);
 459                 req->req.context = dum;
 460                 req->req.complete = fifo_complete;
 461
 462                 spin_unlock (&dum->lock);
 463                 _req->actual = _req->length;
 464                 _req->status = 0;
 465                 _req->complete (_ep, _req);
 466                 spin_lock (&dum->lock);
 467         }
 468         list_add_tail (&req->queue, &ep->queue);
 469         spin_unlock_irqrestore (&dum->lock, flags);
 470
 471         /* real hardware would likely enable transfers here, in case
 472          * it'd been left NAKing.
 473          */
 474         return 0;
 475 }
 476
 477 static int dummy_dequeue (struct usb_ep *_ep, struct usb_request *_req)
 478 {
 479         struct dummy_ep         *ep;
 480         struct dummy            *dum;
 481         int                     retval = -EINVAL;
 482         unsigned long           flags;
 483         struct dummy_request    *req = 0;
 484
 485         if (!the_controller->driver)
 486                 return -ESHUTDOWN;
 487
 488         if (!_ep || !_req)
 489                 return retval;
 490         ep = container_of (_ep, struct dummy_ep, ep);
 491         dum = container_of (ep->gadget, struct dummy, gadget);
 492
 493         spin_lock_irqsave (&dum->lock, flags);
 494         list_for_each_entry (req, &ep->queue, queue) {
 495                 if (&req->req == _req) {
 496                         list_del_init (&req->queue);
 497                         _req->status = -ECONNRESET;
 498                         retval = 0;
 499                         break;
 500                 }
 501         }
 502         spin_unlock_irqrestore (&dum->lock, flags);
 503
 504         if (retval == 0) {
 505                 dev_dbg (hardware, "dequeued req %p from %s, len %d buf %p\n",
 506                                 req, _ep->name, _req->length, _req->buf);
 507
 508                 _req->complete (_ep, _req);
 509         }
 510         return retval;
 511 }
 512
 513 static int
 514 dummy_set_halt (struct usb_ep *_ep, int value)
 515 {
 516         struct dummy_ep         *ep;
 517
 518         if (!_ep)
 519                 return -EINVAL;
 520         if (!the_controller->driver)
 521                 return -ESHUTDOWN;
 522         ep = container_of (_ep, struct dummy_ep, ep);
 523         if (!value)
 524                 ep->halted = 0;
 525         else if (ep->desc && (ep->desc->bEndpointAddress & USB_DIR_IN) &&
 526                         !list_empty (&ep->queue))
 527                 return -EAGAIN;
 528         else
 529                 ep->halted = 1;
 530         /* FIXME clear emulated data toggle too */
 531         return 0;
 532 }
 533
 534 static const struct usb_ep_ops dummy_ep_ops = {
 535         .enable         = dummy_enable,
 536         .disable        = dummy_disable,
 537
 538         .alloc_request  = dummy_alloc_request,
 539         .free_request   = dummy_free_request,
 540
 541         .alloc_buffer   = dummy_alloc_buffer,
 542         .free_buffer    = dummy_free_buffer,
 543         /* map, unmap, ... eventually hook the "generic" dma calls */
 544
 545         .queue          = dummy_queue,
 546         .dequeue        = dummy_dequeue,
 547
 548         .set_halt       = dummy_set_halt,
 549 };
 550
 551 /*-------------------------------------------------------------------------*/
 552
 553 /* there are both host and device side versions of this call ... */
 554 static int dummy_g_get_frame (struct usb_gadget *_gadget)
 555 {
 556         struct timeval  tv;
 557
 558         do_gettimeofday (&tv);
 559         return tv.tv_usec / 1000;
 560 }
 561
 562 static int dummy_wakeup (struct usb_gadget *_gadget)
 563 {
 564         struct dummy    *dum;
 565
 566         dum = container_of (_gadget, struct dummy, gadget);
 567         if ((dum->devstatus & (1 << USB_DEVICE_REMOTE_WAKEUP)) == 0
 568                         || !(dum->port_status & (1 << USB_PORT_FEAT_SUSPEND)))
 569                 return -EINVAL;
 570
 571         /* hub notices our request, issues downstream resume, etc */
 572         dum->resuming = 1;
 573         dum->port_status |= (1 << USB_PORT_FEAT_C_SUSPEND);
 574         return 0;
 575 }
 576
 577 static int dummy_set_selfpowered (struct usb_gadget *_gadget, int value)
 578 {
 579         struct dummy    *dum;
 580
 581         dum = container_of (_gadget, struct dummy, gadget);
 582         if (value)
 583                 dum->devstatus |= (1 << USB_DEVICE_SELF_POWERED);
 584         else
 585                 dum->devstatus &= ~(1 << USB_DEVICE_SELF_POWERED);
 586         return 0;
 587 }
 588
 589 static const struct usb_gadget_ops dummy_ops = {
 590         .get_frame      = dummy_g_get_frame,
 591         .wakeup         = dummy_wakeup,
 592         .set_selfpowered = dummy_set_selfpowered,
 593 };
 594
 595 /*-------------------------------------------------------------------------*/
 596
 597 /* "function" sysfs attribute */
 598 static ssize_t
 599 show_function (struct device *_dev, char *buf)
 600 {
 601         struct dummy    *dum = the_controller;
 602
 603         if (!dum->driver->function
 604                         || strlen (dum->driver->function) > PAGE_SIZE)
 605                 return 0;
 606         return snprintf (buf, PAGE_SIZE, "%s\n", dum->driver->function);
 607 }
 608 DEVICE_ATTR (function, S_IRUGO, show_function, NULL);
 609
 610 /*-------------------------------------------------------------------------*/
 611
 612 /*
 613  * Driver registration/unregistration.
 614  *
 615  * This is basically hardware-specific; there's usually only one real USB
 616  * device (not host) controller since that's how USB devices are intended
 617  * to work.  So most implementations of these api calls will rely on the
 618  * fact that only one driver will ever bind to the hardware.  But curious
 619  * hardware can be built with discrete components, so the gadget API doesn't
 620  * require that assumption.
 621  *
 622  * For this emulator, it might be convenient to create a usb slave device
 623  * for each driver that registers:  just add to a big root hub.
 624  */
 625
 626 static void
 627 dummy_udc_release (struct device *dev)
 628 {
 629         struct dummy    *dum = gadget_dev_to_dummy (dev);
 630
 631         complete (&dum->released);
 632 }
 633
 634 static void
 635 dummy_hc_release (struct device *dev)
 636 {
 637         struct dummy    *dum = dev_get_drvdata (dev);
 638
 639         complete (&dum->released);
 640 }
 641
 642 static int
 643 dummy_register_udc (struct dummy *dum)
 644 {
 645         int             rc;
 646
 647         strcpy (dum->gadget.dev.bus_id, "udc");
 648         dum->gadget.dev.parent = &dum->pdev.dev;
 649         dum->gadget.dev.release = dummy_udc_release;
 650
 651         rc = device_register (&dum->gadget.dev);
 652         if (rc == 0)
 653                 device_create_file (&dum->gadget.dev, &dev_attr_function);
 654         return rc;
 655 }
 656
 657 static void
 658 dummy_unregister_udc (struct dummy *dum)
 659 {
 660         device_remove_file (&dum->gadget.dev, &dev_attr_function);
 661         init_completion (&dum->released);
 662         device_unregister (&dum->gadget.dev);
 663         wait_for_completion (&dum->released);
 664 }
 665
 666 int
 667 usb_gadget_register_driver (struct usb_gadget_driver *driver)
 668 {
 669         struct dummy    *dum = the_controller;
 670         int             retval, i;
 671
 672         if (!dum)
 673                 return -EINVAL;
 674         if (dum->driver)
 675                 return -EBUSY;
 676         if (!driver->bind || !driver->unbind || !driver->setup
 677                         || driver->speed == USB_SPEED_UNKNOWN)
 678                 return -EINVAL;
 679
 680         /*
 681          * SLAVE side init ... the layer above hardware, which
 682          * can't enumerate without help from the driver we're binding.
 683          */
 684         dum->gadget.name = gadget_name;
 685         dum->gadget.ops = &dummy_ops;
 686         dum->gadget.is_dualspeed = 1;
 687
 688         dum->devstatus = 0;
 689         dum->resuming = 0;
 690
 691         INIT_LIST_HEAD (&dum->gadget.ep_list);
 692         for (i = 0; i < DUMMY_ENDPOINTS; i++) {
 693                 struct dummy_ep *ep = &dum->ep [i];
 694
 695                 if (!ep_name [i])
 696                         break;
 697                 ep->ep.name = ep_name [i];
 698                 ep->ep.ops = &dummy_ep_ops;
 699                 list_add_tail (&ep->ep.ep_list, &dum->gadget.ep_list);
 700                 ep->halted = ep->already_seen = ep->setup_stage = 0;
 701                 ep->ep.maxpacket = ~0;
 702                 ep->last_io = jiffies;
 703                 ep->gadget = &dum->gadget;
 704                 ep->desc = 0;
 705                 INIT_LIST_HEAD (&ep->queue);
 706         }
 707
 708         dum->gadget.ep0 = &dum->ep [0].ep;
 709         dum->ep [0].ep.maxpacket = 64;
 710         list_del_init (&dum->ep [0].ep.ep_list);
 711         INIT_LIST_HEAD(&dum->fifo_req.queue);
 712
 713         dum->driver = driver;
 714         dum->gadget.dev.driver = &driver->driver;
 715         dev_dbg (hardware, "binding gadget driver '%s'\n", driver->driver.name);
 716         if ((retval = driver->bind (&dum->gadget)) != 0) {
 717                 dum->driver = 0;
 718                 dum->gadget.dev.driver = 0;
 719                 return retval;
 720         }
 721
 722         // FIXME: Check these calls for errors and re-order
 723         driver->driver.bus = dum->pdev.dev.bus;
 724         driver_register (&driver->driver);
 725
 726         device_bind_driver (&dum->gadget.dev);
 727
 728         /* khubd will enumerate this in a while */
 729         dum->port_status |= USB_PORT_STAT_CONNECTION
 730                 | (1 << USB_PORT_FEAT_C_CONNECTION);
 731         return 0;
 732 }
 733 EXPORT_SYMBOL (usb_gadget_register_driver);
 734
 735 /* caller must hold lock */
 736 static void
 737 stop_activity (struct dummy *dum, struct usb_gadget_driver *driver)
 738 {
 739         struct dummy_ep *ep;
 740
 741         /* prevent any more requests */
 742         dum->address = 0;
 743
 744         /* The timer is left running so that outstanding URBs can fail */
 745
 746         /* nuke any pending requests first, so driver i/o is quiesced */
 747         list_for_each_entry (ep, &dum->gadget.ep_list, ep.ep_list)
 748                 nuke (dum, ep);
 749
 750         /* driver now does any non-usb quiescing necessary */
 751         if (driver) {
 752                 spin_unlock (&dum->lock);
 753                 driver->disconnect (&dum->gadget);
 754                 spin_lock (&dum->lock);
 755         }
 756 }
 757
 758 int
 759 usb_gadget_unregister_driver (struct usb_gadget_driver *driver)
 760 {
 761         struct dummy    *dum = the_controller;
 762         unsigned long   flags;
 763
 764         if (!dum)
 765                 return -ENODEV;
 766         if (!driver || driver != dum->driver)
 767                 return -EINVAL;
 768
 769         dev_dbg (hardware, "unregister gadget driver '%s'\n",
 770                         driver->driver.name);
 771
 772         spin_lock_irqsave (&dum->lock, flags);
 773         stop_activity (dum, driver);
 774         dum->port_status &= ~USB_PORT_STAT_CONNECTION;
 775         dum->port_status |= (1 << USB_PORT_FEAT_C_CONNECTION);
 776         spin_unlock_irqrestore (&dum->lock, flags);
 777
 778         driver->unbind (&dum->gadget);
 779         dum->driver = 0;
 780
 781         device_release_driver (&dum->gadget.dev);
 782
 783         driver_unregister (&driver->driver);
 784
 785         return 0;
 786 }
 787 EXPORT_SYMBOL (usb_gadget_unregister_driver);
 788
 789 #undef is_enabled
 790
 791 int net2280_set_fifo_mode (struct usb_gadget *gadget, int mode)
 792 {
 793         return -ENOSYS;
 794 }
 795 EXPORT_SYMBOL (net2280_set_fifo_mode);
 796
 797 /*-------------------------------------------------------------------------*/
 798
 799 /* MASTER/HOST SIDE DRIVER
 800  *
 801  * this uses the hcd framework to hook up to host side drivers.
 802  * its root hub will only have one device, otherwise it acts like
 803  * a normal host controller.
 804  *
 805  * when urbs are queued, they're just stuck on a list that we
 806  * scan in a timer callback.  that callback connects writes from
 807  * the host with reads from the device, and so on, based on the
 808  * usb 2.0 rules.
 809  */
 810
 811 static int dummy_urb_enqueue (
 812         struct usb_hcd  *hcd,
 813         struct urb      *urb,
 814         int             mem_flags
 815 ) {
 816         struct dummy    *dum;
 817         unsigned long   flags;
 818
 819         /* patch to usb_sg_init() is in 2.5.60 */
 820         BUG_ON (!urb->transfer_buffer && urb->transfer_buffer_length);
 821
 822         dum = container_of (hcd, struct dummy, hcd);
 823         spin_lock_irqsave (&dum->lock, flags);
 824
 825         if (!dum->udev) {
 826                 dum->udev = urb->dev;
 827                 usb_get_dev (dum->udev);
 828         } else if (unlikely (dum->udev != urb->dev))
 829                 dev_err (hardware, "usb_device address has changed!\n");
 830
 831         urb->hcpriv = dum;
 832         if (usb_pipetype (urb->pipe) == PIPE_CONTROL)
 833                 urb->error_count = 1;           /* mark as a new urb */
 834
 835         /* kick the scheduler, it'll do the rest */
 836         if (!timer_pending (&dum->timer))
 837                 mod_timer (&dum->timer, jiffies + 1);
 838
 839         spin_unlock_irqrestore (&dum->lock, flags);
 840         return 0;
 841 }
 842
 843 static int dummy_urb_dequeue (struct usb_hcd *hcd, struct urb *urb)
 844 {
 845         /* giveback happens automatically in timer callback */
 846         return 0;
 847 }
 848
 849 static void maybe_set_status (struct urb *urb, int status)
 850 {
 851         spin_lock (&urb->lock);
 852         if (urb->status == -EINPROGRESS)
 853                 urb->status = status;
 854         spin_unlock (&urb->lock);
 855 }
 856
 857 /* transfer up to a frame's worth; caller must own lock */
 858 static int
 859 transfer (struct dummy *dum, struct urb *urb, struct dummy_ep *ep, int limit)
 860 {
 861         struct dummy_request    *req;
 862
 863 top:
 864         /* if there's no request queued, the device is NAKing; return */
 865         list_for_each_entry (req, &ep->queue, queue) {
 866                 unsigned        host_len, dev_len, len;
 867                 int             is_short, to_host;
 868                 int             rescan = 0;
 869
 870                 /* 1..N packets of ep->ep.maxpacket each ... the last one
 871                  * may be short (including zero length).
 872                  *
 873                  * writer can send a zlp explicitly (length 0) or implicitly
 874                  * (length mod maxpacket zero, and 'zero' flag); they always
 875                  * terminate reads.
 876                  */
 877                 host_len = urb->transfer_buffer_length - urb->actual_length;
 878                 dev_len = req->req.length - req->req.actual;
 879                 len = min (host_len, dev_len);
 880
 881                 /* FIXME update emulated data toggle too */
 882
 883                 to_host = usb_pipein (urb->pipe);
 884                 if (unlikely (len == 0))
 885                         is_short = 1;
 886                 else {
 887                         char            *ubuf, *rbuf;
 888
 889                         /* not enough bandwidth left? */
 890                         if (limit < ep->ep.maxpacket && limit < len)
 891                                 break;
 892                         len = min (len, (unsigned) limit);
 893                         if (len == 0)
 894                                 break;
 895
 896                         /* use an extra pass for the final short packet */
 897                         if (len > ep->ep.maxpacket) {
 898                                 rescan = 1;
 899                                 len -= (len % ep->ep.maxpacket);
 900                         }
 901                         is_short = (len % ep->ep.maxpacket) != 0;
 902
 903                         /* else transfer packet(s) */
 904                         ubuf = urb->transfer_buffer + urb->actual_length;
 905                         rbuf = req->req.buf + req->req.actual;
 906                         if (to_host)
 907                                 memcpy (ubuf, rbuf, len);
 908                         else
 909                                 memcpy (rbuf, ubuf, len);
 910                         ep->last_io = jiffies;
 911
 912                         limit -= len;
 913                         urb->actual_length += len;
 914                         req->req.actual += len;
 915                 }
 916
 917                 /* short packets terminate, maybe with overflow/underflow.
 918                  * it's only really an error to write too much.
 919                  *
 920                  * partially filling a buffer optionally blocks queue advances
 921                  * (so completion handlers can clean up the queue) but we don't
 922                  * need to emulate such data-in-flight.  so we only show part
 923                  * of the URB_SHORT_NOT_OK effect: completion status.
 924                  */
 925                 if (is_short) {
 926                         if (host_len == dev_len) {
 927                                 req->req.status = 0;
 928                                 maybe_set_status (urb, 0);
 929                         } else if (to_host) {
 930                                 req->req.status = 0;
 931                                 if (dev_len > host_len)
 932                                         maybe_set_status (urb, -EOVERFLOW);
 933                                 else
 934                                         maybe_set_status (urb,
 935                                                 (urb->transfer_flags
 936                                                         & URB_SHORT_NOT_OK)
 937                                                 ? -EREMOTEIO : 0);
 938                         } else if (!to_host) {
 939                                 maybe_set_status (urb, 0);
 940                                 if (host_len > dev_len)
 941                                         req->req.status = -EOVERFLOW;
 942                                 else
 943                                         req->req.status = 0;
 944                         }
 945
 946                 /* many requests terminate without a short packet */
 947                 } else {
 948                         if (req->req.length == req->req.actual
 949                                         && !req->req.zero)
 950                                 req->req.status = 0;
 951                         if (urb->transfer_buffer_length == urb->actual_length
 952                                         && !(urb->transfer_flags
 953                                                 & URB_ZERO_PACKET)) {
 954                                 maybe_set_status (urb, 0);
 955                         }
 956                 }
 957
 958                 /* device side completion --> continuable */
 959                 if (req->req.status != -EINPROGRESS) {
 960                         list_del_init (&req->queue);
 961
 962                         spin_unlock (&dum->lock);
 963                         req->req.complete (&ep->ep, &req->req);
 964                         spin_lock (&dum->lock);
 965
 966                         /* requests might have been unlinked... */
 967                         rescan = 1;
 968                 }
 969
 970                 /* host side completion --> terminate */
 971                 if (urb->status != -EINPROGRESS)
 972                         break;
 973
 974                 /* rescan to continue with any other queued i/o */
 975                 if (rescan)
 976                         goto top;
 977         }
 978         return limit;
 979 }
 980
 981 static int periodic_bytes (struct dummy *dum, struct dummy_ep *ep)
 982 {
 983         int     limit = ep->ep.maxpacket;
 984
 985         if (dum->gadget.speed == USB_SPEED_HIGH) {
 986                 int     tmp;
 987
 988                 /* high bandwidth mode */
 989                 tmp = ep->desc->wMaxPacketSize;
 990                 tmp = le16_to_cpu (tmp);
 991                 tmp = (tmp >> 11) & 0x03;
 992                 tmp *= 8 /* applies to entire frame */;
 993                 limit += limit * tmp;
 994         }
 995         return limit;
 996 }
 997
 998 #define is_active(dum)  ((dum->port_status & \
 999                 (USB_PORT_STAT_CONNECTION | USB_PORT_STAT_ENABLE | \
1000                         USB_PORT_STAT_SUSPEND)) \
1001                 == (USB_PORT_STAT_CONNECTION | USB_PORT_STAT_ENABLE))
1002
1003 static struct dummy_ep *find_endpoint (struct dummy *dum, u8 address)
1004 {
1005         int             i;
1006
1007         if (!is_active (dum))
1008                 return NULL;
1009         if ((address & ~USB_DIR_IN) == 0)
1010                 return &dum->ep [0];
1011         for (i = 1; i < DUMMY_ENDPOINTS; i++) {
1012                 struct dummy_ep *ep = &dum->ep [i];
1013
1014                 if (!ep->desc)
1015                         continue;
1016                 if (ep->desc->bEndpointAddress == address)
1017                         return ep;
1018         }
1019         return NULL;
1020 }
1021
1022 #undef is_active
1023
1024 #define Dev_Request     (USB_TYPE_STANDARD | USB_RECIP_DEVICE)
1025 #define Dev_InRequest   (Dev_Request | USB_DIR_IN)
1026 #define Intf_Request    (USB_TYPE_STANDARD | USB_RECIP_INTERFACE)
1027 #define Intf_InRequest  (Intf_Request | USB_DIR_IN)
1028 #define Ep_Request      (USB_TYPE_STANDARD | USB_RECIP_ENDPOINT)
1029 #define Ep_InRequest    (Ep_Request | USB_DIR_IN)
1030
1031 /* drive both sides of the transfers; looks like irq handlers to
1032  * both drivers except the callbacks aren't in_irq().
1033  */
1034 static void dummy_timer (unsigned long _dum)
1035 {
1036         struct dummy            *dum = (struct dummy *) _dum;
1037         struct hcd_dev          *hdev;
1038         struct list_head        *entry, *tmp;
1039         unsigned long           flags;
1040         int                     limit, total;
1041         int                     i;
1042
1043         /* simplistic model for one frame's bandwidth */
1044         switch (dum->gadget.speed) {
1045         case USB_SPEED_LOW:
1046                 total = 8/*bytes*/ * 12/*packets*/;
1047                 break;
1048         case USB_SPEED_FULL:
1049                 total = 64/*bytes*/ * 19/*packets*/;
1050                 break;
1051         case USB_SPEED_HIGH:
1052                 total = 512/*bytes*/ * 13/*packets*/ * 8/*uframes*/;
1053                 break;
1054         default:
1055                 dev_err (hardware, "bogus device speed\n");
1056                 return;
1057         }
1058
1059         /* FIXME if HZ != 1000 this will probably misbehave ... */
1060
1061         /* look at each urb queued by the host side driver */
1062         spin_lock_irqsave (&dum->lock, flags);
1063
1064         if (!dum->udev) {
1065                 dev_err (hardware, "timer fired with no URBs pending?\n");
1066                 spin_unlock_irqrestore (&dum->lock, flags);
1067                 return;
1068         }
1069         hdev = dum->udev->hcpriv;
1070
1071         for (i = 0; i < DUMMY_ENDPOINTS; i++) {
1072                 if (!ep_name [i])
1073                         break;
1074                 dum->ep [i].already_seen = 0;
1075         }
1076
1077 restart:
1078         list_for_each_safe (entry, tmp, &hdev->urb_list) {
1079                 struct urb              *urb;
1080                 struct dummy_request    *req;
1081                 u8                      address;
1082                 struct dummy_ep         *ep = 0;
1083                 int                     type;
1084
1085                 urb = list_entry (entry, struct urb, urb_list);
1086                 if (urb->status != -EINPROGRESS) {
1087                         /* likely it was just unlinked */
1088                         goto return_urb;
1089                 }
1090                 type = usb_pipetype (urb->pipe);
1091
1092                 /* used up this frame's non-periodic bandwidth?
1093                  * FIXME there's infinite bandwidth for control and
1094                  * periodic transfers ... unrealistic.
1095                  */
1096                 if (total <= 0 && type == PIPE_BULK)
1097                         continue;
1098
1099                 /* find the gadget's ep for this request (if configured) */
1100                 address = usb_pipeendpoint (urb->pipe);
1101                 if (usb_pipein (urb->pipe))
1102                         address |= USB_DIR_IN;
1103                 ep = find_endpoint(dum, address);
1104                 if (!ep) {
1105                         /* set_configuration() disagreement */
1106                         dev_err (hardware,
1107                                 "no ep configured for urb %p\n",
1108                                 urb);
1109                         maybe_set_status (urb, -ETIMEDOUT);
1110                         goto return_urb;
1111                 }
1112
1113                 if (ep->already_seen)
1114                         continue;
1115                 ep->already_seen = 1;
1116                 if (ep == &dum->ep [0] && urb->error_count) {
1117                         ep->setup_stage = 1;    /* a new urb */
1118                         urb->error_count = 0;
1119                 }
1120                 if (ep->halted && !ep->setup_stage) {
1121                         /* NOTE: must not be iso! */
1122                         dev_dbg (hardware, "ep %s halted, urb %p\n",
1123                                         ep->ep.name, urb);
1124                         maybe_set_status (urb, -EPIPE);
1125                         goto return_urb;
1126                 }
1127                 /* FIXME make sure both ends agree on maxpacket */
1128
1129                 /* handle control requests */
1130                 if (ep == &dum->ep [0] && ep->setup_stage) {
1131                         struct usb_ctrlrequest          setup;
1132                         int                             value = 1;
1133                         struct dummy_ep                 *ep2;
1134
1135                         setup = *(struct usb_ctrlrequest*) urb->setup_packet;
1136                         le16_to_cpus (&setup.wIndex);
1137                         le16_to_cpus (&setup.wValue);
1138                         le16_to_cpus (&setup.wLength);
1139                         if (setup.wLength != urb->transfer_buffer_length) {
1140                                 maybe_set_status (urb, -EOVERFLOW);
1141                                 goto return_urb;
1142                         }
1143
1144                         /* paranoia, in case of stale queued data */
1145                         list_for_each_entry (req, &ep->queue, queue) {
1146                                 list_del_init (&req->queue);
1147                                 req->req.status = -EOVERFLOW;
1148                                 dev_dbg (hardware, "stale req = %p\n", req);
1149
1150                                 spin_unlock (&dum->lock);
1151                                 req->req.complete (&ep->ep, &req->req);
1152                                 spin_lock (&dum->lock);
1153                                 ep->already_seen = 0;
1154                                 goto restart;
1155                         }
1156
1157                         /* gadget driver never sees set_address or operations
1158                          * on standard feature flags.  some hardware doesn't
1159                          * even expose them.
1160                          */
1161                         ep->last_io = jiffies;
1162                         ep->setup_stage = 0;
1163                         ep->halted = 0;
1164                         switch (setup.bRequest) {
1165                         case USB_REQ_SET_ADDRESS:
1166                                 if (setup.bRequestType != Dev_Request)
1167                                         break;
1168                                 dum->address = setup.wValue;
1169                                 maybe_set_status (urb, 0);
1170                                 dev_dbg (hardware, "set_address = %d\n",
1171                                                 setup.wValue);
1172                                 value = 0;
1173                                 break;
1174                         case USB_REQ_SET_FEATURE:
1175                                 if (setup.bRequestType == Dev_Request) {
1176                                         value = 0;
1177                                         switch (setup.wValue) {
1178                                         case USB_DEVICE_REMOTE_WAKEUP:
1179                                                 break;
1180                                         default:
1181                                                 value = -EOPNOTSUPP;
1182                                         }
1183                                         if (value == 0) {
1184                                                 dum->devstatus |=
1185                                                         (1 << setup.wValue);
1186                                                 maybe_set_status (urb, 0);
1187                                         }
1188
1189                                 } else if (setup.bRequestType == Ep_Request) {
1190                                         // endpoint halt
1191                                         ep2 = find_endpoint (dum,
1192                                                         setup.wIndex);
1193                                         if (!ep2) {
1194                                                 value = -EOPNOTSUPP;
1195                                                 break;
1196                                         }
1197                                         ep2->halted = 1;
1198                                         value = 0;
1199                                         maybe_set_status (urb, 0);
1200                                 }
1201                                 break;
1202                         case USB_REQ_CLEAR_FEATURE:
1203                                 if (setup.bRequestType == Dev_Request) {
1204                                         switch (setup.wValue) {
1205                                         case USB_DEVICE_REMOTE_WAKEUP:
1206                                                 dum->devstatus &= ~(1 <<
1207                                                         USB_DEVICE_REMOTE_WAKEUP);
1208                                                 value = 0;
1209                                                 maybe_set_status (urb, 0);
1210                                                 break;
1211                                         default:
1212                                                 value = -EOPNOTSUPP;
1213                                                 break;
1214                                         }
1215                                 } else if (setup.bRequestType == Ep_Request) {
1216                                         // endpoint halt
1217                                         ep2 = find_endpoint (dum,
1218                                                         setup.wIndex);
1219                                         if (!ep2) {
1220                                                 value = -EOPNOTSUPP;
1221                                                 break;
1222                                         }
1223                                         ep2->halted = 0;
1224                                         value = 0;
1225                                         maybe_set_status (urb, 0);
1226                                 }
1227                                 break;
1228                         case USB_REQ_GET_STATUS:
1229                                 if (setup.bRequestType == Dev_InRequest
1230                                                 || setup.bRequestType
1231                                                         == Intf_InRequest
1232                                                 || setup.bRequestType
1233                                                         == Ep_InRequest
1234                                                 ) {
1235                                         char *buf;
1236
1237                                         // device: remote wakeup, selfpowered
1238                                         // interface: nothing
1239                                         // endpoint: halt
1240                                         buf = (char *)urb->transfer_buffer;
1241                                         if (urb->transfer_buffer_length > 0) {
1242                                                 if (setup.bRequestType ==
1243                                                                 Ep_InRequest) {
1244         ep2 = find_endpoint (dum, setup.wIndex);
1245         if (!ep2) {
1246                 value = -EOPNOTSUPP;
1247                 break;
1248         }
1249         buf [0] = ep2->halted;
1250                                                 } else if (setup.bRequestType ==
1251                                                                 Dev_InRequest) {
1252                                                         buf [0] = (u8)
1253                                                                 dum->devstatus;
1254                                                 } else
1255                                                         buf [0] = 0;
1256                                         }
1257                                         if (urb->transfer_buffer_length > 1)
1258                                                 buf [1] = 0;
1259                                         urb->actual_length = min (2,
1260                                                 urb->transfer_buffer_length);
1261                                         value = 0;
1262                                         maybe_set_status (urb, 0);
1263                                 }
1264                                 break;
1265                         }
1266
1267                         /* gadget driver handles all other requests.  block
1268                          * until setup() returns; no reentrancy issues etc.
1269                          */
1270                         if (value > 0) {
1271                                 spin_unlock (&dum->lock);
1272                                 value = dum->driver->setup (&dum->gadget,
1273                                                 &setup);
1274                                 spin_lock (&dum->lock);
1275
1276                                 if (value >= 0) {
1277                                         /* no delays (max 64KB data stage) */
1278                                         limit = 64*1024;
1279                                         goto treat_control_like_bulk;
1280                                 }
1281                                 /* error, see below */
1282                         }
1283
1284                         if (value < 0) {
1285                                 if (value != -EOPNOTSUPP)
1286                                         dev_dbg (hardware,
1287                                                 "setup --> %d\n",
1288                                                 value);
1289                                 maybe_set_status (urb, -EPIPE);
1290                                 urb->actual_length = 0;
1291                         }
1292
1293                         goto return_urb;
1294                 }
1295
1296                 /* non-control requests */
1297                 limit = total;
1298                 switch (usb_pipetype (urb->pipe)) {
1299                 case PIPE_ISOCHRONOUS:
1300                         /* FIXME is it urb->interval since the last xfer?
1301                          * use urb->iso_frame_desc[i].
1302                          * complete whether or not ep has requests queued.
1303                          * report random errors, to debug drivers.
1304                          */
1305                         limit = max (limit, periodic_bytes (dum, ep));
1306                         maybe_set_status (urb, -ENOSYS);
1307                         break;
1308
1309                 case PIPE_INTERRUPT:
1310                         /* FIXME is it urb->interval since the last xfer?
1311                          * this almost certainly polls too fast.
1312                          */
1313                         limit = max (limit, periodic_bytes (dum, ep));
1314                         /* FALLTHROUGH */
1315
1316                 // case PIPE_BULK:  case PIPE_CONTROL:
1317                 default:
1318                 treat_control_like_bulk:
1319                         ep->last_io = jiffies;
1320                         total = transfer (dum, urb, ep, limit);
1321                         break;
1322                 }
1323
1324                 /* incomplete transfer? */
1325                 if (urb->status == -EINPROGRESS)
1326                         continue;
1327
1328 return_urb:
1329                 urb->hcpriv = 0;
1330                 if (ep)
1331                         ep->already_seen = ep->setup_stage = 0;
1332
1333                 spin_unlock (&dum->lock);
1334                 usb_hcd_giveback_urb (&dum->hcd, urb, 0);
1335                 spin_lock (&dum->lock);
1336
1337                 goto restart;
1338         }
1339
1340         /* want a 1 msec delay here */
1341         if (!list_empty (&hdev->urb_list))
1342                 mod_timer (&dum->timer, jiffies + msecs_to_jiffies(1));
1343         else {
1344                 usb_put_dev (dum->udev);
1345                 dum->udev = NULL;
1346         }
1347
1348         spin_unlock_irqrestore (&dum->lock, flags);
1349 }
1350
1351 /*-------------------------------------------------------------------------*/
1352
1353 #define PORT_C_MASK \
1354          ((1 << USB_PORT_FEAT_C_CONNECTION) \
1355         | (1 << USB_PORT_FEAT_C_ENABLE) \
1356         | (1 << USB_PORT_FEAT_C_SUSPEND) \
1357         | (1 << USB_PORT_FEAT_C_OVER_CURRENT) \
1358         | (1 << USB_PORT_FEAT_C_RESET))
1359
1360 static int dummy_hub_status (struct usb_hcd *hcd, char *buf)
1361 {
1362         struct dummy            *dum;
1363         unsigned long           flags;
1364         int                     retval;
1365
1366         dum = container_of (hcd, struct dummy, hcd);
1367
1368         spin_lock_irqsave (&dum->lock, flags);
1369         if (!(dum->port_status & PORT_C_MASK))
1370                 retval = 0;
1371         else {
1372                 *buf = (1 << 1);
1373                 dev_dbg (hardware, "port status 0x%08x has changes\n",
1374                         dum->port_status);
1375                 retval = 1;
1376         }
1377         spin_unlock_irqrestore (&dum->lock, flags);
1378         return retval;
1379 }
1380
1381 static inline void
1382 hub_descriptor (struct usb_hub_descriptor *desc)
1383 {
1384         memset (desc, 0, sizeof *desc);
1385         desc->bDescriptorType = 0x29;
1386         desc->bDescLength = 9;
1387         desc->wHubCharacteristics = __constant_cpu_to_le16 (0x0001);
1388         desc->bNbrPorts = 1;
1389         desc->bitmap [0] = 0xff;
1390         desc->bitmap [1] = 0xff;
1391 }
1392
1393 static int dummy_hub_control (
1394         struct usb_hcd  *hcd,
1395         u16             typeReq,
1396         u16             wValue,
1397         u16             wIndex,
1398         char            *buf,
1399         u16             wLength
1400 ) {
1401         struct dummy    *dum;
1402         int             retval = 0;
1403         unsigned long   flags;
1404
1405         dum = container_of (hcd, struct dummy, hcd);
1406         spin_lock_irqsave (&dum->lock, flags);
1407         switch (typeReq) {
1408         case ClearHubFeature:
1409                 break;
1410         case ClearPortFeature:
1411                 switch (wValue) {
1412                 case USB_PORT_FEAT_SUSPEND:
1413                         /* 20msec resume signaling */
1414                         dum->resuming = 1;
1415                         dum->re_timeout = jiffies + ((HZ * 20)/1000);
1416                         break;
1417                 case USB_PORT_FEAT_POWER:
1418                         dum->port_status = 0;
1419                         dum->resuming = 0;
1420                         stop_activity(dum, dum->driver);
1421                         break;
1422                 default:
1423                         dum->port_status &= ~(1 << wValue);
1424                 }
1425                 break;
1426         case GetHubDescriptor:
1427                 hub_descriptor ((struct usb_hub_descriptor *) buf);
1428                 break;
1429         case GetHubStatus:
1430                 *(u32 *) buf = __constant_cpu_to_le32 (0);
1431                 break;
1432         case GetPortStatus:
1433                 if (wIndex != 1)
1434                         retval = -EPIPE;
1435
1436                 /* whoever resets or resumes must GetPortStatus to
1437                  * complete it!!
1438                  */
1439                 if (dum->resuming && time_after (jiffies, dum->re_timeout)) {
1440                         dum->port_status |= (1 << USB_PORT_FEAT_C_SUSPEND);
1441                         dum->port_status &= ~(1 << USB_PORT_FEAT_SUSPEND);
1442                         dum->resuming = 0;
1443                         dum->re_timeout = 0;
1444                         if (dum->driver->resume) {
1445                                 spin_unlock (&dum->lock);
1446                                 dum->driver->resume (&dum->gadget);
1447                                 spin_lock (&dum->lock);
1448                         }
1449                 }
1450                 if ((dum->port_status & (1 << USB_PORT_FEAT_RESET)) != 0
1451                                 && time_after (jiffies, dum->re_timeout)) {
1452                         dum->port_status |= (1 << USB_PORT_FEAT_C_RESET);
1453                         dum->port_status &= ~(1 << USB_PORT_FEAT_RESET);
1454                         dum->re_timeout = 0;
1455                         if (dum->driver) {
1456                                 dum->port_status |= USB_PORT_STAT_ENABLE;
1457                                 /* give it the best speed we agree on */
1458                                 dum->gadget.speed = dum->driver->speed;
1459                                 dum->gadget.ep0->maxpacket = 64;
1460                                 switch (dum->gadget.speed) {
1461                                 case USB_SPEED_HIGH:
1462                                         dum->port_status |=
1463                                                 USB_PORT_STAT_HIGH_SPEED;
1464                                         break;
1465                                 case USB_SPEED_LOW:
1466                                         dum->gadget.ep0->maxpacket = 8;
1467                                         dum->port_status |=
1468                                                 USB_PORT_STAT_LOW_SPEED;
1469                                         break;
1470                                 default:
1471                                         dum->gadget.speed = USB_SPEED_FULL;
1472                                         break;
1473                                 }
1474                         }
1475                 }
1476                 ((u16 *) buf)[0] = cpu_to_le16 (dum->port_status);
1477                 ((u16 *) buf)[1] = cpu_to_le16 (dum->port_status >> 16);
1478                 break;
1479         case SetHubFeature:
1480                 retval = -EPIPE;
1481                 break;
1482         case SetPortFeature:
1483                 switch (wValue) {
1484                 case USB_PORT_FEAT_SUSPEND:
1485                         dum->port_status |= (1 << USB_PORT_FEAT_SUSPEND);
1486                         if (dum->driver->suspend) {
1487                                 spin_unlock (&dum->lock);
1488                                 dum->driver->suspend (&dum->gadget);
1489                                 spin_lock (&dum->lock);
1490                         }
1491                         break;
1492                 case USB_PORT_FEAT_RESET:
1493                         /* if it's already running, disconnect first */
1494                         if (dum->port_status & USB_PORT_STAT_ENABLE) {
1495                                 dum->port_status &= ~(USB_PORT_STAT_ENABLE
1496                                                 | USB_PORT_STAT_LOW_SPEED
1497                                                 | USB_PORT_STAT_HIGH_SPEED);
1498                                 if (dum->driver) {
1499                                         dev_dbg (hardware, "disconnect\n");
1500                                         stop_activity (dum, dum->driver);
1501                                 }
1502
1503                                 /* FIXME test that code path! */
1504                         }
1505                         /* 50msec reset signaling */
1506                         dum->re_timeout = jiffies + ((HZ * 50)/1000);
1507                         /* FALLTHROUGH */
1508                 default:
1509                         dum->port_status |= (1 << wValue);
1510                 }
1511                 break;
1512
1513         default:
1514                 dev_dbg (hardware,
1515                         "hub control req%04x v%04x i%04x l%d\n",
1516                         typeReq, wValue, wIndex, wLength);
1517
1518                 /* "protocol stall" on error */
1519                 retval = -EPIPE;
1520         }
1521         spin_unlock_irqrestore (&dum->lock, flags);
1522         return retval;
1523 }
1524
1525
1526 /*-------------------------------------------------------------------------*/
1527
1528 static struct usb_hcd *dummy_alloc (void)
1529 {
1530         struct dummy            *dum;
1531
1532         dum = kmalloc (sizeof *dum, SLAB_KERNEL);
1533         if (dum == NULL)
1534                 return 0;
1535         memset (dum, 0, sizeof *dum);
1536         return &dum->hcd;
1537 }
1538
1539 static void dummy_free (struct usb_hcd *hcd)
1540 {
1541         struct dummy            *dum;
1542
1543         dum = container_of (hcd, struct dummy, hcd);
1544         WARN_ON (dum->driver != 0);
1545         kfree (dum);
1546 }
1547
1548 /*-------------------------------------------------------------------------*/
1549
1550 static inline ssize_t
1551 show_urb (char *buf, size_t size, struct urb *urb)
1552 {
1553         int ep = usb_pipeendpoint (urb->pipe);
1554
1555         return snprintf (buf, size,
1556                 "urb/%p %s ep%d%s%s len %d/%d\n",
1557                 urb,
1558                 ({ char *s;
1559                  switch (urb->dev->speed) {
1560                  case USB_SPEED_LOW:    s = "ls"; break;
1561                  case USB_SPEED_FULL:   s = "fs"; break;
1562                  case USB_SPEED_HIGH:   s = "hs"; break;
1563                  default:               s = "?"; break;
1564                  }; s; }),
1565                 ep, ep ? (usb_pipein (urb->pipe) ? "in" : "out") : "",
1566                 ({ char *s; \
1567                  switch (usb_pipetype (urb->pipe)) { \
1568                  case PIPE_CONTROL:     s = ""; break; \
1569                  case PIPE_BULK:        s = "-bulk"; break; \
1570                  case PIPE_INTERRUPT:   s = "-int"; break; \
1571                  default:               s = "-iso"; break; \
1572                 }; s;}),
1573                 urb->actual_length, urb->transfer_buffer_length);
1574 }
1575
1576 static ssize_t
1577 show_urbs (struct device *dev, char *buf)
1578 {
1579         struct dummy            *dum = dev_get_drvdata(dev);
1580         struct urb              *urb;
1581         size_t                  size = 0;
1582         unsigned long           flags;
1583         struct hcd_dev          *hdev;
1584
1585         spin_lock_irqsave (&dum->lock, flags);
1586         if (dum->udev) {
1587                 hdev = dum->udev->hcpriv;
1588                 list_for_each_entry (urb, &hdev->urb_list, urb_list) {
1589                         size_t          temp;
1590
1591                         temp = show_urb (buf, PAGE_SIZE - size, urb);
1592                         buf += temp;
1593                         size += temp;
1594                 }
1595         }
1596         spin_unlock_irqrestore (&dum->lock, flags);
1597
1598         return size;
1599 }
1600 static DEVICE_ATTR (urbs, S_IRUGO, show_urbs, NULL);
1601
1602
1603 static const struct hc_driver dummy_hcd;
1604
1605 static int dummy_start (struct usb_hcd *hcd)
1606 {
1607         struct dummy            *dum;
1608         struct usb_bus          *bus;
1609         struct usb_device       *root;
1610         int                     retval;
1611
1612         dum = container_of (hcd, struct dummy, hcd);
1613
1614         /*
1615          * MASTER side init ... we emulate a root hub that'll only ever
1616          * talk to one device (the slave side).  Also appears in sysfs,
1617          * just like more familiar pci-based HCDs.
1618          */
1619         spin_lock_init (&dum->lock);
1620
1621         retval = driver_register (&dummy_driver);
1622         if (retval < 0)
1623                 return retval;
1624
1625         dum->pdev.name = "hc";
1626         dum->pdev.dev.driver = &dummy_driver;
1627         dev_set_drvdata(&dum->pdev.dev, dum);
1628         dum->pdev.dev.release = dummy_hc_release;
1629         retval = platform_device_register (&dum->pdev);
1630         if (retval < 0) {
1631                 driver_unregister (&dummy_driver);
1632                 return retval;
1633         }
1634         dev_info (&dum->pdev.dev, "%s, driver " DRIVER_VERSION "\n",
1635                         driver_desc);
1636
1637         hcd->self.controller = &dum->pdev.dev;
1638
1639         /* FIXME 'urbs' should be a per-device thing, maybe in usbcore */
1640         device_create_file (hcd->self.controller, &dev_attr_urbs);
1641
1642         init_timer (&dum->timer);
1643         dum->timer.function = dummy_timer;
1644         dum->timer.data = (unsigned long) dum;
1645
1646         /* root hub will appear as another device */
1647         dum->hcd.driver = (struct hc_driver *) &dummy_hcd;
1648         dum->hcd.description = dummy_hcd.description;
1649         dum->hcd.product_desc = "Dummy host controller";
1650
1651         bus = hcd_to_bus (&dum->hcd);
1652         bus->bus_name = dum->pdev.dev.bus_id;
1653         usb_bus_init (bus);
1654         bus->op = &usb_hcd_operations;
1655         bus->hcpriv = &dum->hcd;
1656
1657         /* FIXME don't require the pci-based buffer/alloc impls;
1658          * the "generic dma" implementation still requires them,
1659          * it's not very generic yet.
1660          */
1661         if ((retval = hcd_buffer_create (&dum->hcd)) != 0) {
1662 clean0:
1663                 init_completion (&dum->released);
1664                 platform_device_unregister (&dum->pdev);
1665                 wait_for_completion (&dum->released);
1666                 driver_unregister (&dummy_driver);
1667                 return retval;
1668         }
1669
1670         INIT_LIST_HEAD (&hcd->dev_list);
1671         usb_register_bus (bus);
1672
1673         root = usb_alloc_dev (0, bus, 0);
1674         if (!root) {
1675                 retval = -ENOMEM;
1676 clean1:
1677                 hcd_buffer_destroy (&dum->hcd);
1678                 usb_deregister_bus (bus);
1679                 goto clean0;
1680         }
1681
1682         /* root hub enters addressed state... */
1683         dum->hcd.state = USB_STATE_RUNNING;
1684         root->speed = USB_SPEED_HIGH;
1685
1686         /* ...then configured, so khubd sees us. */
1687         if ((retval = hcd_register_root (root, &dum->hcd)) != 0) {
1688                 usb_put_dev (root);
1689 clean2:
1690                 dum->hcd.state = USB_STATE_QUIESCING;
1691                 goto clean1;
1692         }
1693
1694         /* only show a low-power port: just 8mA */
1695         hub_set_power_budget (root, 8);
1696
1697         dum->started = 1;
1698
1699         if ((retval = dummy_register_udc (dum)) != 0) {
1700                 dum->started = 0;
1701                 usb_disconnect (&bus->root_hub);
1702                 goto clean2;
1703         }
1704         return 0;
1705 }
1706
1707 static void dummy_stop (struct usb_hcd *hcd)
1708 {
1709         struct dummy            *dum;
1710         struct usb_bus          *bus;
1711
1712         dum = container_of (hcd, struct dummy, hcd);
1713         if (!dum->started)
1714                 return;
1715         dum->started = 0;
1716
1717         usb_gadget_unregister_driver (dum->driver);
1718         dummy_unregister_udc (dum);
1719
1720         bus = hcd_to_bus (&dum->hcd);
1721         hcd->state = USB_STATE_QUIESCING;
1722         dev_dbg (hardware, "remove root hub\n");
1723         usb_disconnect (&bus->root_hub);
1724
1725         hcd_buffer_destroy (&dum->hcd);
1726         usb_deregister_bus (bus);
1727
1728         dev_info (hardware, "stopped\n");
1729
1730         device_remove_file (hcd->self.controller, &dev_attr_urbs);
1731         init_completion (&dum->released);
1732         platform_device_unregister (&dum->pdev);
1733         wait_for_completion (&dum->released);
1734
1735         driver_unregister (&dummy_driver);
1736 }
1737
1738 /*-------------------------------------------------------------------------*/
1739
1740 static int dummy_h_get_frame (struct usb_hcd *hcd)
1741 {
1742         return dummy_g_get_frame (0);
1743 }
1744
1745 static const struct hc_driver dummy_hcd = {
1746         .description =          (char *) driver_name,
1747         .flags =                HCD_USB2,
1748
1749         .start =                dummy_start,
1750         .stop =                 dummy_stop,
1751
1752         .hcd_alloc =            dummy_alloc,
1753         .hcd_free =             dummy_free,
1754
1755         .urb_enqueue =          dummy_urb_enqueue,
1756         .urb_dequeue =          dummy_urb_dequeue,
1757
1758         .get_frame_number =     dummy_h_get_frame,
1759
1760         .hub_status_data =      dummy_hub_status,
1761         .hub_control =          dummy_hub_control,
1762 };
1763
1764 /*-------------------------------------------------------------------------*/
1765
1766 static int __init init (void)
1767 {
1768         struct usb_hcd          *hcd;
1769         int                     value;
1770
1771         if (usb_disabled ())
1772                 return -ENODEV;
1773         if ((hcd = dummy_alloc ()) == 0)
1774                 return -ENOMEM;
1775
1776         the_controller = container_of (hcd, struct dummy, hcd);
1777         value = dummy_start (hcd);
1778
1779         if (value != 0) {
1780                 dummy_free (hcd);
1781                 the_controller = 0;
1782         }
1783         return value;
1784 }
1785 module_init (init);
1786
1787 static void __exit cleanup (void)
1788 {
1789         dummy_stop (&the_controller->hcd);
1790         dummy_free (&the_controller->hcd);
1791         the_controller = 0;
1792 }
1793 module_exit (cleanup);
1794