drivers/net/wireless/rt2x00/rt2x00usb.c

   1 /*
   2         Copyright (C) 2004 - 2009 Ivo van Doorn <IvDoorn@gmail.com>
   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/slab.h>
  29 #include <linux/usb.h>
  30 #include <linux/bug.h>
  31
  32 #include "rt2x00.h"
  33 #include "rt2x00usb.h"
  34
  35 /*
  36  * Interfacing with the HW.
  37  */
  38 int rt2x00usb_vendor_request(struct rt2x00_dev *rt2x00dev,
  39                              const u8 request, const u8 requesttype,
  40                              const u16 offset, const u16 value,
  41                              void *buffer, const u16 buffer_length,
  42                              const int timeout)
  43 {
  44         struct usb_device *usb_dev = to_usb_device_intf(rt2x00dev->dev);
  45         int status;
  46         unsigned int i;
  47         unsigned int pipe =
  48             (requesttype == USB_VENDOR_REQUEST_IN) ?
  49             usb_rcvctrlpipe(usb_dev, 0) : usb_sndctrlpipe(usb_dev, 0);
  50
  51         if (!test_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags))
  52                 return -ENODEV;
  53
  54         for (i = 0; i < REGISTER_BUSY_COUNT; i++) {
  55                 status = usb_control_msg(usb_dev, pipe, request, requesttype,
  56                                          value, offset, buffer, buffer_length,
  57                                          timeout);
  58                 if (status >= 0)
  59                         return 0;
  60
  61                 /*
  62                  * Check for errors
  63                  * -ENODEV: Device has disappeared, no point continuing.
  64                  * All other errors: Try again.
  65                  */
  66                 else if (status == -ENODEV) {
  67                         clear_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags);
  68                         break;
  69                 }
  70         }
  71
  72         ERROR(rt2x00dev,
  73               "Vendor Request 0x%02x failed for offset 0x%04x with error %d.\n",
  74               request, offset, status);
  75
  76         return status;
  77 }
  78 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_request);
  79
  80 int rt2x00usb_vendor_req_buff_lock(struct rt2x00_dev *rt2x00dev,
  81                                    const u8 request, const u8 requesttype,
  82                                    const u16 offset, void *buffer,
  83                                    const u16 buffer_length, const int timeout)
  84 {
  85         int status;
  86
  87         BUG_ON(!mutex_is_locked(&rt2x00dev->csr_mutex));
  88
  89         /*
  90          * Check for Cache availability.
  91          */
  92         if (unlikely(!rt2x00dev->csr.cache || buffer_length > CSR_CACHE_SIZE)) {
  93                 ERROR(rt2x00dev, "CSR cache not available.\n");
  94                 return -ENOMEM;
  95         }
  96
  97         if (requesttype == USB_VENDOR_REQUEST_OUT)
  98                 memcpy(rt2x00dev->csr.cache, buffer, buffer_length);
  99
 100         status = rt2x00usb_vendor_request(rt2x00dev, request, requesttype,
 101                                           offset, 0, rt2x00dev->csr.cache,
 102                                           buffer_length, timeout);
 103
 104         if (!status && requesttype == USB_VENDOR_REQUEST_IN)
 105                 memcpy(buffer, rt2x00dev->csr.cache, buffer_length);
 106
 107         return status;
 108 }
 109 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_req_buff_lock);
 110
 111 int rt2x00usb_vendor_request_buff(struct rt2x00_dev *rt2x00dev,
 112                                   const u8 request, const u8 requesttype,
 113                                   const u16 offset, void *buffer,
 114                                   const u16 buffer_length, const int timeout)
 115 {
 116         int status = 0;
 117         unsigned char *tb;
 118         u16 off, len, bsize;
 119
 120         mutex_lock(&rt2x00dev->csr_mutex);
 121
 122         tb  = (char *)buffer;
 123         off = offset;
 124         len = buffer_length;
 125         while (len && !status) {
 126                 bsize = min_t(u16, CSR_CACHE_SIZE, len);
 127                 status = rt2x00usb_vendor_req_buff_lock(rt2x00dev, request,
 128                                                         requesttype, off, tb,
 129                                                         bsize, timeout);
 130
 131                 tb  += bsize;
 132                 len -= bsize;
 133                 off += bsize;
 134         }
 135
 136         mutex_unlock(&rt2x00dev->csr_mutex);
 137
 138         return status;
 139 }
 140 EXPORT_SYMBOL_GPL(rt2x00usb_vendor_request_buff);
 141
 142 int rt2x00usb_regbusy_read(struct rt2x00_dev *rt2x00dev,
 143                            const unsigned int offset,
 144                            const struct rt2x00_field32 field,
 145                            u32 *reg)
 146 {
 147         unsigned int i;
 148
 149         if (!test_bit(DEVICE_STATE_PRESENT, &rt2x00dev->flags))
 150                 return -ENODEV;
 151
 152         for (i = 0; i < REGISTER_BUSY_COUNT; i++) {
 153                 rt2x00usb_register_read_lock(rt2x00dev, offset, reg);
 154                 if (!rt2x00_get_field32(*reg, field))
 155                         return 1;
 156                 udelay(REGISTER_BUSY_DELAY);
 157         }
 158
 159         ERROR(rt2x00dev, "Indirect register access failed: "
 160               "offset=0x%.08x, value=0x%.08x\n", offset, *reg);
 161         *reg = ~0;
 162
 163         return 0;
 164 }
 165 EXPORT_SYMBOL_GPL(rt2x00usb_regbusy_read);
 166
 167 /*
 168  * TX data handlers.
 169  */
 170 static void rt2x00usb_interrupt_txdone(struct urb *urb)
 171 {
 172         struct queue_entry *entry = (struct queue_entry *)urb->context;
 173         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 174         struct skb_frame_desc *skbdesc = get_skb_frame_desc(entry->skb);
 175         struct txdone_entry_desc txdesc;
 176
 177         if (!test_bit(DEVICE_STATE_ENABLED_RADIO, &rt2x00dev->flags) ||
 178             !test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
 179                 return;
 180
 181         /*
 182          * Remove the descriptor from the front of the skb.
 183          */
 184         skb_pull(entry->skb, entry->queue->desc_size);
 185
 186         /*
 187          * Signal that the TX descriptor is no longer in the skb.
 188          */
 189         skbdesc->flags &= ~SKBDESC_DESC_IN_SKB;
 190
 191         /*
 192          * Obtain the status about this packet.
 193          * Note that when the status is 0 it does not mean the
 194          * frame was send out correctly. It only means the frame
 195          * was succesfully pushed to the hardware, we have no
 196          * way to determine the transmission status right now.
 197          * (Only indirectly by looking at the failed TX counters
 198          * in the register).
 199          */
 200         txdesc.flags = 0;
 201         if (!urb->status)
 202                 __set_bit(TXDONE_UNKNOWN, &txdesc.flags);
 203         else
 204                 __set_bit(TXDONE_FAILURE, &txdesc.flags);
 205         txdesc.retry = 0;
 206
 207         rt2x00lib_txdone(entry, &txdesc);
 208 }
 209
 210 int rt2x00usb_write_tx_data(struct queue_entry *entry,
 211                             struct txentry_desc *txdesc)
 212 {
 213         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 214         struct usb_device *usb_dev = to_usb_device_intf(rt2x00dev->dev);
 215         struct queue_entry_priv_usb *entry_priv = entry->priv_data;
 216         u32 length;
 217
 218         /*
 219          * Add the descriptor in front of the skb.
 220          */
 221         skb_push(entry->skb, entry->queue->desc_size);
 222         memset(entry->skb->data, 0, entry->queue->desc_size);
 223
 224         /*
 225          * USB devices cannot blindly pass the skb->len as the
 226          * length of the data to usb_fill_bulk_urb. Pass the skb
 227          * to the driver to determine what the length should be.
 228          */
 229         length = rt2x00dev->ops->lib->get_tx_data_len(entry);
 230
 231         usb_fill_bulk_urb(entry_priv->urb, usb_dev,
 232                           usb_sndbulkpipe(usb_dev, entry->queue->usb_endpoint),
 233                           entry->skb->data, length,
 234                           rt2x00usb_interrupt_txdone, entry);
 235
 236         /*
 237          * Call the driver's write_tx_datadesc function, if it exists.
 238          */
 239         if (rt2x00dev->ops->lib->write_tx_datadesc)
 240                 rt2x00dev->ops->lib->write_tx_datadesc(entry, txdesc);
 241
 242         return 0;
 243 }
 244 EXPORT_SYMBOL_GPL(rt2x00usb_write_tx_data);
 245
 246 static inline void rt2x00usb_kick_tx_entry(struct queue_entry *entry)
 247 {
 248         struct queue_entry_priv_usb *entry_priv = entry->priv_data;
 249
 250         if (test_and_clear_bit(ENTRY_DATA_PENDING, &entry->flags))
 251                 usb_submit_urb(entry_priv->urb, GFP_ATOMIC);
 252 }
 253
 254 void rt2x00usb_kick_tx_queue(struct rt2x00_dev *rt2x00dev,
 255                              const enum data_queue_qid qid)
 256 {
 257         struct data_queue *queue = rt2x00queue_get_queue(rt2x00dev, qid);
 258         unsigned long irqflags;
 259         unsigned int index;
 260         unsigned int index_done;
 261         unsigned int i;
 262
 263         /*
 264          * Only protect the range we are going to loop over,
 265          * if during our loop a extra entry is set to pending
 266          * it should not be kicked during this run, since it
 267          * is part of another TX operation.
 268          */
 269         spin_lock_irqsave(&queue->lock, irqflags);
 270         index = queue->index[Q_INDEX];
 271         index_done = queue->index[Q_INDEX_DONE];
 272         spin_unlock_irqrestore(&queue->lock, irqflags);
 273
 274         /*
 275          * Start from the TX done pointer, this guarentees that we will
 276          * send out all frames in the correct order.
 277          */
 278         if (index_done < index) {
 279                 for (i = index_done; i < index; i++)
 280                         rt2x00usb_kick_tx_entry(&queue->entries[i]);
 281         } else {
 282                 for (i = index_done; i < queue->limit; i++)
 283                         rt2x00usb_kick_tx_entry(&queue->entries[i]);
 284
 285                 for (i = 0; i < index; i++)
 286                         rt2x00usb_kick_tx_entry(&queue->entries[i]);
 287         }
 288 }
 289 EXPORT_SYMBOL_GPL(rt2x00usb_kick_tx_queue);
 290
 291 void rt2x00usb_kill_tx_queue(struct rt2x00_dev *rt2x00dev,
 292                              const enum data_queue_qid qid)
 293 {
 294         struct data_queue *queue = rt2x00queue_get_queue(rt2x00dev, qid);
 295         struct queue_entry_priv_usb *entry_priv;
 296         struct queue_entry_priv_usb_bcn *bcn_priv;
 297         unsigned int i;
 298         bool kill_guard;
 299
 300         /*
 301          * When killing the beacon queue, we must also kill
 302          * the beacon guard byte.
 303          */
 304         kill_guard =
 305             (qid == QID_BEACON) &&
 306             (test_bit(DRIVER_REQUIRE_BEACON_GUARD, &rt2x00dev->flags));
 307
 308         /*
 309          * Cancel all entries.
 310          */
 311         for (i = 0; i < queue->limit; i++) {
 312                 entry_priv = queue->entries[i].priv_data;
 313                 usb_kill_urb(entry_priv->urb);
 314
 315                 /*
 316                  * Kill guardian urb (if required by driver).
 317                  */
 318                 if (kill_guard) {
 319                         bcn_priv = queue->entries[i].priv_data;
 320                         usb_kill_urb(bcn_priv->guardian_urb);
 321                 }
 322         }
 323 }
 324 EXPORT_SYMBOL_GPL(rt2x00usb_kill_tx_queue);
 325
 326 /*
 327  * RX data handlers.
 328  */
 329 static void rt2x00usb_interrupt_rxdone(struct urb *urb)
 330 {
 331         struct queue_entry *entry = (struct queue_entry *)urb->context;
 332         struct rt2x00_dev *rt2x00dev = entry->queue->rt2x00dev;
 333         struct skb_frame_desc *skbdesc = get_skb_frame_desc(entry->skb);
 334         u8 rxd[32];
 335
 336         if (!test_bit(DEVICE_STATE_ENABLED_RADIO, &rt2x00dev->flags) ||
 337             !test_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags))
 338                 return;
 339
 340         /*
 341          * Check if the received data is simply too small
 342          * to be actually valid, or if the urb is signaling
 343          * a problem.
 344          */
 345         if (urb->actual_length < entry->queue->desc_size || urb->status) {
 346                 set_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags);
 347                 usb_submit_urb(urb, GFP_ATOMIC);
 348                 return;
 349         }
 350
 351         /*
 352          * Fill in desc fields of the skb descriptor
 353          */
 354         skbdesc->desc = rxd;
 355         skbdesc->desc_len = entry->queue->desc_size;
 356
 357         /*
 358          * Send the frame to rt2x00lib for further processing.
 359          */
 360         rt2x00lib_rxdone(rt2x00dev, entry);
 361 }
 362
 363 /*
 364  * Radio handlers
 365  */
 366 void rt2x00usb_disable_radio(struct rt2x00_dev *rt2x00dev)
 367 {
 368         rt2x00usb_vendor_request_sw(rt2x00dev, USB_RX_CONTROL, 0, 0,
 369                                     REGISTER_TIMEOUT);
 370
 371         /*
 372          * The USB version of kill_tx_queue also works
 373          * on the RX queue.
 374          */
 375         rt2x00dev->ops->lib->kill_tx_queue(rt2x00dev, QID_RX);
 376 }
 377 EXPORT_SYMBOL_GPL(rt2x00usb_disable_radio);
 378
 379 /*
 380  * Device initialization handlers.
 381  */
 382 void rt2x00usb_clear_entry(struct queue_entry *entry)
 383 {
 384         struct usb_device *usb_dev =
 385             to_usb_device_intf(entry->queue->rt2x00dev->dev);
 386         struct queue_entry_priv_usb *entry_priv = entry->priv_data;
 387         int pipe;
 388
 389         if (entry->queue->qid == QID_RX) {
 390                 pipe = usb_rcvbulkpipe(usb_dev, entry->queue->usb_endpoint);
 391                 usb_fill_bulk_urb(entry_priv->urb, usb_dev, pipe,
 392                                 entry->skb->data, entry->skb->len,
 393                                 rt2x00usb_interrupt_rxdone, entry);
 394
 395                 set_bit(ENTRY_OWNER_DEVICE_DATA, &entry->flags);
 396                 usb_submit_urb(entry_priv->urb, GFP_ATOMIC);
 397         } else {
 398                 entry->flags = 0;
 399         }
 400 }
 401 EXPORT_SYMBOL_GPL(rt2x00usb_clear_entry);
 402
 403 static void rt2x00usb_assign_endpoint(struct data_queue *queue,
 404                                       struct usb_endpoint_descriptor *ep_desc)
 405 {
 406         struct usb_device *usb_dev = to_usb_device_intf(queue->rt2x00dev->dev);
 407         int pipe;
 408
 409         queue->usb_endpoint = usb_endpoint_num(ep_desc);
 410
 411         if (queue->qid == QID_RX) {
 412                 pipe = usb_rcvbulkpipe(usb_dev, queue->usb_endpoint);
 413                 queue->usb_maxpacket = usb_maxpacket(usb_dev, pipe, 0);
 414         } else {
 415                 pipe = usb_sndbulkpipe(usb_dev, queue->usb_endpoint);
 416                 queue->usb_maxpacket = usb_maxpacket(usb_dev, pipe, 1);
 417         }
 418
 419         if (!queue->usb_maxpacket)
 420                 queue->usb_maxpacket = 1;
 421 }
 422
 423 static int rt2x00usb_find_endpoints(struct rt2x00_dev *rt2x00dev)
 424 {
 425         struct usb_interface *intf = to_usb_interface(rt2x00dev->dev);
 426         struct usb_host_interface *intf_desc = intf->cur_altsetting;
 427         struct usb_endpoint_descriptor *ep_desc;
 428         struct data_queue *queue = rt2x00dev->tx;
 429         struct usb_endpoint_descriptor *tx_ep_desc = NULL;
 430         unsigned int i;
 431
 432         /*
 433          * Walk through all available endpoints to search for "bulk in"
 434          * and "bulk out" endpoints. When we find such endpoints collect
 435          * the information we need from the descriptor and assign it
 436          * to the queue.
 437          */
 438         for (i = 0; i < intf_desc->desc.bNumEndpoints; i++) {
 439                 ep_desc = &intf_desc->endpoint[i].desc;
 440
 441                 if (usb_endpoint_is_bulk_in(ep_desc)) {
 442                         rt2x00usb_assign_endpoint(rt2x00dev->rx, ep_desc);
 443                 } else if (usb_endpoint_is_bulk_out(ep_desc) &&
 444                            (queue != queue_end(rt2x00dev))) {
 445                         rt2x00usb_assign_endpoint(queue, ep_desc);
 446                         queue = queue_next(queue);
 447
 448                         tx_ep_desc = ep_desc;
 449                 }
 450         }
 451
 452         /*
 453          * At least 1 endpoint for RX and 1 endpoint for TX must be available.
 454          */
 455         if (!rt2x00dev->rx->usb_endpoint || !rt2x00dev->tx->usb_endpoint) {
 456                 ERROR(rt2x00dev, "Bulk-in/Bulk-out endpoints not found\n");
 457                 return -EPIPE;
 458         }
 459
 460         /*
 461          * It might be possible not all queues have a dedicated endpoint.
 462          * Loop through all TX queues and copy the endpoint information
 463          * which we have gathered from already assigned endpoints.
 464          */
 465         txall_queue_for_each(rt2x00dev, queue) {
 466                 if (!queue->usb_endpoint)
 467                         rt2x00usb_assign_endpoint(queue, tx_ep_desc);
 468         }
 469
 470         return 0;
 471 }
 472
 473 static int rt2x00usb_alloc_urb(struct rt2x00_dev *rt2x00dev,
 474                                struct data_queue *queue)
 475 {
 476         struct queue_entry_priv_usb *entry_priv;
 477         struct queue_entry_priv_usb_bcn *bcn_priv;
 478         unsigned int i;
 479
 480         for (i = 0; i < queue->limit; i++) {
 481                 entry_priv = queue->entries[i].priv_data;
 482                 entry_priv->urb = usb_alloc_urb(0, GFP_KERNEL);
 483                 if (!entry_priv->urb)
 484                         return -ENOMEM;
 485         }
 486
 487         /*
 488          * If this is not the beacon queue or
 489          * no guardian byte was required for the beacon,
 490          * then we are done.
 491          */
 492         if (rt2x00dev->bcn != queue ||
 493             !test_bit(DRIVER_REQUIRE_BEACON_GUARD, &rt2x00dev->flags))
 494                 return 0;
 495
 496         for (i = 0; i < queue->limit; i++) {
 497                 bcn_priv = queue->entries[i].priv_data;
 498                 bcn_priv->guardian_urb = usb_alloc_urb(0, GFP_KERNEL);
 499                 if (!bcn_priv->guardian_urb)
 500                         return -ENOMEM;
 501         }
 502
 503         return 0;
 504 }
 505
 506 static void rt2x00usb_free_urb(struct rt2x00_dev *rt2x00dev,
 507                                struct data_queue *queue)
 508 {
 509         struct queue_entry_priv_usb *entry_priv;
 510         struct queue_entry_priv_usb_bcn *bcn_priv;
 511         unsigned int i;
 512
 513         if (!queue->entries)
 514                 return;
 515
 516         for (i = 0; i < queue->limit; i++) {
 517                 entry_priv = queue->entries[i].priv_data;
 518                 usb_kill_urb(entry_priv->urb);
 519                 usb_free_urb(entry_priv->urb);
 520         }
 521
 522         /*
 523          * If this is not the beacon queue or
 524          * no guardian byte was required for the beacon,
 525          * then we are done.
 526          */
 527         if (rt2x00dev->bcn != queue ||
 528             !test_bit(DRIVER_REQUIRE_BEACON_GUARD, &rt2x00dev->flags))
 529                 return;
 530
 531         for (i = 0; i < queue->limit; i++) {
 532                 bcn_priv = queue->entries[i].priv_data;
 533                 usb_kill_urb(bcn_priv->guardian_urb);
 534                 usb_free_urb(bcn_priv->guardian_urb);
 535         }
 536 }
 537
 538 int rt2x00usb_initialize(struct rt2x00_dev *rt2x00dev)
 539 {
 540         struct data_queue *queue;
 541         int status;
 542
 543         /*
 544          * Find endpoints for each queue
 545          */
 546         status = rt2x00usb_find_endpoints(rt2x00dev);
 547         if (status)
 548                 goto exit;
 549
 550         /*
 551          * Allocate DMA
 552          */
 553         queue_for_each(rt2x00dev, queue) {
 554                 status = rt2x00usb_alloc_urb(rt2x00dev, queue);
 555                 if (status)
 556                         goto exit;
 557         }
 558
 559         return 0;
 560
 561 exit:
 562         rt2x00usb_uninitialize(rt2x00dev);
 563
 564         return status;
 565 }
 566 EXPORT_SYMBOL_GPL(rt2x00usb_initialize);
 567
 568 void rt2x00usb_uninitialize(struct rt2x00_dev *rt2x00dev)
 569 {
 570         struct data_queue *queue;
 571
 572         queue_for_each(rt2x00dev, queue)
 573                 rt2x00usb_free_urb(rt2x00dev, queue);
 574 }
 575 EXPORT_SYMBOL_GPL(rt2x00usb_uninitialize);
 576
 577 /*
 578  * USB driver handlers.
 579  */
 580 static void rt2x00usb_free_reg(struct rt2x00_dev *rt2x00dev)
 581 {
 582         kfree(rt2x00dev->rf);
 583         rt2x00dev->rf = NULL;
 584
 585         kfree(rt2x00dev->eeprom);
 586         rt2x00dev->eeprom = NULL;
 587
 588         kfree(rt2x00dev->csr.cache);
 589         rt2x00dev->csr.cache = NULL;
 590 }
 591
 592 static int rt2x00usb_alloc_reg(struct rt2x00_dev *rt2x00dev)
 593 {
 594         rt2x00dev->csr.cache = kzalloc(CSR_CACHE_SIZE, GFP_KERNEL);
 595         if (!rt2x00dev->csr.cache)
 596                 goto exit;
 597
 598         rt2x00dev->eeprom = kzalloc(rt2x00dev->ops->eeprom_size, GFP_KERNEL);
 599         if (!rt2x00dev->eeprom)
 600                 goto exit;
 601
 602         rt2x00dev->rf = kzalloc(rt2x00dev->ops->rf_size, GFP_KERNEL);
 603         if (!rt2x00dev->rf)
 604                 goto exit;
 605
 606         return 0;
 607
 608 exit:
 609         ERROR_PROBE("Failed to allocate registers.\n");
 610
 611         rt2x00usb_free_reg(rt2x00dev);
 612
 613         return -ENOMEM;
 614 }
 615
 616 int rt2x00usb_probe(struct usb_interface *usb_intf,
 617                     const struct usb_device_id *id)
 618 {
 619         struct usb_device *usb_dev = interface_to_usbdev(usb_intf);
 620         struct rt2x00_ops *ops = (struct rt2x00_ops *)id->driver_info;
 621         struct ieee80211_hw *hw;
 622         struct rt2x00_dev *rt2x00dev;
 623         int retval;
 624
 625         usb_dev = usb_get_dev(usb_dev);
 626
 627         hw = ieee80211_alloc_hw(sizeof(struct rt2x00_dev), ops->hw);
 628         if (!hw) {
 629                 ERROR_PROBE("Failed to allocate hardware.\n");
 630                 retval = -ENOMEM;
 631                 goto exit_put_device;
 632         }
 633
 634         usb_set_intfdata(usb_intf, hw);
 635
 636         rt2x00dev = hw->priv;
 637         rt2x00dev->dev = &usb_intf->dev;
 638         rt2x00dev->ops = ops;
 639         rt2x00dev->hw = hw;
 640
 641         rt2x00_set_chip_intf(rt2x00dev, RT2X00_CHIP_INTF_USB);
 642
 643         retval = rt2x00usb_alloc_reg(rt2x00dev);
 644         if (retval)
 645                 goto exit_free_device;
 646
 647         retval = rt2x00lib_probe_dev(rt2x00dev);
 648         if (retval)
 649                 goto exit_free_reg;
 650
 651         return 0;
 652
 653 exit_free_reg:
 654         rt2x00usb_free_reg(rt2x00dev);
 655
 656 exit_free_device:
 657         ieee80211_free_hw(hw);
 658
 659 exit_put_device:
 660         usb_put_dev(usb_dev);
 661
 662         usb_set_intfdata(usb_intf, NULL);
 663
 664         return retval;
 665 }
 666 EXPORT_SYMBOL_GPL(rt2x00usb_probe);
 667
 668 void rt2x00usb_disconnect(struct usb_interface *usb_intf)
 669 {
 670         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 671         struct rt2x00_dev *rt2x00dev = hw->priv;
 672
 673         /*
 674          * Free all allocated data.
 675          */
 676         rt2x00lib_remove_dev(rt2x00dev);
 677         rt2x00usb_free_reg(rt2x00dev);
 678         ieee80211_free_hw(hw);
 679
 680         /*
 681          * Free the USB device data.
 682          */
 683         usb_set_intfdata(usb_intf, NULL);
 684         usb_put_dev(interface_to_usbdev(usb_intf));
 685 }
 686 EXPORT_SYMBOL_GPL(rt2x00usb_disconnect);
 687
 688 #ifdef CONFIG_PM
 689 int rt2x00usb_suspend(struct usb_interface *usb_intf, pm_message_t state)
 690 {
 691         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 692         struct rt2x00_dev *rt2x00dev = hw->priv;
 693         int retval;
 694
 695         retval = rt2x00lib_suspend(rt2x00dev, state);
 696         if (retval)
 697                 return retval;
 698
 699         /*
 700          * Decrease usbdev refcount.
 701          */
 702         usb_put_dev(interface_to_usbdev(usb_intf));
 703
 704         return 0;
 705 }
 706 EXPORT_SYMBOL_GPL(rt2x00usb_suspend);
 707
 708 int rt2x00usb_resume(struct usb_interface *usb_intf)
 709 {
 710         struct ieee80211_hw *hw = usb_get_intfdata(usb_intf);
 711         struct rt2x00_dev *rt2x00dev = hw->priv;
 712
 713         usb_get_dev(interface_to_usbdev(usb_intf));
 714
 715         return rt2x00lib_resume(rt2x00dev);
 716 }
 717 EXPORT_SYMBOL_GPL(rt2x00usb_resume);
 718 #endif /* CONFIG_PM */
 719
 720 /*
 721  * rt2x00usb module information.
 722  */
 723 MODULE_AUTHOR(DRV_PROJECT);
 724 MODULE_VERSION(DRV_VERSION);
 725 MODULE_DESCRIPTION("rt2x00 usb library");
 726 MODULE_LICENSE("GPL");