err.no Git - linux-2.6/blob - drivers/net/wireless/rt2x00/rt2x00usb.c

   1 /*
   2         Copyright (C) 2004 - 2008 rt2x00 SourceForge Project
   3         <http://rt2x00.serialmonkey.com>
   4
   5         This program is free software; you can redistribute it and/or modify
   6         it under the terms of the GNU General Public License as published by
   7         the Free Software Foundation; either version 2 of the License, or
   8         (at your option) any later version.
   9
  10         This program is distributed in the hope that it will be useful,
  11         but WITHOUT ANY WARRANTY; without even the implied warranty of
  12         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13         GNU General Public License for more details.
  14
  15         You should have received a copy of the GNU General Public License
  16         along with this program; if not, write to the
  17         Free Software Foundation, Inc.,
  18         59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  19  */
  20
  21 /*
  22         Module: rt2x00usb
  23         Abstract: rt2x00 generic usb device routines.
  24  */
  25
  26 #include <linux/kernel.h>
  27 #include <linux/module.h>
  28 #include <linux/usb.h>
  29 #include <linux/bug.h>
  30
  31 #include "rt2x00.h"
  32 #include "rt2x00usb.h"
  33
  34 /*
  35  * Interfacing with the HW.
  36  */
  37 int rt2x00usb_vendor_request(struct rt2x00_dev *rt2x00dev,
  38                              const u8 request, const u8 requesttype,
  39                              const u16 offset, const u16 value,
  40                              void *buffer, const u16 buffer_length,
  41                              const int timeout)
  42 {
  43         struct usb_device *usb_dev = rt2x00dev_usb_dev(rt2x00dev);
  44         int status;
  45         unsigned int i;
  46         unsigned int pipe =
  47             (requesttype == USB_VENDOR_REQUEST_IN) ?
  48             usb_rcvctrlpipe(usb_dev, 0) : usb_sndctrlpipe(usb_dev, 0);
  49
  50
  51         for (i = 0; i < REGISTER_BUSY_COUNT; i++) {
  52                 status = usb_control_msg(usb_dev, pipe, request, requesttype,
  53                                          value, offset, buffer, buffer_length,
  54                                          timeout);
  55                 if (status >= 0)
  56                         return 0;
  57
  58                 /*
  59                  * Check for errors
  60                  * -ENODEV: Device has disappeared, no point continuing.
  61                  * All other errors: Try again.
  62                  */
  63                 else if (status == -ENODEV)
  64                         break;
  65         }
  66
  67         ERROR(rt2x00dev,
  68               "Vendor Request 0x%02x failed for offset 0x%04x with error %d.\n",
  69               request, offset, status);
  70
  71         return status;
  72 }
  73 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_request);
  74
  75 int rt2x00usb_vendor_req_buff_lock(struct rt2x00_dev *rt2x00dev,
  76                                    const u8 request, const u8 requesttype,
  77                                    const u16 offset, void *buffer,
  78                                    const u16 buffer_length, const int timeout)
  79 {
  80         int status;
  81
  82         BUG_ON(!mutex_is_locked(&rt2x00dev->usb_cache_mutex));
  83
  84         /*
  85          * Check for Cache availability.
  86          */
  87         if (unlikely(!rt2x00dev->csr.cache || buffer_length > CSR_CACHE_SIZE)) {
  88                 ERROR(rt2x00dev, "CSR cache not available.\n");
  89                 return -ENOMEM;
  90         }
  91
  92         if (requesttype == USB_VENDOR_REQUEST_OUT)
  93                 memcpy(rt2x00dev->csr.cache, buffer, buffer_length);
  94
  95         status = rt2x00usb_vendor_request(rt2x00dev, request, requesttype,
  96                                           offset, 0, rt2x00dev->csr.cache,
  97                                           buffer_length, timeout);
  98
  99         if (!status && requesttype == USB_VENDOR_REQUEST_IN)
 100                 memcpy(buffer, rt2x00dev->csr.cache, buffer_length);
 101
 102         return status;
 103 }
 104 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_req_buff_lock);
 105
 106 int rt2x00usb_vendor_request_buff(struct rt2x00_dev *rt2x00dev,
 107                                   const u8 request, const u8 requesttype,
 108                                   const u16 offset, void *buffer,
 109                                   const u16 buffer_length, const int timeout)
 110 {
 111         int status;
 112
 113         mutex_lock(&rt2x00dev->usb_cache_mutex);
 114
 115         status = rt2x00usb_vendor_req_buff_lock(rt2x00dev, request,
 116                                                 requesttype, offset, buffer,
 117                                                 buffer_length, timeout);
 118
 119         mutex_unlock(&rt2x00dev->usb_cache_mutex);
 120
 121         return status;
 122 }
 123 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_request_buff);
 124
 125 /*
 126  * TX data handlers.
 127  */
 128 static void rt2x00usb_interrupt_txdone(struct urb *urb)
 129 {
 130         struct queue_entry *entry = (struct queue_entry *)urb->context;
 131         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 132         struct queue_entry_priv_usb_tx *priv_tx = entry->priv_data;
 133         struct txdone_entry_desc txdesc;
 134         __le32 *txd = (__le32 *)entry->skb->data;
 135         u32 word;
 136
 137         if (!test_bit(DEVICE_ENABLED_RADIO, &rt2x00dev->flags) ||
 138             !__test_and_clear_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
 139                 return;
 140
 141         rt2x00_desc_read(txd, 0, &word);
 142
 143         /*
 144          * Remove the descriptor data from the buffer.
 145          */
 146         skb_pull(entry->skb, entry->queue->desc_size);
 147
 148         /*
 149          * Obtain the status about this packet.
 150          * Note that when the status is 0 it does not mean the
 151          * frame was send out correctly. It only means the frame
 152          * was succesfully pushed to the hardware, we have no
 153          * way to determine the transmission status right now.
 154          * (Only indirectly by looking at the failed TX counters
 155          * in the register).
 156          */
 157         if (!urb->status)
 158                 __set_bit(TXDONE_UNKNOWN, &txdesc.flags);
 159         else
 160                 __set_bit(TXDONE_FAILURE, &txdesc.flags);
 161         txdesc.retry = 0;
 162         txdesc.control = &priv_tx->control;
 163
 164         rt2x00lib_txdone(entry, &txdesc);
 165
 166         /*
 167          * Make this entry available for reuse.
 168          */
 169         entry->flags = 0;
 170         rt2x00queue_index_inc(entry->queue, Q_INDEX_DONE);
 171
 172         /*
 173          * If the data queue was full before the txdone handler
 174          * we must make sure the packet queue in the mac80211 stack
 175          * is reenabled when the txdone handler has finished.
 176          */
 177         if (!rt2x00queue_full(entry->queue))
 178                 ieee80211_wake_queue(rt2x00dev->hw, priv_tx->control.queue);
 179 }
 180
 181 int rt2x00usb_write_tx_data(struct rt2x00_dev *rt2x00dev,
 182                             struct data_queue *queue, struct sk_buff *skb,
 183                             struct ieee80211_tx_control *control)
 184 {
 185         struct usb_device *usb_dev = rt2x00dev_usb_dev(rt2x00dev);
 186         struct queue_entry *entry = rt2x00queue_get_entry(queue, Q_INDEX);
 187         struct queue_entry_priv_usb_tx *priv_tx = entry->priv_data;
 188         struct skb_frame_desc *skbdesc;
 189         struct txentry_desc txdesc;
 190         u32 length;
 191
 192         if (rt2x00queue_full(queue))
 193                 return -EINVAL;
 194
 195         if (test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags)) {
 196                 ERROR(rt2x00dev,
 197                       "Arrived at non-free entry in the non-full queue %d.\n"
 198                       "Please file bug report to %s.\n",
 199                       entry->queue->qid, DRV_PROJECT);
 200                 return -EINVAL;
 201         }
 202
 203         /*
 204          * Copy all TX descriptor information into txdesc,
 205          * after that we are free to use the skb->cb array
 206          * for our information.
 207          */
 208         entry->skb = skb;
 209         rt2x00queue_create_tx_descriptor(entry, &txdesc, control);
 210
 211         /*
 212          * Add the descriptor in front of the skb.
 213          */
 214         skb_push(skb, queue->desc_size);
 215         memset(skb->data, 0, queue->desc_size);
 216
 217         /*
 218          * Fill in skb descriptor
 219          */
 220         skbdesc = get_skb_frame_desc(skb);
 221         skbdesc->data = skb->data + queue->desc_size;
 222         skbdesc->data_len = skb->len - queue->desc_size;
 223         skbdesc->desc = skb->data;
 224         skbdesc->desc_len = queue->desc_size;
 225         skbdesc->entry = entry;
 226
 227         memcpy(&priv_tx->control, control, sizeof(priv_tx->control));
 228         rt2x00queue_write_tx_descriptor(entry, &txdesc);
 229
 230         /*
 231          * USB devices cannot blindly pass the skb->len as the
 232          * length of the data to usb_fill_bulk_urb. Pass the skb
 233          * to the driver to determine what the length should be.
 234          */
 235         length = rt2x00dev->ops->lib->get_tx_data_len(rt2x00dev, skb);
 236
 237         /*
 238          * Initialize URB and send the frame to the device.
 239          */
 240         __set_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags);
 241         usb_fill_bulk_urb(priv_tx->urb, usb_dev, usb_sndbulkpipe(usb_dev, 1),
 242                           skb->data, length, rt2x00usb_interrupt_txdone, entry);
 243         usb_submit_urb(priv_tx->urb, GFP_ATOMIC);
 244
 245         rt2x00queue_index_inc(queue, Q_INDEX);
 246
 247         return 0;
 248 }
 249 EXPORT_SYMBOL_GPL(rt2x00usb_write_tx_data);
 250
 251 /*
 252  * RX data handlers.
 253  */
 254 static struct sk_buff* rt2x00usb_alloc_rxskb(struct data_queue *queue)
 255 {
 256         struct sk_buff *skb;
 257         unsigned int frame_size;
 258         unsigned int reserved_size;
 259
 260         /*
 261          * The frame size includes descriptor size, because the
 262          * hardware directly receive the frame into the skbuffer.
 263          */
 264         frame_size = queue->data_size + queue->desc_size;
 265
 266         /*
 267          * For the allocation we should keep a few things in mind:
 268          * 1) 4byte alignment of 802.11 payload
 269          *
 270          * For (1) we need at most 4 bytes to guarentee the correct
 271          * alignment. We are going to optimize the fact that the chance
 272          * that the 802.11 header_size % 4 == 2 is much bigger then
 273          * anything else. However since we need to move the frame up
 274          * to 3 bytes to the front, which means we need to preallocate
 275          * 6 bytes.
 276          */
 277         reserved_size = 6;
 278
 279         /*
 280          * Allocate skbuffer.
 281          */
 282         skb = dev_alloc_skb(frame_size + reserved_size);
 283         if (!skb)
 284                 return NULL;
 285
 286         skb_reserve(skb, reserved_size);
 287         skb_put(skb, frame_size);
 288
 289         return skb;
 290 }
 291
 292 static void rt2x00usb_interrupt_rxdone(struct urb *urb)
 293 {
 294         struct queue_entry *entry = (struct queue_entry *)urb->context;
 295         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 296         struct sk_buff *skb;
 297         struct skb_frame_desc *skbdesc;
 298         struct rxdone_entry_desc rxdesc;
 299         unsigned int header_size;
 300         unsigned int align;
 301
 302         if (!test_bit(DEVICE_ENABLED_RADIO, &rt2x00dev->flags) ||
 303             !test_and_clear_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
 304                 return;
 305
 306         /*
 307          * Check if the received data is simply too small
 308          * to be actually valid, or if the urb is signaling
 309          * a problem.
 310          */
 311         if (urb->actual_length < entry->queue->desc_size || urb->status)
 312                 goto skip_entry;
 313
 314         /*
 315          * Fill in skb descriptor
 316          */
 317         skbdesc = get_skb_frame_desc(entry->skb);
 318         memset(skbdesc, 0, sizeof(*skbdesc));
 319         skbdesc->entry = entry;
 320
 321         memset(&rxdesc, 0, sizeof(rxdesc));
 322         rt2x00dev->ops->lib->fill_rxdone(entry, &rxdesc);
 323
 324         header_size = ieee80211_get_hdrlen_from_skb(entry->skb);
 325
 326         /*
 327          * The data behind the ieee80211 header must be
 328          * aligned on a 4 byte boundary. We already reserved
 329          * 2 bytes for header_size % 4 == 2 optimization.
 330          * To determine the number of bytes which the data
 331          * should be moved to the left, we must add these
 332          * 2 bytes to the header_size.
 333          */
 334         align = (header_size + 2) % 4;
 335
 336         if (align) {
 337                 skb_push(entry->skb, align);
 338                 /* Move entire frame in 1 command */
 339                 memmove(entry->skb->data, entry->skb->data + align,
 340                         rxdesc.size);
 341         }
 342
 343         /* Update data pointers, trim buffer to correct size */
 344         skbdesc->data = entry->skb->data;
 345         skb_trim(entry->skb, rxdesc.size);
 346
 347         /*
 348          * Allocate a new sk buffer to replace the current one.
 349          * If allocation fails, we should drop the current frame
 350          * so we can recycle the existing sk buffer for the new frame.
 351          */
 352         skb = rt2x00usb_alloc_rxskb(entry->queue);
 353         if (!skb)
 354                 goto skip_entry;
 355
 356         /*
 357          * Send the frame to rt2x00lib for further processing.
 358          */
 359         rt2x00lib_rxdone(entry, &rxdesc);
 360
 361         /*
 362          * Replace current entry's skb with the newly allocated one,
 363          * and reinitialize the urb.
 364          */
 365         entry->skb = skb;
 366         urb->transfer_buffer = entry->skb->data;
 367         urb->transfer_buffer_length = entry->skb->len;
 368
 369 skip_entry:
 370         if (test_bit(DEVICE_ENABLED_RADIO, &entry->queue->rt2x00dev->flags)) {
 371                 __set_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags);
 372                 usb_submit_urb(urb, GFP_ATOMIC);
 373         }
 374
 375         rt2x00queue_index_inc(entry->queue, Q_INDEX);
 376 }
 377
 378 /*
 379  * Radio handlers
 380  */
 381 void rt2x00usb_disable_radio(struct rt2x00_dev *rt2x00dev)
 382 {
 383         struct queue_entry_priv_usb_rx *priv_rx;
 384         struct queue_entry_priv_usb_tx *priv_tx;
 385         struct queue_entry_priv_usb_bcn *priv_bcn;
 386         struct data_queue *queue;
 387         unsigned int i;
 388
 389         rt2x00usb_vendor_request_sw(rt2x00dev, USB_RX_CONTROL, 0, 0,
 390                                     REGISTER_TIMEOUT);
 391
 392         /*
 393          * Cancel all queues.
 394          */
 395         for (i = 0; i < rt2x00dev->rx->limit; i++) {
 396                 priv_rx = rt2x00dev->rx->entries[i].priv_data;
 397                 usb_kill_urb(priv_rx->urb);
 398         }
 399
 400         tx_queue_for_each(rt2x00dev, queue) {
 401                 for (i = 0; i < queue->limit; i++) {
 402                         priv_tx = queue->entries[i].priv_data;
 403                         usb_kill_urb(priv_tx->urb);
 404                 }
 405         }
 406
 407         for (i = 0; i < rt2x00dev->bcn->limit; i++) {
 408                 priv_bcn = rt2x00dev->bcn->entries[i].priv_data;
 409                 usb_kill_urb(priv_bcn->urb);
 410
 411                 if (priv_bcn->guardian_urb)
 412                         usb_kill_urb(priv_bcn->guardian_urb);
 413         }
 414
 415         if (!test_bit(DRIVER_REQUIRE_ATIM_QUEUE, &rt2x00dev->flags))
 416                 return;
 417
 418         for (i = 0; i < rt2x00dev->bcn[1].limit; i++) {
 419                 priv_tx = rt2x00dev->bcn[1].entries[i].priv_data;
 420                 usb_kill_urb(priv_tx->urb);
 421         }
 422 }
 423 EXPORT_SYMBOL_GPL(rt2x00usb_disable_radio);
 424
 425 /*
 426  * Device initialization handlers.
 427  */
 428 void rt2x00usb_init_rxentry(struct rt2x00_dev *rt2x00dev,
 429                             struct queue_entry *entry)
 430 {
 431         struct usb_device *usb_dev = rt2x00dev_usb_dev(rt2x00dev);
 432         struct queue_entry_priv_usb_rx *priv_rx = entry->priv_data;
 433
 434         usb_fill_bulk_urb(priv_rx->urb, usb_dev,
 435                           usb_rcvbulkpipe(usb_dev, 1),
 436                           entry->skb->data, entry->skb->len,
 437                           rt2x00usb_interrupt_rxdone, entry);
 438
 439         __set_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags);
 440         usb_submit_urb(priv_rx->urb, GFP_ATOMIC);
 441 }
 442 EXPORT_SYMBOL_GPL(rt2x00usb_init_rxentry);
 443
 444 void rt2x00usb_init_txentry(struct rt2x00_dev *rt2x00dev,
 445                             struct queue_entry *entry)
 446 {
 447         entry->flags = 0;
 448 }
 449 EXPORT_SYMBOL_GPL(rt2x00usb_init_txentry);
 450
 451 static int rt2x00usb_alloc_urb(struct rt2x00_dev *rt2x00dev,
 452                                struct data_queue *queue)
 453 {
 454         struct queue_entry_priv_usb_rx *priv_rx;
 455         struct queue_entry_priv_usb_tx *priv_tx;
 456         struct queue_entry_priv_usb_bcn *priv_bcn;
 457         struct urb *urb;
 458         unsigned int guardian =
 459             test_bit(DRIVER_REQUIRE_BEACON_GUARD, &rt2x00dev->flags);
 460         unsigned int i;
 461
 462         /*
 463          * Allocate the URB's
 464          */
 465         for (i = 0; i < queue->limit; i++) {
 466                 urb = usb_alloc_urb(0, GFP_KERNEL);
 467                 if (!urb)
 468                         return -ENOMEM;
 469
 470                 if (queue->qid == QID_RX) {
 471                         priv_rx = queue->entries[i].priv_data;
 472                         priv_rx->urb = urb;
 473                 } else if (queue->qid == QID_MGMT && guardian) {
 474                         priv_bcn = queue->entries[i].priv_data;
 475                         priv_bcn->urb = urb;
 476
 477                         urb = usb_alloc_urb(0, GFP_KERNEL);
 478                         if (!urb)
 479                                 return -ENOMEM;
 480
 481                         priv_bcn->guardian_urb = urb;
 482                 } else {
 483                         priv_tx = queue->entries[i].priv_data;
 484                         priv_tx->urb = urb;
 485                 }
 486         }
 487
 488         return 0;
 489 }
 490
 491 static void rt2x00usb_free_urb(struct rt2x00_dev *rt2x00dev,
 492                                struct data_queue *queue)
 493 {
 494         struct queue_entry_priv_usb_rx *priv_rx;
 495         struct queue_entry_priv_usb_tx *priv_tx;
 496         struct queue_entry_priv_usb_bcn *priv_bcn;
 497         struct urb *urb;
 498         unsigned int guardian =
 499             test_bit(DRIVER_REQUIRE_BEACON_GUARD, &rt2x00dev->flags);
 500         unsigned int i;
 501
 502         if (!queue->entries)
 503                 return;
 504
 505         for (i = 0; i < queue->limit; i++) {
 506                 if (queue->qid == QID_RX) {
 507                         priv_rx = queue->entries[i].priv_data;
 508                         urb = priv_rx->urb;
 509                 } else if (queue->qid == QID_MGMT && guardian) {
 510                         priv_bcn = queue->entries[i].priv_data;
 511
 512                         usb_kill_urb(priv_bcn->guardian_urb);
 513                         usb_free_urb(priv_bcn->guardian_urb);
 514
 515                         urb = priv_bcn->urb;
 516                 } else {
 517                         priv_tx = queue->entries[i].priv_data;
 518                         urb = priv_tx->urb;
 519                 }
 520
 521                 usb_kill_urb(urb);
 522                 usb_free_urb(urb);
 523                 if (queue->entries[i].skb)
 524                         kfree_skb(queue->entries[i].skb);
 525         }
 526 }
 527
 528 int rt2x00usb_initialize(struct rt2x00_dev *rt2x00dev)
 529 {
 530         struct data_queue *queue;
 531         struct sk_buff *skb;
 532         unsigned int entry_size;
 533         unsigned int i;
 534         int uninitialized_var(status);
 535
 536         /*
 537          * Allocate DMA
 538          */
 539         queue_for_each(rt2x00dev, queue) {
 540                 status = rt2x00usb_alloc_urb(rt2x00dev, queue);
 541                 if (status)
 542                         goto exit;
 543         }
 544
 545         /*
 546          * For the RX queue, skb's should be allocated.
 547          */
 548         entry_size = rt2x00dev->rx->data_size + rt2x00dev->rx->desc_size;
 549         for (i = 0; i < rt2x00dev->rx->limit; i++) {
 550                 skb = rt2x00usb_alloc_rxskb(rt2x00dev->rx);
 551                 if (!skb)
 552                         goto exit;
 553
 554                 rt2x00dev->rx->entries[i].skb = skb;
 555         }
 556
 557         return 0;
 558
 559 exit:
 560         rt2x00usb_uninitialize(rt2x00dev);
 561
 562         return status;
 563 }
 564 EXPORT_SYMBOL_GPL(rt2x00usb_initialize);
 565
 566 void rt2x00usb_uninitialize(struct rt2x00_dev *rt2x00dev)
 567 {
 568         struct data_queue *queue;
 569
 570         queue_for_each(rt2x00dev, queue)
 571                 rt2x00usb_free_urb(rt2x00dev, queue);
 572 }
 573 EXPORT_SYMBOL_GPL(rt2x00usb_uninitialize);
 574
 575 /*
 576  * USB driver handlers.
 577  */
 578 static void rt2x00usb_free_reg(struct rt2x00_dev *rt2x00dev)
 579 {
 580         kfree(rt2x00dev->rf);
 581         rt2x00dev->rf = NULL;
 582
 583         kfree(rt2x00dev->eeprom);
 584         rt2x00dev->eeprom = NULL;
 585
 586         kfree(rt2x00dev->csr.cache);
 587         rt2x00dev->csr.cache = NULL;
 588 }
 589
 590 static int rt2x00usb_alloc_reg(struct rt2x00_dev *rt2x00dev)
 591 {
 592         rt2x00dev->csr.cache = kzalloc(CSR_CACHE_SIZE, GFP_KERNEL);
 593         if (!rt2x00dev->csr.cache)
 594                 goto exit;
 595
 596         rt2x00dev->eeprom = kzalloc(rt2x00dev->ops->eeprom_size, GFP_KERNEL);
 597         if (!rt2x00dev->eeprom)
 598                 goto exit;
 599
 600         rt2x00dev->rf = kzalloc(rt2x00dev->ops->rf_size, GFP_KERNEL);
 601         if (!rt2x00dev->rf)
 602                 goto exit;
 603
 604         return 0;
 605
 606 exit:
 607         ERROR_PROBE("Failed to allocate registers.\n");
 608
 609         rt2x00usb_free_reg(rt2x00dev);
 610
 611         return -ENOMEM;
 612 }
 613
 614 int rt2x00usb_probe(struct usb_interface *usb_intf,
 615                     const struct usb_device_id *id)
 616 {
 617         struct usb_device *usb_dev = interface_to_usbdev(usb_intf);
 618         struct rt2x00_ops *ops = (struct rt2x00_ops *)id->driver_info;
 619         struct ieee80211_hw *hw;
 620         struct rt2x00_dev *rt2x00dev;
 621         int retval;
 622
 623         usb_dev = usb_get_dev(usb_dev);
 624
 625         hw = ieee80211_alloc_hw(sizeof(struct rt2x00_dev), ops->hw);
 626         if (!hw) {
 627                 ERROR_PROBE("Failed to allocate hardware.\n");
 628                 retval = -ENOMEM;
 629                 goto exit_put_device;
 630         }
 631
 632         usb_set_intfdata(usb_intf, hw);
 633
 634         rt2x00dev = hw->priv;
 635         rt2x00dev->dev = usb_intf;
 636         rt2x00dev->ops = ops;
 637         rt2x00dev->hw = hw;
 638         mutex_init(&rt2x00dev->usb_cache_mutex);
 639
 640         rt2x00dev->usb_maxpacket =
 641             usb_maxpacket(usb_dev, usb_sndbulkpipe(usb_dev, 1), 1);
 642         if (!rt2x00dev->usb_maxpacket)
 643                 rt2x00dev->usb_maxpacket = 1;
 644
 645         retval = rt2x00usb_alloc_reg(rt2x00dev);
 646         if (retval)
 647                 goto exit_free_device;
 648
 649         retval = rt2x00lib_probe_dev(rt2x00dev);
 650         if (retval)
 651                 goto exit_free_reg;
 652
 653         return 0;
 654
 655 exit_free_reg:
 656         rt2x00usb_free_reg(rt2x00dev);
 657
 658 exit_free_device:
 659         ieee80211_free_hw(hw);
 660
 661 exit_put_device:
 662         usb_put_dev(usb_dev);
 663
 664         usb_set_intfdata(usb_intf, NULL);
 665
 666         return retval;
 667 }
 668 EXPORT_SYMBOL_GPL(rt2x00usb_probe);
 669
 670 void rt2x00usb_disconnect(struct usb_interface *usb_intf)
 671 {
 672         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 673         struct rt2x00_dev *rt2x00dev = hw->priv;
 674
 675         /*
 676          * Free all allocated data.
 677          */
 678         rt2x00lib_remove_dev(rt2x00dev);
 679         rt2x00usb_free_reg(rt2x00dev);
 680         ieee80211_free_hw(hw);
 681
 682         /*
 683          * Free the USB device data.
 684          */
 685         usb_set_intfdata(usb_intf, NULL);
 686         usb_put_dev(interface_to_usbdev(usb_intf));
 687 }
 688 EXPORT_SYMBOL_GPL(rt2x00usb_disconnect);
 689
 690 #ifdef CONFIG_PM
 691 int rt2x00usb_suspend(struct usb_interface *usb_intf, pm_message_t state)
 692 {
 693         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 694         struct rt2x00_dev *rt2x00dev = hw->priv;
 695         int retval;
 696
 697         retval = rt2x00lib_suspend(rt2x00dev, state);
 698         if (retval)
 699                 return retval;
 700
 701         rt2x00usb_free_reg(rt2x00dev);
 702
 703         /*
 704          * Decrease usbdev refcount.
 705          */
 706         usb_put_dev(interface_to_usbdev(usb_intf));
 707
 708         return 0;
 709 }
 710 EXPORT_SYMBOL_GPL(rt2x00usb_suspend);
 711
 712 int rt2x00usb_resume(struct usb_interface *usb_intf)
 713 {
 714         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 715         struct rt2x00_dev *rt2x00dev = hw->priv;
 716         int retval;
 717
 718         usb_get_dev(interface_to_usbdev(usb_intf));
 719
 720         retval = rt2x00usb_alloc_reg(rt2x00dev);
 721         if (retval)
 722                 return retval;
 723
 724         retval = rt2x00lib_resume(rt2x00dev);
 725         if (retval)
 726                 goto exit_free_reg;
 727
 728         return 0;
 729
 730 exit_free_reg:
 731         rt2x00usb_free_reg(rt2x00dev);
 732
 733         return retval;
 734 }
 735 EXPORT_SYMBOL_GPL(rt2x00usb_resume);
 736 #endif /* CONFIG_PM */
 737
 738 /*
 739  * rt2x00usb module information.
 740  */
 741 MODULE_AUTHOR(DRV_PROJECT);
 742 MODULE_VERSION(DRV_VERSION);
 743 MODULE_DESCRIPTION("rt2x00 usb library");
 744 MODULE_LICENSE("GPL");