2 * Marvell Wireless LAN device driver: major functions
4 * Copyright (C) 2011, Marvell International Ltd.
6 * This software file (the "File") is distributed by Marvell International
7 * Ltd. under the terms of the GNU General Public License Version 2, June 1991
8 * (the "License"). You may use, redistribute and/or modify this File in
9 * accordance with the terms and conditions of the License, a copy of which
10 * is available by writing to the Free Software Foundation, Inc.,
11 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or on the
12 * worldwide web at http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt.
14 * THE FILE IS DISTRIBUTED AS-IS, WITHOUT WARRANTY OF ANY KIND, AND THE
15 * IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE
16 * ARE EXPRESSLY DISCLAIMED. The License provides additional details about
17 * this warranty disclaimer.
27 const char driver_version[] = "mwifiex " VERSION " (%s) ";
30 * This function registers the device and performs all the necessary
33 * The following initialization operations are performed -
34 * - Allocate adapter structure
35 * - Save interface specific operations table in adapter
36 * - Call interface specific initialization routine
37 * - Allocate private structures
38 * - Set default adapter structure parameters
41 * In case of any errors during inittialization, this function also ensures
42 * proper cleanup before exiting.
44 static int mwifiex_register(void *card, struct mwifiex_if_ops *if_ops,
47 struct mwifiex_adapter *adapter;
50 adapter = kzalloc(sizeof(struct mwifiex_adapter), GFP_KERNEL);
57 /* Save interface specific operations in adapter */
58 memmove(&adapter->if_ops, if_ops, sizeof(struct mwifiex_if_ops));
60 /* card specific initialization has been deferred until now .. */
61 if (adapter->if_ops.init_if)
62 if (adapter->if_ops.init_if(adapter))
65 adapter->priv_num = 0;
67 for (i = 0; i < MWIFIEX_MAX_BSS_NUM; i++) {
68 /* Allocate memory for private structure */
70 kzalloc(sizeof(struct mwifiex_private), GFP_KERNEL);
71 if (!adapter->priv[i])
74 adapter->priv[i]->adapter = adapter;
77 mwifiex_init_lock_list(adapter);
79 init_timer(&adapter->cmd_timer);
80 adapter->cmd_timer.function = mwifiex_cmd_timeout_func;
81 adapter->cmd_timer.data = (unsigned long) adapter;
86 dev_dbg(adapter->dev, "info: leave mwifiex_register with error\n");
88 for (i = 0; i < adapter->priv_num; i++)
89 kfree(adapter->priv[i]);
97 * This function unregisters the device and performs all the necessary
100 * The following cleanup operations are performed -
102 * - Free beacon buffers
103 * - Free private structures
104 * - Free adapter structure
106 static int mwifiex_unregister(struct mwifiex_adapter *adapter)
110 del_timer(&adapter->cmd_timer);
112 /* Free private structures */
113 for (i = 0; i < adapter->priv_num; i++) {
114 if (adapter->priv[i]) {
115 mwifiex_free_curr_bcn(adapter->priv[i]);
116 kfree(adapter->priv[i]);
127 * This function is the main procedure of the driver and handles various driver
128 * operations. It runs in a loop and provides the core functionalities.
130 * The main responsibilities of this function are -
131 * - Ensure concurrency control
132 * - Handle pending interrupts and call interrupt handlers
133 * - Wake up the card if required
134 * - Handle command responses and call response handlers
135 * - Handle events and call event handlers
136 * - Execute pending commands
137 * - Transmit pending data packets
139 int mwifiex_main_process(struct mwifiex_adapter *adapter)
145 spin_lock_irqsave(&adapter->main_proc_lock, flags);
147 /* Check if already processing */
148 if (adapter->mwifiex_processing) {
149 spin_unlock_irqrestore(&adapter->main_proc_lock, flags);
152 adapter->mwifiex_processing = true;
153 spin_unlock_irqrestore(&adapter->main_proc_lock, flags);
157 if ((adapter->hw_status == MWIFIEX_HW_STATUS_CLOSING) ||
158 (adapter->hw_status == MWIFIEX_HW_STATUS_NOT_READY))
161 /* Handle pending interrupt if any */
162 if (adapter->int_status) {
163 if (adapter->hs_activated)
164 mwifiex_process_hs_config(adapter);
165 if (adapter->if_ops.process_int_status)
166 adapter->if_ops.process_int_status(adapter);
169 /* Need to wake up the card ? */
170 if ((adapter->ps_state == PS_STATE_SLEEP) &&
171 (adapter->pm_wakeup_card_req &&
172 !adapter->pm_wakeup_fw_try) &&
173 (is_command_pending(adapter) ||
174 !mwifiex_wmm_lists_empty(adapter))) {
175 adapter->pm_wakeup_fw_try = true;
176 adapter->if_ops.wakeup(adapter);
180 if (IS_CARD_RX_RCVD(adapter)) {
181 adapter->pm_wakeup_fw_try = false;
182 if (adapter->ps_state == PS_STATE_SLEEP)
183 adapter->ps_state = PS_STATE_AWAKE;
185 /* We have tried to wakeup the card already */
186 if (adapter->pm_wakeup_fw_try)
188 if (adapter->ps_state != PS_STATE_AWAKE ||
189 adapter->tx_lock_flag)
192 if ((adapter->scan_processing &&
193 !adapter->scan_delay_cnt) || adapter->data_sent ||
194 mwifiex_wmm_lists_empty(adapter)) {
195 if (adapter->cmd_sent || adapter->curr_cmd ||
196 (!is_command_pending(adapter)))
201 /* Check Rx data for USB */
202 if (adapter->iface_type == MWIFIEX_USB)
203 while ((skb = skb_dequeue(&adapter->usb_rx_data_q)))
204 mwifiex_handle_rx_packet(adapter, skb);
206 /* Check for Cmd Resp */
207 if (adapter->cmd_resp_received) {
208 adapter->cmd_resp_received = false;
209 mwifiex_process_cmdresp(adapter);
211 /* call mwifiex back when init_fw is done */
212 if (adapter->hw_status == MWIFIEX_HW_STATUS_INIT_DONE) {
213 adapter->hw_status = MWIFIEX_HW_STATUS_READY;
214 mwifiex_init_fw_complete(adapter);
218 /* Check for event */
219 if (adapter->event_received) {
220 adapter->event_received = false;
221 mwifiex_process_event(adapter);
224 /* Check if we need to confirm Sleep Request
225 received previously */
226 if (adapter->ps_state == PS_STATE_PRE_SLEEP) {
227 if (!adapter->cmd_sent && !adapter->curr_cmd)
228 mwifiex_check_ps_cond(adapter);
231 /* * The ps_state may have been changed during processing of
232 * Sleep Request event.
234 if ((adapter->ps_state == PS_STATE_SLEEP) ||
235 (adapter->ps_state == PS_STATE_PRE_SLEEP) ||
236 (adapter->ps_state == PS_STATE_SLEEP_CFM) ||
237 adapter->tx_lock_flag)
240 if (!adapter->cmd_sent && !adapter->curr_cmd) {
241 if (mwifiex_exec_next_cmd(adapter) == -1) {
247 if ((!adapter->scan_processing || adapter->scan_delay_cnt) &&
248 !adapter->data_sent && !mwifiex_wmm_lists_empty(adapter)) {
249 mwifiex_wmm_process_tx(adapter);
250 if (adapter->hs_activated) {
251 adapter->is_hs_configured = false;
252 mwifiex_hs_activated_event
254 (adapter, MWIFIEX_BSS_ROLE_ANY),
259 if (adapter->delay_null_pkt && !adapter->cmd_sent &&
260 !adapter->curr_cmd && !is_command_pending(adapter) &&
261 mwifiex_wmm_lists_empty(adapter)) {
262 if (!mwifiex_send_null_packet
263 (mwifiex_get_priv(adapter, MWIFIEX_BSS_ROLE_STA),
264 MWIFIEX_TxPD_POWER_MGMT_NULL_PACKET |
265 MWIFIEX_TxPD_POWER_MGMT_LAST_PACKET)) {
266 adapter->delay_null_pkt = false;
267 adapter->ps_state = PS_STATE_SLEEP;
273 if ((adapter->int_status) || IS_CARD_RX_RCVD(adapter))
276 spin_lock_irqsave(&adapter->main_proc_lock, flags);
277 adapter->mwifiex_processing = false;
278 spin_unlock_irqrestore(&adapter->main_proc_lock, flags);
281 if (adapter->hw_status == MWIFIEX_HW_STATUS_CLOSING)
282 mwifiex_shutdown_drv(adapter);
285 EXPORT_SYMBOL_GPL(mwifiex_main_process);
288 * This function frees the adapter structure.
290 * Additionally, this closes the netlink socket, frees the timers
291 * and private structures.
293 static void mwifiex_free_adapter(struct mwifiex_adapter *adapter)
296 pr_err("%s: adapter is NULL\n", __func__);
300 mwifiex_unregister(adapter);
301 pr_debug("info: %s: free adapter\n", __func__);
305 * This function gets firmware and initializes it.
307 * The main initialization steps followed are -
308 * - Download the correct firmware to card
309 * - Issue the init commands to firmware
311 static void mwifiex_fw_dpc(const struct firmware *firmware, void *context)
315 struct mwifiex_private *priv;
316 struct mwifiex_adapter *adapter = context;
317 struct mwifiex_fw_image fw;
320 dev_err(adapter->dev,
321 "Failed to get firmware %s\n", adapter->fw_name);
325 memset(&fw, 0, sizeof(struct mwifiex_fw_image));
326 adapter->firmware = firmware;
327 fw.fw_buf = (u8 *) adapter->firmware->data;
328 fw.fw_len = adapter->firmware->size;
330 if (adapter->if_ops.dnld_fw)
331 ret = adapter->if_ops.dnld_fw(adapter, &fw);
333 ret = mwifiex_dnld_fw(adapter, &fw);
337 dev_notice(adapter->dev, "WLAN FW is active\n");
339 adapter->init_wait_q_woken = false;
340 ret = mwifiex_init_fw(adapter);
344 adapter->hw_status = MWIFIEX_HW_STATUS_READY;
347 /* Wait for mwifiex_init to complete */
348 wait_event_interruptible(adapter->init_wait_q,
349 adapter->init_wait_q_woken);
350 if (adapter->hw_status != MWIFIEX_HW_STATUS_READY)
353 priv = adapter->priv[MWIFIEX_BSS_ROLE_STA];
354 if (mwifiex_register_cfg80211(adapter)) {
355 dev_err(adapter->dev, "cannot register with cfg80211\n");
360 /* Create station interface by default */
361 if (!mwifiex_add_virtual_intf(adapter->wiphy, "mlan%d",
362 NL80211_IFTYPE_STATION, NULL, NULL)) {
363 dev_err(adapter->dev, "cannot create default STA interface\n");
367 /* Create AP interface by default */
368 if (!mwifiex_add_virtual_intf(adapter->wiphy, "uap%d",
369 NL80211_IFTYPE_AP, NULL, NULL)) {
370 dev_err(adapter->dev, "cannot create default AP interface\n");
374 /* Create P2P interface by default */
375 if (!mwifiex_add_virtual_intf(adapter->wiphy, "p2p%d",
376 NL80211_IFTYPE_P2P_CLIENT, NULL, NULL)) {
377 dev_err(adapter->dev, "cannot create default P2P interface\n");
382 mwifiex_drv_get_driver_version(adapter, fmt, sizeof(fmt) - 1);
383 dev_notice(adapter->dev, "driver_version = %s\n", fmt);
387 mwifiex_del_virtual_intf(adapter->wiphy, priv->wdev);
390 pr_debug("info: %s: unregister device\n", __func__);
391 adapter->if_ops.unregister_dev(adapter);
393 release_firmware(adapter->firmware);
394 complete(&adapter->fw_load);
399 * This function initializes the hardware and gets firmware.
401 static int mwifiex_init_hw_fw(struct mwifiex_adapter *adapter)
405 init_completion(&adapter->fw_load);
406 ret = request_firmware_nowait(THIS_MODULE, 1, adapter->fw_name,
407 adapter->dev, GFP_KERNEL, adapter,
410 dev_err(adapter->dev,
411 "request_firmware_nowait() returned error %d\n", ret);
416 * CFG802.11 network device handler for open.
418 * Starts the data queue.
421 mwifiex_open(struct net_device *dev)
423 netif_tx_start_all_queues(dev);
428 * CFG802.11 network device handler for close.
431 mwifiex_close(struct net_device *dev)
433 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
435 if (priv->scan_request) {
436 dev_dbg(priv->adapter->dev, "aborting scan on ndo_stop\n");
437 cfg80211_scan_done(priv->scan_request, 1);
438 priv->scan_request = NULL;
445 * Add buffer into wmm tx queue and queue work to transmit it.
447 int mwifiex_queue_tx_pkt(struct mwifiex_private *priv, struct sk_buff *skb)
449 struct netdev_queue *txq;
450 int index = mwifiex_1d_to_wmm_queue[skb->priority];
452 if (atomic_inc_return(&priv->wmm_tx_pending[index]) >= MAX_TX_PENDING) {
453 txq = netdev_get_tx_queue(priv->netdev, index);
454 if (!netif_tx_queue_stopped(txq)) {
455 netif_tx_stop_queue(txq);
456 dev_dbg(priv->adapter->dev, "stop queue: %d\n", index);
460 atomic_inc(&priv->adapter->tx_pending);
461 mwifiex_wmm_add_buf_txqueue(priv, skb);
463 if (priv->adapter->scan_delay_cnt)
464 atomic_set(&priv->adapter->is_tx_received, true);
466 queue_work(priv->adapter->workqueue, &priv->adapter->main_work);
472 * CFG802.11 network device handler for data transmission.
475 mwifiex_hard_start_xmit(struct sk_buff *skb, struct net_device *dev)
477 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
478 struct sk_buff *new_skb;
479 struct mwifiex_txinfo *tx_info;
482 dev_dbg(priv->adapter->dev, "data: %lu BSS(%d-%d): Data <= kernel\n",
483 jiffies, priv->bss_type, priv->bss_num);
485 if (priv->adapter->surprise_removed) {
487 priv->stats.tx_dropped++;
490 if (!skb->len || (skb->len > ETH_FRAME_LEN)) {
491 dev_err(priv->adapter->dev, "Tx: bad skb len %d\n", skb->len);
493 priv->stats.tx_dropped++;
496 if (skb_headroom(skb) < MWIFIEX_MIN_DATA_HEADER_LEN) {
497 dev_dbg(priv->adapter->dev,
498 "data: Tx: insufficient skb headroom %d\n",
500 /* Insufficient skb headroom - allocate a new skb */
502 skb_realloc_headroom(skb, MWIFIEX_MIN_DATA_HEADER_LEN);
503 if (unlikely(!new_skb)) {
504 dev_err(priv->adapter->dev, "Tx: cannot alloca new_skb\n");
506 priv->stats.tx_dropped++;
511 dev_dbg(priv->adapter->dev, "info: new skb headroomd %d\n",
515 tx_info = MWIFIEX_SKB_TXCB(skb);
516 tx_info->bss_num = priv->bss_num;
517 tx_info->bss_type = priv->bss_type;
519 /* Record the current time the packet was queued; used to
520 * determine the amount of time the packet was queued in
521 * the driver before it was sent to the firmware.
522 * The delay is then sent along with the packet to the
523 * firmware for aggregate delay calculation for stats and
524 * MSDU lifetime expiry.
526 do_gettimeofday(&tv);
527 skb->tstamp = timeval_to_ktime(tv);
529 mwifiex_queue_tx_pkt(priv, skb);
535 * CFG802.11 network device handler for setting MAC address.
538 mwifiex_set_mac_address(struct net_device *dev, void *addr)
540 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
541 struct sockaddr *hw_addr = addr;
544 memcpy(priv->curr_addr, hw_addr->sa_data, ETH_ALEN);
546 /* Send request to firmware */
547 ret = mwifiex_send_cmd_sync(priv, HostCmd_CMD_802_11_MAC_ADDRESS,
548 HostCmd_ACT_GEN_SET, 0, NULL);
551 memcpy(priv->netdev->dev_addr, priv->curr_addr, ETH_ALEN);
553 dev_err(priv->adapter->dev,
554 "set mac address failed: ret=%d\n", ret);
556 memcpy(dev->dev_addr, priv->curr_addr, ETH_ALEN);
562 * CFG802.11 network device handler for setting multicast list.
564 static void mwifiex_set_multicast_list(struct net_device *dev)
566 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
567 struct mwifiex_multicast_list mcast_list;
569 if (dev->flags & IFF_PROMISC) {
570 mcast_list.mode = MWIFIEX_PROMISC_MODE;
571 } else if (dev->flags & IFF_ALLMULTI ||
572 netdev_mc_count(dev) > MWIFIEX_MAX_MULTICAST_LIST_SIZE) {
573 mcast_list.mode = MWIFIEX_ALL_MULTI_MODE;
575 mcast_list.mode = MWIFIEX_MULTICAST_MODE;
576 if (netdev_mc_count(dev))
577 mcast_list.num_multicast_addr =
578 mwifiex_copy_mcast_addr(&mcast_list, dev);
580 mwifiex_request_set_multicast_list(priv, &mcast_list);
584 * CFG802.11 network device handler for transmission timeout.
587 mwifiex_tx_timeout(struct net_device *dev)
589 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
591 priv->num_tx_timeout++;
592 priv->tx_timeout_cnt++;
593 dev_err(priv->adapter->dev,
594 "%lu : Tx timeout(#%d), bss_type-num = %d-%d\n",
595 jiffies, priv->tx_timeout_cnt, priv->bss_type, priv->bss_num);
596 mwifiex_set_trans_start(dev);
598 if (priv->tx_timeout_cnt > TX_TIMEOUT_THRESHOLD &&
599 priv->adapter->if_ops.card_reset) {
600 dev_err(priv->adapter->dev,
601 "tx_timeout_cnt exceeds threshold. Triggering card reset!\n");
602 priv->adapter->if_ops.card_reset(priv->adapter);
607 * CFG802.11 network device handler for statistics retrieval.
609 static struct net_device_stats *mwifiex_get_stats(struct net_device *dev)
611 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
617 mwifiex_netdev_select_wmm_queue(struct net_device *dev, struct sk_buff *skb)
619 skb->priority = cfg80211_classify8021d(skb);
620 return mwifiex_1d_to_wmm_queue[skb->priority];
623 /* Network device handlers */
624 static const struct net_device_ops mwifiex_netdev_ops = {
625 .ndo_open = mwifiex_open,
626 .ndo_stop = mwifiex_close,
627 .ndo_start_xmit = mwifiex_hard_start_xmit,
628 .ndo_set_mac_address = mwifiex_set_mac_address,
629 .ndo_tx_timeout = mwifiex_tx_timeout,
630 .ndo_get_stats = mwifiex_get_stats,
631 .ndo_set_rx_mode = mwifiex_set_multicast_list,
632 .ndo_select_queue = mwifiex_netdev_select_wmm_queue,
636 * This function initializes the private structure parameters.
638 * The following wait queues are initialized -
640 * - Command wait queue
641 * - Statistics wait queue
643 * ...and the following default parameters are set -
644 * - Current key index : Set to 0
645 * - Rate index : Set to auto
646 * - Media connected : Set to disconnected
647 * - Adhoc link sensed : Set to false
648 * - Nick name : Set to null
649 * - Number of Tx timeout : Set to 0
650 * - Device address : Set to current address
652 * In addition, the CFG80211 work queue is also created.
654 void mwifiex_init_priv_params(struct mwifiex_private *priv,
655 struct net_device *dev)
657 dev->netdev_ops = &mwifiex_netdev_ops;
658 dev->destructor = free_netdev;
659 /* Initialize private structure */
660 priv->current_key_index = 0;
661 priv->media_connected = false;
662 memset(&priv->nick_name, 0, sizeof(priv->nick_name));
663 memset(priv->mgmt_ie, 0,
664 sizeof(struct mwifiex_ie) * MAX_MGMT_IE_INDEX);
665 priv->beacon_idx = MWIFIEX_AUTO_IDX_MASK;
666 priv->proberesp_idx = MWIFIEX_AUTO_IDX_MASK;
667 priv->assocresp_idx = MWIFIEX_AUTO_IDX_MASK;
668 priv->rsn_idx = MWIFIEX_AUTO_IDX_MASK;
669 priv->num_tx_timeout = 0;
670 memcpy(dev->dev_addr, priv->curr_addr, ETH_ALEN);
674 * This function check if command is pending.
676 int is_command_pending(struct mwifiex_adapter *adapter)
679 int is_cmd_pend_q_empty;
681 spin_lock_irqsave(&adapter->cmd_pending_q_lock, flags);
682 is_cmd_pend_q_empty = list_empty(&adapter->cmd_pending_q);
683 spin_unlock_irqrestore(&adapter->cmd_pending_q_lock, flags);
685 return !is_cmd_pend_q_empty;
689 * This is the main work queue function.
691 * It handles the main process, which in turn handles the complete
694 static void mwifiex_main_work_queue(struct work_struct *work)
696 struct mwifiex_adapter *adapter =
697 container_of(work, struct mwifiex_adapter, main_work);
699 if (adapter->surprise_removed)
701 mwifiex_main_process(adapter);
705 * This function cancels all works in the queue and destroys
706 * the main workqueue.
709 mwifiex_terminate_workqueue(struct mwifiex_adapter *adapter)
711 flush_workqueue(adapter->workqueue);
712 destroy_workqueue(adapter->workqueue);
713 adapter->workqueue = NULL;
717 * This function adds the card.
719 * This function follows the following major steps to set up the device -
720 * - Initialize software. This includes probing the card, registering
721 * the interface operations table, and allocating/initializing the
723 * - Set up the netlink socket
724 * - Create and start the main work queue
725 * - Register the device
726 * - Initialize firmware and hardware
727 * - Add logical interfaces
730 mwifiex_add_card(void *card, struct semaphore *sem,
731 struct mwifiex_if_ops *if_ops, u8 iface_type)
733 struct mwifiex_adapter *adapter;
735 if (down_interruptible(sem))
738 if (mwifiex_register(card, if_ops, (void **)&adapter)) {
739 pr_err("%s: software init failed\n", __func__);
743 adapter->iface_type = iface_type;
745 adapter->hw_status = MWIFIEX_HW_STATUS_INITIALIZING;
746 adapter->surprise_removed = false;
747 init_waitqueue_head(&adapter->init_wait_q);
748 adapter->is_suspended = false;
749 adapter->hs_activated = false;
750 init_waitqueue_head(&adapter->hs_activate_wait_q);
751 adapter->cmd_wait_q_required = false;
752 init_waitqueue_head(&adapter->cmd_wait_q.wait);
753 adapter->cmd_wait_q.status = 0;
754 adapter->scan_wait_q_woken = false;
756 adapter->workqueue = create_workqueue("MWIFIEX_WORK_QUEUE");
757 if (!adapter->workqueue)
760 INIT_WORK(&adapter->main_work, mwifiex_main_work_queue);
762 /* Register the device. Fill up the private data structure with relevant
763 information from the card and request for the required IRQ. */
764 if (adapter->if_ops.register_dev(adapter)) {
765 pr_err("%s: failed to register mwifiex device\n", __func__);
766 goto err_registerdev;
769 if (mwifiex_init_hw_fw(adapter)) {
770 pr_err("%s: firmware init failed\n", __func__);
778 pr_debug("info: %s: unregister device\n", __func__);
779 if (adapter->if_ops.unregister_dev)
780 adapter->if_ops.unregister_dev(adapter);
782 adapter->surprise_removed = true;
783 mwifiex_terminate_workqueue(adapter);
785 if ((adapter->hw_status == MWIFIEX_HW_STATUS_FW_READY) ||
786 (adapter->hw_status == MWIFIEX_HW_STATUS_READY)) {
787 pr_debug("info: %s: shutdown mwifiex\n", __func__);
788 adapter->init_wait_q_woken = false;
790 if (mwifiex_shutdown_drv(adapter) == -EINPROGRESS)
791 wait_event_interruptible(adapter->init_wait_q,
792 adapter->init_wait_q_woken);
795 mwifiex_free_adapter(adapter);
803 EXPORT_SYMBOL_GPL(mwifiex_add_card);
806 * This function removes the card.
808 * This function follows the following major steps to remove the device -
809 * - Stop data traffic
810 * - Shutdown firmware
811 * - Remove the logical interfaces
812 * - Terminate the work queue
813 * - Unregister the device
814 * - Free the adapter structure
816 int mwifiex_remove_card(struct mwifiex_adapter *adapter, struct semaphore *sem)
818 struct mwifiex_private *priv = NULL;
821 if (down_interruptible(sem))
827 adapter->surprise_removed = true;
830 for (i = 0; i < adapter->priv_num; i++) {
831 priv = adapter->priv[i];
832 if (priv && priv->netdev) {
833 mwifiex_stop_net_dev_queue(priv->netdev, adapter);
834 if (netif_carrier_ok(priv->netdev))
835 netif_carrier_off(priv->netdev);
839 dev_dbg(adapter->dev, "cmd: calling mwifiex_shutdown_drv...\n");
840 adapter->init_wait_q_woken = false;
842 if (mwifiex_shutdown_drv(adapter) == -EINPROGRESS)
843 wait_event_interruptible(adapter->init_wait_q,
844 adapter->init_wait_q_woken);
845 dev_dbg(adapter->dev, "cmd: mwifiex_shutdown_drv done\n");
846 if (atomic_read(&adapter->rx_pending) ||
847 atomic_read(&adapter->tx_pending) ||
848 atomic_read(&adapter->cmd_pending)) {
849 dev_err(adapter->dev, "rx_pending=%d, tx_pending=%d, "
851 atomic_read(&adapter->rx_pending),
852 atomic_read(&adapter->tx_pending),
853 atomic_read(&adapter->cmd_pending));
856 for (i = 0; i < adapter->priv_num; i++) {
857 priv = adapter->priv[i];
863 if (priv->wdev && priv->netdev)
864 mwifiex_del_virtual_intf(adapter->wiphy, priv->wdev);
868 priv = adapter->priv[0];
869 if (!priv || !priv->wdev)
872 wiphy_unregister(priv->wdev->wiphy);
873 wiphy_free(priv->wdev->wiphy);
875 for (i = 0; i < adapter->priv_num; i++) {
876 priv = adapter->priv[i];
881 mwifiex_terminate_workqueue(adapter);
883 /* Unregister device */
884 dev_dbg(adapter->dev, "info: unregister device\n");
885 if (adapter->if_ops.unregister_dev)
886 adapter->if_ops.unregister_dev(adapter);
887 /* Free adapter structure */
888 dev_dbg(adapter->dev, "info: free adapter\n");
889 mwifiex_free_adapter(adapter);
896 EXPORT_SYMBOL_GPL(mwifiex_remove_card);
899 * This function initializes the module.
901 * The debug FS is also initialized if configured.
904 mwifiex_init_module(void)
906 #ifdef CONFIG_DEBUG_FS
907 mwifiex_debugfs_init();
913 * This function cleans up the module.
915 * The debug FS is removed if available.
918 mwifiex_cleanup_module(void)
920 #ifdef CONFIG_DEBUG_FS
921 mwifiex_debugfs_remove();
925 module_init(mwifiex_init_module);
926 module_exit(mwifiex_cleanup_module);
928 MODULE_AUTHOR("Marvell International Ltd.");
929 MODULE_DESCRIPTION("Marvell WiFi-Ex Driver version " VERSION);
930 MODULE_VERSION(VERSION);
931 MODULE_LICENSE("GPL v2");