drivers/net/wireless/rt2x00/rt2x00usb.c

   1 /*
   2         Copyright (C) 2010 Willow Garage <http://www.willowgarage.com>
   3         Copyright (C) 2004 - 2010 Ivo van Doorn <IvDoorn@gmail.com>
   4         <http://rt2x00.serialmonkey.com>
   5
   6         This program is free software; you can redistribute it and/or modify
   7         it under the terms of the GNU General Public License as published by
   8         the Free Software Foundation; either version 2 of the License, or
   9         (at your option) any later version.
  10
  11         This program is distributed in the hope that it will be useful,
  12         but WITHOUT ANY WARRANTY; without even the implied warranty of
  13         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  14         GNU General Public License for more details.
  15
  16         You should have received a copy of the GNU General Public License
  17         along with this program; if not, write to the
  18         Free Software Foundation, Inc.,
  19         59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  20  */
  21
  22 /*
  23         Module: rt2x00usb
  24         Abstract: rt2x00 generic usb device routines.
  25  */
  26
  27 #include <linux/kernel.h>
  28 #include <linux/module.h>
  29 #include <linux/slab.h>
  30 #include <linux/usb.h>
  31 #include <linux/bug.h>
  32
  33 #include "rt2x00.h"
  34 #include "rt2x00usb.h"
  35
  36 /*
  37  * Interfacing with the HW.
  38  */
  39 int rt2x00usb_vendor_request(struct rt2x00_dev *rt2x00dev,
  40                              const u8 request, const u8 requesttype,
  41                              const u16 offset, const u16 value,
  42                              void *buffer, const u16 buffer_length,
  43                              const int timeout)
  44 {
  45         struct usb_device *usb_dev = to_usb_device_intf(rt2x00dev->dev);
  46         int status;
  47         unsigned int i;
  48         unsigned int pipe =
  49             (requesttype == USB_VENDOR_REQUEST_IN) ?
  50             usb_rcvctrlpipe(usb_dev, 0) : usb_sndctrlpipe(usb_dev, 0);
  51
  52         if (!test_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags))
  53                 return -ENODEV;
  54
  55         for (i = 0; i < REGISTER_BUSY_COUNT; i++) {
  56                 status = usb_control_msg(usb_dev, pipe, request, requesttype,
  57                                          value, offset, buffer, buffer_length,
  58                                          timeout);
  59                 if (status >= 0)
  60                         return 0;
  61
  62                 /*
  63                  * Check for errors
  64                  * -ENODEV: Device has disappeared, no point continuing.
  65                  * All other errors: Try again.
  66                  */
  67                 else if (status == -ENODEV) {
  68                         clear_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags);
  69                         break;
  70                 }
  71         }
  72
  73         ERROR(rt2x00dev,
  74               "Vendor Request 0x%02x failed for offset 0x%04x with error %d.\n",
  75               request, offset, status);
  76
  77         return status;
  78 }
  79 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_request);
  80
  81 int rt2x00usb_vendor_req_buff_lock(struct rt2x00_dev *rt2x00dev,
  82                                    const u8 request, const u8 requesttype,
  83                                    const u16 offset, void *buffer,
  84                                    const u16 buffer_length, const int timeout)
  85 {
  86         int status;
  87
  88         BUG_ON(!mutex_is_locked(&rt2x00dev->csr_mutex));
  89
  90         /*
  91          * Check for Cache availability.
  92          */
  93         if (unlikely(!rt2x00dev->csr.cache || buffer_length > CSR_CACHE_SIZE)) {
  94                 ERROR(rt2x00dev, "CSR cache not available.\n");
  95                 return -ENOMEM;
  96         }
  97
  98         if (requesttype == USB_VENDOR_REQUEST_OUT)
  99                 memcpy(rt2x00dev->csr.cache, buffer, buffer_length);
 100
 101         status = rt2x00usb_vendor_request(rt2x00dev, request, requesttype,
 102                                           offset, 0, rt2x00dev->csr.cache,
 103                                           buffer_length, timeout);
 104
 105         if (!status && requesttype == USB_VENDOR_REQUEST_IN)
 106                 memcpy(buffer, rt2x00dev->csr.cache, buffer_length);
 107
 108         return status;
 109 }
 110 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_req_buff_lock);
 111
 112 int rt2x00usb_vendor_request_buff(struct rt2x00_dev *rt2x00dev,
 113                                   const u8 request, const u8 requesttype,
 114                                   const u16 offset, void *buffer,
 115                                   const u16 buffer_length, const int timeout)
 116 {
 117         int status = 0;
 118         unsigned char *tb;
 119         u16 off, len, bsize;
 120
 121         mutex_lock(&rt2x00dev->csr_mutex);
 122
 123         tb  = (char *)buffer;
 124         off = offset;
 125         len = buffer_length;
 126         while (len && !status) {
 127                 bsize = min_t(u16, CSR_CACHE_SIZE, len);
 128                 status = rt2x00usb_vendor_req_buff_lock(rt2x00dev, request,
 129                                                         requesttype, off, tb,
 130                                                         bsize, timeout);
 131
 132                 tb  += bsize;
 133                 len -= bsize;
 134                 off += bsize;
 135         }
 136
 137         mutex_unlock(&rt2x00dev->csr_mutex);
 138
 139         return status;
 140 }
 141 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_request_buff);
 142
 143 int rt2x00usb_regbusy_read(struct rt2x00_dev *rt2x00dev,
 144                            const unsigned int offset,
 145                            const struct rt2x00_field32 field,
 146                            u32 *reg)
 147 {
 148         unsigned int i;
 149
 150         if (!test_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags))
 151                 return -ENODEV;
 152
 153         for (i = 0; i < REGISTER_BUSY_COUNT; i++) {
 154                 rt2x00usb_register_read_lock(rt2x00dev, offset, reg);
 155                 if (!rt2x00_get_field32(*reg, field))
 156                         return 1;
 157                 udelay(REGISTER_BUSY_DELAY);
 158         }
 159
 160         ERROR(rt2x00dev, "Indirect register access failed: "
 161               "offset=0x%.08x, value=0x%.08x\n", offset, *reg);
 162         *reg = ~0;
 163
 164         return 0;
 165 }
 166 EXPORT_SYMBOL_GPL(rt2x00usb_regbusy_read);
 167
 168
 169 struct rt2x00_async_read_data {
 170         __le32 reg;
 171         struct usb_ctrlrequest cr;
 172         struct rt2x00_dev *rt2x00dev;
 173         bool (*callback)(struct rt2x00_dev *, int, u32);
 174 };
 175
 176 static void rt2x00usb_register_read_async_cb(struct urb *urb)
 177 {
 178         struct rt2x00_async_read_data *rd = urb->context;
 179         if (rd->callback(rd->rt2x00dev, urb->status, le32_to_cpu(rd->reg))) {
 180                 if (usb_submit_urb(urb, GFP_ATOMIC) < 0)
 181                         kfree(rd);
 182         } else
 183                 kfree(rd);
 184 }
 185
 186 void rt2x00usb_register_read_async(struct rt2x00_dev *rt2x00dev,
 187                                    const unsigned int offset,
 188                                    bool (*callback)(struct rt2x00_dev*, int, u32))
 189 {
 190         struct usb_device *usb_dev = to_usb_device_intf(rt2x00dev->dev);
 191         struct urb *urb;
 192         struct rt2x00_async_read_data *rd;
 193
 194         rd = kmalloc(sizeof(*rd), GFP_ATOMIC);
 195         if (!rd)
 196                 return;
 197
 198         urb = usb_alloc_urb(0, GFP_ATOMIC);
 199         if (!urb) {
 200                 kfree(rd);
 201                 return;
 202         }
 203
 204         rd->rt2x00dev = rt2x00dev;
 205         rd->callback = callback;
 206         rd->cr.bRequestType = USB_VENDOR_REQUEST_IN;
 207         rd->cr.bRequest = USB_MULTI_READ;
 208         rd->cr.wValue = 0;
 209         rd->cr.wIndex = cpu_to_le16(offset);
 210         rd->cr.wLength = cpu_to_le16(sizeof(u32));
 211
 212         usb_fill_control_urb(urb, usb_dev, usb_rcvctrlpipe(usb_dev, 0),
 213                              (unsigned char *)(&rd->cr), &rd->reg, sizeof(rd->reg),
 214                              rt2x00usb_register_read_async_cb, rd);
 215         if (usb_submit_urb(urb, GFP_ATOMIC) < 0)
 216                 kfree(rd);
 217         usb_free_urb(urb);
 218 }
 219 EXPORT_SYMBOL_GPL(rt2x00usb_register_read_async);
 220
 221 /*
 222  * TX data handlers.
 223  */
 224 static void rt2x00usb_work_txdone_entry(struct queue_entry *entry)
 225 {
 226         /*
 227          * If the transfer to hardware succeeded, it does not mean the
 228          * frame was send out correctly. It only means the frame
 229          * was successfully pushed to the hardware, we have no
 230          * way to determine the transmission status right now.
 231          * (Only indirectly by looking at the failed TX counters
 232          * in the register).
 233          */
 234         if (test_bit(ENTRY_DATA_IO_FAILED, &entry->flags))
 235                 rt2x00lib_txdone_noinfo(entry, TXDONE_FAILURE);
 236         else
 237                 rt2x00lib_txdone_noinfo(entry, TXDONE_UNKNOWN);
 238 }
 239
 240 static void rt2x00usb_work_txdone(struct work_struct *work)
 241 {
 242         struct rt2x00_dev *rt2x00dev =
 243             container_of(work, struct rt2x00_dev, txdone_work);
 244         struct data_queue *queue;
 245         struct queue_entry *entry;
 246
 247         tx_queue_for_each(rt2x00dev, queue) {
 248                 while (!rt2x00queue_empty(queue)) {
 249                         entry = rt2x00queue_get_entry(queue, Q_INDEX_DONE);
 250
 251                         if (test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags) ||
 252                             !test_bit(ENTRY_DATA_STATUS_PENDING, &entry->flags))
 253                                 break;
 254
 255                         rt2x00usb_work_txdone_entry(entry);
 256                 }
 257         }
 258 }
 259
 260 static void rt2x00usb_interrupt_txdone(struct urb *urb)
 261 {
 262         struct queue_entry *entry = (struct queue_entry *)urb->context;
 263         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 264
 265         if (!test_and_clear_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
 266                 return;
 267
 268         if (rt2x00dev->ops->lib->tx_dma_done)
 269                 rt2x00dev->ops->lib->tx_dma_done(entry);
 270
 271         /*
 272          * Report the frame as DMA done
 273          */
 274         rt2x00lib_dmadone(entry);
 275
 276         /*
 277          * Check if the frame was correctly uploaded
 278          */
 279         if (urb->status)
 280                 set_bit(ENTRY_DATA_IO_FAILED, &entry->flags);
 281
 282         /*
 283          * Schedule the delayed work for reading the TX status
 284          * from the device.
 285          */
 286         if (!test_bit(REQUIRE_TXSTATUS_FIFO, &rt2x00dev->cap_flags) ||
 287             !kfifo_is_empty(&rt2x00dev->txstatus_fifo))
 288                 queue_work(rt2x00dev->workqueue, &rt2x00dev->txdone_work);
 289 }
 290
 291 static bool rt2x00usb_kick_tx_entry(struct queue_entry *entry, void* data)
 292 {
 293         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 294         struct usb_device *usb_dev = to_usb_device_intf(rt2x00dev->dev);
 295         struct queue_entry_priv_usb *entry_priv = entry->priv_data;
 296         u32 length;
 297         int status;
 298
 299         if (!test_and_clear_bit(ENTRY_DATA_PENDING, &entry->flags) ||
 300             test_bit(ENTRY_DATA_STATUS_PENDING, &entry->flags))
 301                 return false;
 302
 303         /*
 304          * USB devices cannot blindly pass the skb->len as the
 305          * length of the data to usb_fill_bulk_urb. Pass the skb
 306          * to the driver to determine what the length should be.
 307          */
 308         length = rt2x00dev->ops->lib->get_tx_data_len(entry);
 309
 310         usb_fill_bulk_urb(entry_priv->urb, usb_dev,
 311                           usb_sndbulkpipe(usb_dev, entry->queue->usb_endpoint),
 312                           entry->skb->data, length,
 313                           rt2x00usb_interrupt_txdone, entry);
 314
 315         status = usb_submit_urb(entry_priv->urb, GFP_ATOMIC);
 316         if (status) {
 317                 if (status == -ENODEV)
 318                         clear_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags);
 319                 set_bit(ENTRY_DATA_IO_FAILED, &entry->flags);
 320                 rt2x00lib_dmadone(entry);
 321         }
 322
 323         return false;
 324 }
 325
 326 /*
 327  * RX data handlers.
 328  */
 329 static void rt2x00usb_work_rxdone(struct work_struct *work)
 330 {
 331         struct rt2x00_dev *rt2x00dev =
 332             container_of(work, struct rt2x00_dev, rxdone_work);
 333         struct queue_entry *entry;
 334         struct skb_frame_desc *skbdesc;
 335         u8 rxd[32];
 336
 337         while (!rt2x00queue_empty(rt2x00dev->rx)) {
 338                 entry = rt2x00queue_get_entry(rt2x00dev->rx, Q_INDEX_DONE);
 339
 340                 if (test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags) ||
 341                     !test_bit(ENTRY_DATA_STATUS_PENDING, &entry->flags))
 342                         break;
 343
 344                 /*
 345                  * Fill in desc fields of the skb descriptor
 346                  */
 347                 skbdesc = get_skb_frame_desc(entry->skb);
 348                 skbdesc->desc = rxd;
 349                 skbdesc->desc_len = entry->queue->desc_size;
 350
 351                 /*
 352                  * Send the frame to rt2x00lib for further processing.
 353                  */
 354                 rt2x00lib_rxdone(entry);
 355         }
 356 }
 357
 358 static void rt2x00usb_interrupt_rxdone(struct urb *urb)
 359 {
 360         struct queue_entry *entry = (struct queue_entry *)urb->context;
 361         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 362
 363         if (!test_and_clear_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
 364                 return;
 365
 366         /*
 367          * Report the frame as DMA done
 368          */
 369         rt2x00lib_dmadone(entry);
 370
 371         /*
 372          * Check if the received data is simply too small
 373          * to be actually valid, or if the urb is signaling
 374          * a problem.
 375          */
 376         if (urb->actual_length < entry->queue->desc_size || urb->status)
 377                 set_bit(ENTRY_DATA_IO_FAILED, &entry->flags);
 378
 379         /*
 380          * Schedule the delayed work for reading the RX status
 381          * from the device.
 382          */
 383         queue_work(rt2x00dev->workqueue, &rt2x00dev->rxdone_work);
 384 }
 385
 386 static bool rt2x00usb_kick_rx_entry(struct queue_entry *entry, void* data)
 387 {
 388         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 389         struct usb_device *usb_dev = to_usb_device_intf(rt2x00dev->dev);
 390         struct queue_entry_priv_usb *entry_priv = entry->priv_data;
 391         int status;
 392
 393         if (test_and_set_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags) ||
 394             test_bit(ENTRY_DATA_STATUS_PENDING, &entry->flags))
 395                 return false;
 396
 397         rt2x00lib_dmastart(entry);
 398
 399         usb_fill_bulk_urb(entry_priv->urb, usb_dev,
 400                           usb_rcvbulkpipe(usb_dev, entry->queue->usb_endpoint),
 401                           entry->skb->data, entry->skb->len,
 402                           rt2x00usb_interrupt_rxdone, entry);
 403
 404         status = usb_submit_urb(entry_priv->urb, GFP_ATOMIC);
 405         if (status) {
 406                 if (status == -ENODEV)
 407                         clear_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags);
 408                 set_bit(ENTRY_DATA_IO_FAILED, &entry->flags);
 409                 rt2x00lib_dmadone(entry);
 410         }
 411
 412         return false;
 413 }
 414
 415 void rt2x00usb_kick_queue(struct data_queue *queue)
 416 {
 417         switch (queue->qid) {
 418         case QID_AC_VO:
 419         case QID_AC_VI:
 420         case QID_AC_BE:
 421         case QID_AC_BK:
 422                 if (!rt2x00queue_empty(queue))
 423                         rt2x00queue_for_each_entry(queue,
 424                                                    Q_INDEX_DONE,
 425                                                    Q_INDEX,
 426                                                    NULL,
 427                                                    rt2x00usb_kick_tx_entry);
 428                 break;
 429         case QID_RX:
 430                 if (!rt2x00queue_full(queue))
 431                         rt2x00queue_for_each_entry(queue,
 432                                                    Q_INDEX_DONE,
 433                                                    Q_INDEX,
 434                                                    NULL,
 435                                                    rt2x00usb_kick_rx_entry);
 436                 break;
 437         default:
 438                 break;
 439         }
 440 }
 441 EXPORT_SYMBOL_GPL(rt2x00usb_kick_queue);
 442
 443 static bool rt2x00usb_flush_entry(struct queue_entry *entry, void* data)
 444 {
 445         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 446         struct queue_entry_priv_usb *entry_priv = entry->priv_data;
 447         struct queue_entry_priv_usb_bcn *bcn_priv = entry->priv_data;
 448
 449         if (!test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
 450                 return false;
 451
 452         usb_kill_urb(entry_priv->urb);
 453
 454         /*
 455          * Kill guardian urb (if required by driver).
 456          */
 457         if ((entry->queue->qid == QID_BEACON) &&
 458             (test_bit(REQUIRE_BEACON_GUARD, &rt2x00dev->cap_flags)))
 459                 usb_kill_urb(bcn_priv->guardian_urb);
 460
 461         return false;
 462 }
 463
 464 void rt2x00usb_flush_queue(struct data_queue *queue, bool drop)
 465 {
 466         struct work_struct *completion;
 467         unsigned int i;
 468
 469         if (drop)
 470                 rt2x00queue_for_each_entry(queue, Q_INDEX_DONE, Q_INDEX, NULL,
 471                                            rt2x00usb_flush_entry);
 472
 473         /*
 474          * Obtain the queue completion handler
 475          */
 476         switch (queue->qid) {
 477         case QID_AC_VO:
 478         case QID_AC_VI:
 479         case QID_AC_BE:
 480         case QID_AC_BK:
 481                 completion = &queue->rt2x00dev->txdone_work;
 482                 break;
 483         case QID_RX:
 484                 completion = &queue->rt2x00dev->rxdone_work;
 485                 break;
 486         default:
 487                 return;
 488         }
 489
 490         for (i = 0; i < 10; i++) {
 491                 /*
 492                  * Check if the driver is already done, otherwise we
 493                  * have to sleep a little while to give the driver/hw
 494                  * the oppurtunity to complete interrupt process itself.
 495                  */
 496                 if (rt2x00queue_empty(queue))
 497                         break;
 498
 499                 /*
 500                  * Schedule the completion handler manually, when this
 501                  * worker function runs, it should cleanup the queue.
 502                  */
 503                 queue_work(queue->rt2x00dev->workqueue, completion);
 504
 505                 /*
 506                  * Wait for a little while to give the driver
 507                  * the oppurtunity to recover itself.
 508                  */
 509                 msleep(10);
 510         }
 511 }
 512 EXPORT_SYMBOL_GPL(rt2x00usb_flush_queue);
 513
 514 static void rt2x00usb_watchdog_tx_dma(struct data_queue *queue)
 515 {
 516         WARNING(queue->rt2x00dev, "TX queue %d DMA timed out,"
 517                 " invoke forced forced reset\n", queue->qid);
 518
 519         rt2x00queue_flush_queue(queue, true);
 520 }
 521
 522 static void rt2x00usb_watchdog_tx_status(struct data_queue *queue)
 523 {
 524         WARNING(queue->rt2x00dev, "TX queue %d status timed out,"
 525                 " invoke forced tx handler\n", queue->qid);
 526
 527         queue_work(queue->rt2x00dev->workqueue, &queue->rt2x00dev->txdone_work);
 528 }
 529
 530 static int rt2x00usb_status_timeout(struct data_queue *queue)
 531 {
 532         struct queue_entry *entry;
 533
 534         entry = rt2x00queue_get_entry(queue, Q_INDEX_DONE);
 535         return rt2x00queue_status_timeout(entry);
 536 }
 537
 538 static int rt2x00usb_dma_timeout(struct data_queue *queue)
 539 {
 540         struct queue_entry *entry;
 541
 542         entry = rt2x00queue_get_entry(queue, Q_INDEX_DMA_DONE);
 543         return rt2x00queue_dma_timeout(entry);
 544 }
 545
 546 void rt2x00usb_watchdog(struct rt2x00_dev *rt2x00dev)
 547 {
 548         struct data_queue *queue;
 549
 550         tx_queue_for_each(rt2x00dev, queue) {
 551                 if (!rt2x00queue_empty(queue)) {
 552                         if (rt2x00usb_dma_timeout(queue))
 553                                 rt2x00usb_watchdog_tx_dma(queue);
 554                         if (rt2x00usb_status_timeout(queue))
 555                                 rt2x00usb_watchdog_tx_status(queue);
 556                 }
 557         }
 558 }
 559 EXPORT_SYMBOL_GPL(rt2x00usb_watchdog);
 560
 561 /*
 562  * Radio handlers
 563  */
 564 void rt2x00usb_disable_radio(struct rt2x00_dev *rt2x00dev)
 565 {
 566         rt2x00usb_vendor_request_sw(rt2x00dev, USB_RX_CONTROL, 0, 0,
 567                                     REGISTER_TIMEOUT);
 568 }
 569 EXPORT_SYMBOL_GPL(rt2x00usb_disable_radio);
 570
 571 /*
 572  * Device initialization handlers.
 573  */
 574 void rt2x00usb_clear_entry(struct queue_entry *entry)
 575 {
 576         entry->flags = 0;
 577
 578         if (entry->queue->qid == QID_RX)
 579                 rt2x00usb_kick_rx_entry(entry, NULL);
 580 }
 581 EXPORT_SYMBOL_GPL(rt2x00usb_clear_entry);
 582
 583 static void rt2x00usb_assign_endpoint(struct data_queue *queue,
 584                                       struct usb_endpoint_descriptor *ep_desc)
 585 {
 586         struct usb_device *usb_dev = to_usb_device_intf(queue->rt2x00dev->dev);
 587         int pipe;
 588
 589         queue->usb_endpoint = usb_endpoint_num(ep_desc);
 590
 591         if (queue->qid == QID_RX) {
 592                 pipe = usb_rcvbulkpipe(usb_dev, queue->usb_endpoint);
 593                 queue->usb_maxpacket = usb_maxpacket(usb_dev, pipe, 0);
 594         } else {
 595                 pipe = usb_sndbulkpipe(usb_dev, queue->usb_endpoint);
 596                 queue->usb_maxpacket = usb_maxpacket(usb_dev, pipe, 1);
 597         }
 598
 599         if (!queue->usb_maxpacket)
 600                 queue->usb_maxpacket = 1;
 601 }
 602
 603 static int rt2x00usb_find_endpoints(struct rt2x00_dev *rt2x00dev)
 604 {
 605         struct usb_interface *intf = to_usb_interface(rt2x00dev->dev);
 606         struct usb_host_interface *intf_desc = intf->cur_altsetting;
 607         struct usb_endpoint_descriptor *ep_desc;
 608         struct data_queue *queue = rt2x00dev->tx;
 609         struct usb_endpoint_descriptor *tx_ep_desc = NULL;
 610         unsigned int i;
 611
 612         /*
 613          * Walk through all available endpoints to search for "bulk in"
 614          * and "bulk out" endpoints. When we find such endpoints collect
 615          * the information we need from the descriptor and assign it
 616          * to the queue.
 617          */
 618         for (i = 0; i < intf_desc->desc.bNumEndpoints; i++) {
 619                 ep_desc = &intf_desc->endpoint[i].desc;
 620
 621                 if (usb_endpoint_is_bulk_in(ep_desc)) {
 622                         rt2x00usb_assign_endpoint(rt2x00dev->rx, ep_desc);
 623                 } else if (usb_endpoint_is_bulk_out(ep_desc) &&
 624                            (queue != queue_end(rt2x00dev))) {
 625                         rt2x00usb_assign_endpoint(queue, ep_desc);
 626                         queue = queue_next(queue);
 627
 628                         tx_ep_desc = ep_desc;
 629                 }
 630         }
 631
 632         /*
 633          * At least 1 endpoint for RX and 1 endpoint for TX must be available.
 634          */
 635         if (!rt2x00dev->rx->usb_endpoint || !rt2x00dev->tx->usb_endpoint) {
 636                 ERROR(rt2x00dev, "Bulk-in/Bulk-out endpoints not found\n");
 637                 return -EPIPE;
 638         }
 639
 640         /*
 641          * It might be possible not all queues have a dedicated endpoint.
 642          * Loop through all TX queues and copy the endpoint information
 643          * which we have gathered from already assigned endpoints.
 644          */
 645         txall_queue_for_each(rt2x00dev, queue) {
 646                 if (!queue->usb_endpoint)
 647                         rt2x00usb_assign_endpoint(queue, tx_ep_desc);
 648         }
 649
 650         return 0;
 651 }
 652
 653 static int rt2x00usb_alloc_entries(struct data_queue *queue)
 654 {
 655         struct rt2x00_dev *rt2x00dev = queue->rt2x00dev;
 656         struct queue_entry_priv_usb *entry_priv;
 657         struct queue_entry_priv_usb_bcn *bcn_priv;
 658         unsigned int i;
 659
 660         for (i = 0; i < queue->limit; i++) {
 661                 entry_priv = queue->entries[i].priv_data;
 662                 entry_priv->urb = usb_alloc_urb(0, GFP_KERNEL);
 663                 if (!entry_priv->urb)
 664                         return -ENOMEM;
 665         }
 666
 667         /*
 668          * If this is not the beacon queue or
 669          * no guardian byte was required for the beacon,
 670          * then we are done.
 671          */
 672         if (queue->qid != QID_BEACON ||
 673             !test_bit(REQUIRE_BEACON_GUARD, &rt2x00dev->cap_flags))
 674                 return 0;
 675
 676         for (i = 0; i < queue->limit; i++) {
 677                 bcn_priv = queue->entries[i].priv_data;
 678                 bcn_priv->guardian_urb = usb_alloc_urb(0, GFP_KERNEL);
 679                 if (!bcn_priv->guardian_urb)
 680                         return -ENOMEM;
 681         }
 682
 683         return 0;
 684 }
 685
 686 static void rt2x00usb_free_entries(struct data_queue *queue)
 687 {
 688         struct rt2x00_dev *rt2x00dev = queue->rt2x00dev;
 689         struct queue_entry_priv_usb *entry_priv;
 690         struct queue_entry_priv_usb_bcn *bcn_priv;
 691         unsigned int i;
 692
 693         if (!queue->entries)
 694                 return;
 695
 696         for (i = 0; i < queue->limit; i++) {
 697                 entry_priv = queue->entries[i].priv_data;
 698                 usb_kill_urb(entry_priv->urb);
 699                 usb_free_urb(entry_priv->urb);
 700         }
 701
 702         /*
 703          * If this is not the beacon queue or
 704          * no guardian byte was required for the beacon,
 705          * then we are done.
 706          */
 707         if (queue->qid != QID_BEACON ||
 708             !test_bit(REQUIRE_BEACON_GUARD, &rt2x00dev->cap_flags))
 709                 return;
 710
 711         for (i = 0; i < queue->limit; i++) {
 712                 bcn_priv = queue->entries[i].priv_data;
 713                 usb_kill_urb(bcn_priv->guardian_urb);
 714                 usb_free_urb(bcn_priv->guardian_urb);
 715         }
 716 }
 717
 718 int rt2x00usb_initialize(struct rt2x00_dev *rt2x00dev)
 719 {
 720         struct data_queue *queue;
 721         int status;
 722
 723         /*
 724          * Find endpoints for each queue
 725          */
 726         status = rt2x00usb_find_endpoints(rt2x00dev);
 727         if (status)
 728                 goto exit;
 729
 730         /*
 731          * Allocate DMA
 732          */
 733         queue_for_each(rt2x00dev, queue) {
 734                 status = rt2x00usb_alloc_entries(queue);
 735                 if (status)
 736                         goto exit;
 737         }
 738
 739         return 0;
 740
 741 exit:
 742         rt2x00usb_uninitialize(rt2x00dev);
 743
 744         return status;
 745 }
 746 EXPORT_SYMBOL_GPL(rt2x00usb_initialize);
 747
 748 void rt2x00usb_uninitialize(struct rt2x00_dev *rt2x00dev)
 749 {
 750         struct data_queue *queue;
 751
 752         queue_for_each(rt2x00dev, queue)
 753                 rt2x00usb_free_entries(queue);
 754 }
 755 EXPORT_SYMBOL_GPL(rt2x00usb_uninitialize);
 756
 757 /*
 758  * USB driver handlers.
 759  */
 760 static void rt2x00usb_free_reg(struct rt2x00_dev *rt2x00dev)
 761 {
 762         kfree(rt2x00dev->rf);
 763         rt2x00dev->rf = NULL;
 764
 765         kfree(rt2x00dev->eeprom);
 766         rt2x00dev->eeprom = NULL;
 767
 768         kfree(rt2x00dev->csr.cache);
 769         rt2x00dev->csr.cache = NULL;
 770 }
 771
 772 static int rt2x00usb_alloc_reg(struct rt2x00_dev *rt2x00dev)
 773 {
 774         rt2x00dev->csr.cache = kzalloc(CSR_CACHE_SIZE, GFP_KERNEL);
 775         if (!rt2x00dev->csr.cache)
 776                 goto exit;
 777
 778         rt2x00dev->eeprom = kzalloc(rt2x00dev->ops->eeprom_size, GFP_KERNEL);
 779         if (!rt2x00dev->eeprom)
 780                 goto exit;
 781
 782         rt2x00dev->rf = kzalloc(rt2x00dev->ops->rf_size, GFP_KERNEL);
 783         if (!rt2x00dev->rf)
 784                 goto exit;
 785
 786         return 0;
 787
 788 exit:
 789         ERROR_PROBE("Failed to allocate registers.\n");
 790
 791         rt2x00usb_free_reg(rt2x00dev);
 792
 793         return -ENOMEM;
 794 }
 795
 796 int rt2x00usb_probe(struct usb_interface *usb_intf,
 797                     const struct rt2x00_ops *ops)
 798 {
 799         struct usb_device *usb_dev = interface_to_usbdev(usb_intf);
 800         struct ieee80211_hw *hw;
 801         struct rt2x00_dev *rt2x00dev;
 802         int retval;
 803
 804         usb_dev = usb_get_dev(usb_dev);
 805         usb_reset_device(usb_dev);
 806
 807         hw = ieee80211_alloc_hw(sizeof(struct rt2x00_dev), ops->hw);
 808         if (!hw) {
 809                 ERROR_PROBE("Failed to allocate hardware.\n");
 810                 retval = -ENOMEM;
 811                 goto exit_put_device;
 812         }
 813
 814         usb_set_intfdata(usb_intf, hw);
 815
 816         rt2x00dev = hw->priv;
 817         rt2x00dev->dev = &usb_intf->dev;
 818         rt2x00dev->ops = ops;
 819         rt2x00dev->hw = hw;
 820
 821         rt2x00_set_chip_intf(rt2x00dev, RT2X00_CHIP_INTF_USB);
 822
 823         INIT_WORK(&rt2x00dev->rxdone_work, rt2x00usb_work_rxdone);
 824         INIT_WORK(&rt2x00dev->txdone_work, rt2x00usb_work_txdone);
 825         init_timer(&rt2x00dev->txstatus_timer);
 826
 827         retval = rt2x00usb_alloc_reg(rt2x00dev);
 828         if (retval)
 829                 goto exit_free_device;
 830
 831         retval = rt2x00lib_probe_dev(rt2x00dev);
 832         if (retval)
 833                 goto exit_free_reg;
 834
 835         return 0;
 836
 837 exit_free_reg:
 838         rt2x00usb_free_reg(rt2x00dev);
 839
 840 exit_free_device:
 841         ieee80211_free_hw(hw);
 842
 843 exit_put_device:
 844         usb_put_dev(usb_dev);
 845
 846         usb_set_intfdata(usb_intf, NULL);
 847
 848         return retval;
 849 }
 850 EXPORT_SYMBOL_GPL(rt2x00usb_probe);
 851
 852 void rt2x00usb_disconnect(struct usb_interface *usb_intf)
 853 {
 854         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 855         struct rt2x00_dev *rt2x00dev = hw->priv;
 856
 857         /*
 858          * Free all allocated data.
 859          */
 860         rt2x00lib_remove_dev(rt2x00dev);
 861         rt2x00usb_free_reg(rt2x00dev);
 862         ieee80211_free_hw(hw);
 863
 864         /*
 865          * Free the USB device data.
 866          */
 867         usb_set_intfdata(usb_intf, NULL);
 868         usb_put_dev(interface_to_usbdev(usb_intf));
 869 }
 870 EXPORT_SYMBOL_GPL(rt2x00usb_disconnect);
 871
 872 #ifdef CONFIG_PM
 873 int rt2x00usb_suspend(struct usb_interface *usb_intf, pm_message_t state)
 874 {
 875         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 876         struct rt2x00_dev *rt2x00dev = hw->priv;
 877         int retval;
 878
 879         retval = rt2x00lib_suspend(rt2x00dev, state);
 880         if (retval)
 881                 return retval;
 882
 883         /*
 884          * Decrease usbdev refcount.
 885          */
 886         usb_put_dev(interface_to_usbdev(usb_intf));
 887
 888         return 0;
 889 }
 890 EXPORT_SYMBOL_GPL(rt2x00usb_suspend);
 891
 892 int rt2x00usb_resume(struct usb_interface *usb_intf)
 893 {
 894         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 895         struct rt2x00_dev *rt2x00dev = hw->priv;
 896
 897         usb_get_dev(interface_to_usbdev(usb_intf));
 898
 899         return rt2x00lib_resume(rt2x00dev);
 900 }
 901 EXPORT_SYMBOL_GPL(rt2x00usb_resume);
 902 #endif /* CONFIG_PM */
 903
 904 /*
 905  * rt2x00usb module information.
 906  */
 907 MODULE_AUTHOR(DRV_PROJECT);
 908 MODULE_VERSION(DRV_VERSION);
 909 MODULE_DESCRIPTION("rt2x00 usb library");
 910 MODULE_LICENSE("GPL");