1 /******************************************************************************
4 * Copyright(c) 2007 - 2010 Realtek Corporation. All rights reserved.
5 * Linux device driver for RTL8192SU
7 * This program is free software; you can redistribute it and/or modify it
8 * under the terms of version 2 of the GNU General Public License as
9 * published by the Free Software Foundation.
11 * This program is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
16 * You should have received a copy of the GNU General Public License along with
17 * this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
20 * Modifications for inclusion into the Linux staging tree are
21 * Copyright(c) 2010 Larry Finger. All rights reserved.
23 * Contact information:
27 ******************************************************************************/
31 #include <linux/usb.h>
32 #include <linux/module.h>
33 #include <linux/firmware.h>
35 #include "osdep_service.h"
36 #include "drv_types.h"
37 #include "recv_osdep.h"
38 #include "xmit_osdep.h"
39 #include "rtl8712_efuse.h"
41 #include "usb_osintf.h"
43 static struct usb_interface *pintf;
45 static int r871xu_drv_init(struct usb_interface *pusb_intf,
46 const struct usb_device_id *pdid);
48 static void r871xu_dev_remove(struct usb_interface *pusb_intf);
50 static struct usb_device_id rtl871x_usb_id_tbl[] = {
54 {USB_DEVICE(0x0BDA, 0x8171)},
55 {USB_DEVICE(0x0bda, 0x8173)},
56 {USB_DEVICE(0x0bda, 0x8712)},
57 {USB_DEVICE(0x0bda, 0x8713)},
58 {USB_DEVICE(0x0bda, 0xC512)},
60 {USB_DEVICE(0x07B8, 0x8188)},
62 {USB_DEVICE(0x0B05, 0x1786)},
63 {USB_DEVICE(0x0B05, 0x1791)}, /* 11n mode disable */
65 {USB_DEVICE(0x050D, 0x945A)},
66 /* ISY IWL - Belkin clone */
67 {USB_DEVICE(0x050D, 0x11F1)},
69 {USB_DEVICE(0x07AA, 0x0047)},
71 {USB_DEVICE(0x2001, 0x3306)},
72 {USB_DEVICE(0x07D1, 0x3306)}, /* 11n mode disable */
74 {USB_DEVICE(0x7392, 0x7611)},
76 {USB_DEVICE(0x1740, 0x9603)},
78 {USB_DEVICE(0x0E66, 0x0016)},
80 {USB_DEVICE(0x06F8, 0xE034)},
81 {USB_DEVICE(0x06F8, 0xE032)},
83 {USB_DEVICE(0x0789, 0x0167)},
85 {USB_DEVICE(0x2019, 0xAB28)},
86 {USB_DEVICE(0x2019, 0xED16)},
88 {USB_DEVICE(0x0DF6, 0x0057)},
89 {USB_DEVICE(0x0DF6, 0x0045)},
90 {USB_DEVICE(0x0DF6, 0x0059)}, /* 11n mode disable */
91 {USB_DEVICE(0x0DF6, 0x004B)},
92 {USB_DEVICE(0x0DF6, 0x005B)},
93 {USB_DEVICE(0x0DF6, 0x005D)},
94 {USB_DEVICE(0x0DF6, 0x0063)},
96 {USB_DEVICE(0x177F, 0x0154)},
98 {USB_DEVICE(0x0BDA, 0x5077)},
100 {USB_DEVICE(0x1690, 0x0752)},
102 {USB_DEVICE(0x20F4, 0x646B)},
103 {USB_DEVICE(0x083A, 0xC512)},
104 {USB_DEVICE(0x25D4, 0x4CA1)},
105 {USB_DEVICE(0x25D4, 0x4CAB)},
109 {USB_DEVICE(0x0BDA, 0x8172)},
110 {USB_DEVICE(0x0BDA, 0x8192)},
112 {USB_DEVICE(0x0EB0, 0x9061)},
114 {USB_DEVICE(0x13D3, 0x3323)},
115 {USB_DEVICE(0x13D3, 0x3311)}, /* 11n mode disable */
116 {USB_DEVICE(0x13D3, 0x3342)},
118 {USB_DEVICE(0x13D3, 0x3333)},
119 {USB_DEVICE(0x13D3, 0x3334)},
120 {USB_DEVICE(0x13D3, 0x3335)}, /* 11n mode disable */
121 {USB_DEVICE(0x13D3, 0x3336)}, /* 11n mode disable */
123 {USB_DEVICE(0x13D3, 0x3309)},
125 {USB_DEVICE(0x050D, 0x815F)},
127 {USB_DEVICE(0x07D1, 0x3302)},
128 {USB_DEVICE(0x07D1, 0x3300)},
129 {USB_DEVICE(0x07D1, 0x3303)},
131 {USB_DEVICE(0x7392, 0x7612)},
133 {USB_DEVICE(0x1740, 0x9605)},
135 {USB_DEVICE(0x06F8, 0xE031)},
137 {USB_DEVICE(0x0E66, 0x0015)},
139 {USB_DEVICE(0x13D3, 0x3306)},
141 {USB_DEVICE(0x2019, 0xED18)},
142 {USB_DEVICE(0x2019, 0x4901)},
144 {USB_DEVICE(0x0DF6, 0x0058)},
145 {USB_DEVICE(0x0DF6, 0x0049)},
146 {USB_DEVICE(0x0DF6, 0x004C)},
147 {USB_DEVICE(0x0DF6, 0x006C)},
148 {USB_DEVICE(0x0DF6, 0x0064)},
150 {USB_DEVICE(0x14b2, 0x3300)},
151 {USB_DEVICE(0x14b2, 0x3301)},
152 {USB_DEVICE(0x14B2, 0x3302)},
154 {USB_DEVICE(0x04F2, 0xAFF2)},
155 {USB_DEVICE(0x04F2, 0xAFF5)},
156 {USB_DEVICE(0x04F2, 0xAFF6)},
157 {USB_DEVICE(0x13D3, 0x3339)},
158 {USB_DEVICE(0x13D3, 0x3340)}, /* 11n mode disable */
159 {USB_DEVICE(0x13D3, 0x3341)}, /* 11n mode disable */
160 {USB_DEVICE(0x13D3, 0x3310)},
161 {USB_DEVICE(0x13D3, 0x3325)},
165 {USB_DEVICE(0x0BDA, 0x8174)},
167 {USB_DEVICE(0x050D, 0x845A)},
169 {USB_DEVICE(0x07AA, 0x0051)},
171 {USB_DEVICE(0x7392, 0x7622)},
173 {USB_DEVICE(0x0409, 0x02B6)},
177 MODULE_DEVICE_TABLE(usb, rtl871x_usb_id_tbl);
179 static struct specific_device_id specific_device_id_tbl[] = {
180 {.idVendor = 0x0b05, .idProduct = 0x1791,
181 .flags = SPEC_DEV_ID_DISABLE_HT},
182 {.idVendor = 0x0df6, .idProduct = 0x0059,
183 .flags = SPEC_DEV_ID_DISABLE_HT},
184 {.idVendor = 0x13d3, .idProduct = 0x3306,
185 .flags = SPEC_DEV_ID_DISABLE_HT},
186 {.idVendor = 0x13D3, .idProduct = 0x3311,
187 .flags = SPEC_DEV_ID_DISABLE_HT},
188 {.idVendor = 0x13d3, .idProduct = 0x3335,
189 .flags = SPEC_DEV_ID_DISABLE_HT},
190 {.idVendor = 0x13d3, .idProduct = 0x3336,
191 .flags = SPEC_DEV_ID_DISABLE_HT},
192 {.idVendor = 0x13d3, .idProduct = 0x3340,
193 .flags = SPEC_DEV_ID_DISABLE_HT},
194 {.idVendor = 0x13d3, .idProduct = 0x3341,
195 .flags = SPEC_DEV_ID_DISABLE_HT},
200 struct usb_driver r871xu_drv;
205 static int r871x_suspend(struct usb_interface *pusb_intf, pm_message_t state)
207 struct net_device *pnetdev = usb_get_intfdata(pusb_intf);
208 struct _adapter *padapter = netdev_priv(pnetdev);
210 netdev_info(pnetdev, "Suspending...\n");
211 if (!pnetdev || !netif_running(pnetdev)) {
212 netdev_info(pnetdev, "Unable to suspend\n");
215 padapter->bSuspended = true;
216 rtl871x_intf_stop(padapter);
217 if (pnetdev->netdev_ops->ndo_stop)
218 pnetdev->netdev_ops->ndo_stop(pnetdev);
220 netif_device_detach(pnetdev);
224 static void rtl871x_intf_resume(struct _adapter *padapter)
226 if (padapter->dvobjpriv.inirp_init)
227 padapter->dvobjpriv.inirp_init(padapter);
230 static int r871x_resume(struct usb_interface *pusb_intf)
232 struct net_device *pnetdev = usb_get_intfdata(pusb_intf);
233 struct _adapter *padapter = netdev_priv(pnetdev);
235 netdev_info(pnetdev, "Resuming...\n");
236 if (!pnetdev || !netif_running(pnetdev)) {
237 netdev_info(pnetdev, "Unable to resume\n");
240 netif_device_attach(pnetdev);
241 if (pnetdev->netdev_ops->ndo_open)
242 pnetdev->netdev_ops->ndo_open(pnetdev);
243 padapter->bSuspended = false;
244 rtl871x_intf_resume(padapter);
248 static int r871x_reset_resume(struct usb_interface *pusb_intf)
256 static struct drv_priv drvpriv = {
257 .r871xu_drv.name = "r8712u",
258 .r871xu_drv.id_table = rtl871x_usb_id_tbl,
259 .r871xu_drv.probe = r871xu_drv_init,
260 .r871xu_drv.disconnect = r871xu_dev_remove,
262 .r871xu_drv.suspend = r871x_suspend,
263 .r871xu_drv.resume = r871x_resume,
264 .r871xu_drv.reset_resume = r871x_reset_resume,
268 static uint r8712_usb_dvobj_init(struct _adapter *padapter)
270 uint status = _SUCCESS;
271 struct usb_host_interface *phost_iface;
272 struct usb_interface_descriptor *piface_desc;
273 struct dvobj_priv *pdvobjpriv = &padapter->dvobjpriv;
274 struct usb_device *pusbd = pdvobjpriv->pusbdev;
276 pdvobjpriv->padapter = padapter;
277 padapter->EepromAddressSize = 6;
278 phost_iface = &pintf->altsetting[0];
279 piface_desc = &phost_iface->desc;
280 pdvobjpriv->nr_endpoint = piface_desc->bNumEndpoints;
281 if (pusbd->speed == USB_SPEED_HIGH) {
282 pdvobjpriv->ishighspeed = true;
283 dev_info(&pusbd->dev, "r8712u: USB_SPEED_HIGH with %d endpoints\n",
284 pdvobjpriv->nr_endpoint);
286 pdvobjpriv->ishighspeed = false;
287 dev_info(&pusbd->dev, "r8712u: USB_SPEED_LOW with %d endpoints\n",
288 pdvobjpriv->nr_endpoint);
290 if ((r8712_alloc_io_queue(padapter)) == _FAIL)
295 static void r8712_usb_dvobj_deinit(struct _adapter *padapter)
299 void rtl871x_intf_stop(struct _adapter *padapter)
301 /*disable_hw_interrupt*/
302 if (!padapter->bSurpriseRemoved) {
303 /*device still exists, so driver can do i/o operation
309 if (padapter->dvobjpriv.inirp_deinit)
310 padapter->dvobjpriv.inirp_deinit(padapter);
312 r8712_usb_write_port_cancel(padapter);
313 /* TODO:cancel other irps */
316 void r871x_dev_unload(struct _adapter *padapter)
320 padapter->bDriverStopped = true;
323 rtl871x_intf_stop(padapter);
326 r8712_stop_drv_threads(padapter);
329 if (!padapter->bSurpriseRemoved) {
330 padapter->hw_init_completed = false;
331 rtl8712_hal_deinit(padapter);
335 if (padapter->dvobj_deinit)
336 padapter->dvobj_deinit(padapter);
337 padapter->bup = false;
341 static void disable_ht_for_spec_devid(const struct usb_device_id *pdid,
342 struct _adapter *padapter)
347 int num = ARRAY_SIZE(specific_device_id_tbl);
349 for (i = 0; i < num; i++) {
350 vid = specific_device_id_tbl[i].idVendor;
351 pid = specific_device_id_tbl[i].idProduct;
352 flags = specific_device_id_tbl[i].flags;
354 if ((pdid->idVendor == vid) && (pdid->idProduct == pid) &&
355 (flags & SPEC_DEV_ID_DISABLE_HT)) {
356 padapter->registrypriv.ht_enable = 0;
357 padapter->registrypriv.cbw40_enable = 0;
358 padapter->registrypriv.ampdu_enable = 0;
363 static const struct device_type wlan_type = {
368 * drv_init() - a device potentially for us
370 * notes: drv_init() is called when the bus driver has located a card for us
371 * to support. We accept the new device by returning 0.
373 static int r871xu_drv_init(struct usb_interface *pusb_intf,
374 const struct usb_device_id *pdid)
377 struct _adapter *padapter = NULL;
378 struct dvobj_priv *pdvobjpriv;
379 struct net_device *pnetdev;
380 struct usb_device *udev;
382 /* In this probe function, O.S. will provide the usb interface pointer
383 * to driver. We have to increase the reference count of the usb device
384 * structure by using the usb_get_dev function.
386 udev = interface_to_usbdev(pusb_intf);
390 pnetdev = r8712_init_netdev();
393 padapter = netdev_priv(pnetdev);
394 disable_ht_for_spec_devid(pdid, padapter);
395 pdvobjpriv = &padapter->dvobjpriv;
396 pdvobjpriv->padapter = padapter;
397 padapter->dvobjpriv.pusbdev = udev;
398 padapter->pusb_intf = pusb_intf;
399 usb_set_intfdata(pusb_intf, pnetdev);
400 SET_NETDEV_DEV(pnetdev, &pusb_intf->dev);
401 pnetdev->dev.type = &wlan_type;
403 padapter->dvobj_init = r8712_usb_dvobj_init;
404 padapter->dvobj_deinit = r8712_usb_dvobj_deinit;
405 padapter->halpriv.hal_bus_init = r8712_usb_hal_bus_init;
406 padapter->dvobjpriv.inirp_init = r8712_usb_inirp_init;
407 padapter->dvobjpriv.inirp_deinit = r8712_usb_inirp_deinit;
409 * initialize the dvobj_priv
411 if (!padapter->dvobj_init) {
414 status = padapter->dvobj_init(padapter);
415 if (status != _SUCCESS)
419 status = r8712_init_drv_sw(padapter);
422 /* step 5. read efuse/eeprom data and get mac_addr */
426 u8 tmpU1b, AutoloadFail, eeprom_CustomerID;
427 u8 *pdata = padapter->eeprompriv.efuse_eeprom_data;
429 tmpU1b = r8712_read8(padapter, EE_9346CR);/*CR9346*/
431 /* To check system boot selection.*/
432 dev_info(&udev->dev, "r8712u: Boot from %s: Autoload %s\n",
433 (tmpU1b & _9356SEL) ? "EEPROM" : "EFUSE",
434 (tmpU1b & _EEPROM_EN) ? "OK" : "Failed");
436 /* To check autoload success or not.*/
437 if (tmpU1b & _EEPROM_EN) {
439 /* The following operations prevent Efuse leakage by
442 tmpU1b = r8712_read8(padapter, EFUSE_TEST + 3);
443 r8712_write8(padapter, EFUSE_TEST + 3, tmpU1b | 0x80);
445 r8712_write8(padapter, EFUSE_TEST + 3,
446 (tmpU1b & (~BIT(7))));
448 /* Retrieve Chip version.
449 * Recognize IC version by Reg0x4 BIT15.
451 tmpU1b = (u8)((r8712_read32(padapter, PMC_FSM) >> 15) &
454 padapter->registrypriv.chip_version =
457 padapter->registrypriv.chip_version =
459 switch (padapter->registrypriv.chip_version) {
465 padapter->registrypriv.chip_version =
470 for (i = 0, offset = 0; i < 128; i += 8, offset++)
471 r8712_efuse_pg_packet_read(padapter, offset,
474 if (!r8712_initmac || !mac_pton(r8712_initmac, mac)) {
475 /* Use the mac address stored in the Efuse
476 * offset = 0x12 for usb in efuse
478 ether_addr_copy(mac, &pdata[0x12]);
480 eeprom_CustomerID = pdata[0x52];
481 switch (eeprom_CustomerID) {
482 case EEPROM_CID_ALPHA:
483 padapter->eeprompriv.CustomerID =
486 case EEPROM_CID_CAMEO:
487 padapter->eeprompriv.CustomerID =
490 case EEPROM_CID_SITECOM:
491 padapter->eeprompriv.CustomerID =
494 case EEPROM_CID_COREGA:
495 padapter->eeprompriv.CustomerID =
498 case EEPROM_CID_Senao:
499 padapter->eeprompriv.CustomerID =
502 case EEPROM_CID_EDIMAX_BELKIN:
503 padapter->eeprompriv.CustomerID =
504 RT_CID_819x_Edimax_Belkin;
506 case EEPROM_CID_SERCOMM_BELKIN:
507 padapter->eeprompriv.CustomerID =
508 RT_CID_819x_Sercomm_Belkin;
510 case EEPROM_CID_WNC_COREGA:
511 padapter->eeprompriv.CustomerID =
512 RT_CID_819x_WNC_COREGA;
514 case EEPROM_CID_WHQL:
516 case EEPROM_CID_NetCore:
517 padapter->eeprompriv.CustomerID =
520 case EEPROM_CID_CAMEO1:
521 padapter->eeprompriv.CustomerID =
524 case EEPROM_CID_CLEVO:
525 padapter->eeprompriv.CustomerID =
529 padapter->eeprompriv.CustomerID =
533 dev_info(&udev->dev, "r8712u: CustomerID = 0x%.4x\n",
534 padapter->eeprompriv.CustomerID);
536 switch (padapter->eeprompriv.CustomerID) {
538 case RT_CID_819x_ALPHA:
539 case RT_CID_819x_CAMEO:
540 padapter->ledpriv.LedStrategy = SW_LED_MODE1;
541 padapter->ledpriv.bRegUseLed = true;
543 case RT_CID_819x_Sitecom:
544 padapter->ledpriv.LedStrategy = SW_LED_MODE2;
545 padapter->ledpriv.bRegUseLed = true;
548 case RT_CID_819x_Senao:
549 padapter->ledpriv.LedStrategy = SW_LED_MODE3;
550 padapter->ledpriv.bRegUseLed = true;
552 case RT_CID_819x_Edimax_Belkin:
553 padapter->ledpriv.LedStrategy = SW_LED_MODE4;
554 padapter->ledpriv.bRegUseLed = true;
556 case RT_CID_819x_Sercomm_Belkin:
557 padapter->ledpriv.LedStrategy = SW_LED_MODE5;
558 padapter->ledpriv.bRegUseLed = true;
560 case RT_CID_819x_WNC_COREGA:
561 padapter->ledpriv.LedStrategy = SW_LED_MODE6;
562 padapter->ledpriv.bRegUseLed = true;
565 padapter->ledpriv.LedStrategy = SW_LED_MODE0;
566 padapter->ledpriv.bRegUseLed = false;
570 AutoloadFail = false;
572 if (((mac[0] == 0xff) && (mac[1] == 0xff) &&
573 (mac[2] == 0xff) && (mac[3] == 0xff) &&
574 (mac[4] == 0xff) && (mac[5] == 0xff)) ||
575 ((mac[0] == 0x00) && (mac[1] == 0x00) &&
576 (mac[2] == 0x00) && (mac[3] == 0x00) &&
577 (mac[4] == 0x00) && (mac[5] == 0x00)) ||
587 /* Make sure the user did not select a multicast
588 * address by setting bit 1 of first octet.
592 "r8712u: MAC Address from user = %pM\n", mac);
595 "r8712u: MAC Address from efuse = %pM\n", mac);
596 ether_addr_copy(pnetdev->dev_addr, mac);
598 /* step 6. Load the firmware asynchronously */
599 if (rtl871x_load_fw(padapter))
601 spin_lock_init(&padapter->lockRxFF0Filter);
602 mutex_init(&padapter->mutex_start);
606 usb_set_intfdata(pusb_intf, NULL);
607 if (padapter && padapter->dvobj_deinit != NULL)
608 padapter->dvobj_deinit(padapter);
610 free_netdev(pnetdev);
614 /* rmmod module & unplug(SurpriseRemoved) will call r871xu_dev_remove()
615 * => how to recognize both
617 static void r871xu_dev_remove(struct usb_interface *pusb_intf)
619 struct net_device *pnetdev = usb_get_intfdata(pusb_intf);
620 struct usb_device *udev = interface_to_usbdev(pusb_intf);
623 struct _adapter *padapter = netdev_priv(pnetdev);
625 usb_set_intfdata(pusb_intf, NULL);
626 release_firmware(padapter->fw);
627 /* never exit with a firmware callback pending */
628 wait_for_completion(&padapter->rtl8712_fw_ready);
629 if (drvpriv.drv_registered)
630 padapter->bSurpriseRemoved = true;
631 unregister_netdev(pnetdev); /* will call netdev_close() */
632 flush_scheduled_work();
634 /* Stop driver mlme relation timer */
635 r8712_stop_drv_timers(padapter);
636 r871x_dev_unload(padapter);
637 r8712_free_drv_sw(padapter);
639 /* decrease the reference count of the usb device structure
644 /* If we didn't unplug usb dongle and remove/insert module, driver
645 * fails on sitesurvey for the first time when device is up.
646 * Reset usb port for sitesurvey fail issue.
648 if (udev->state != USB_STATE_NOTATTACHED)
649 usb_reset_device(udev);
652 static int __init r8712u_drv_entry(void)
654 drvpriv.drv_registered = true;
655 return usb_register(&drvpriv.r871xu_drv);
658 static void __exit r8712u_drv_halt(void)
660 drvpriv.drv_registered = false;
661 usb_deregister(&drvpriv.r871xu_drv);
664 module_init(r8712u_drv_entry);
665 module_exit(r8712u_drv_halt);