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) ";
28 static char *cal_data_cfg;
29 module_param(cal_data_cfg, charp, 0);
31 static void scan_delay_timer_fn(unsigned long data)
33 struct mwifiex_private *priv = (struct mwifiex_private *)data;
34 struct mwifiex_adapter *adapter = priv->adapter;
35 struct cmd_ctrl_node *cmd_node, *tmp_node;
38 if (adapter->surprise_removed)
41 if (adapter->scan_delay_cnt == MWIFIEX_MAX_SCAN_DELAY_CNT ||
42 !adapter->scan_processing) {
44 * Abort scan operation by cancelling all pending scan
47 spin_lock_irqsave(&adapter->scan_pending_q_lock, flags);
48 list_for_each_entry_safe(cmd_node, tmp_node,
49 &adapter->scan_pending_q, list) {
50 list_del(&cmd_node->list);
51 mwifiex_insert_cmd_to_free_q(adapter, cmd_node);
53 spin_unlock_irqrestore(&adapter->scan_pending_q_lock, flags);
55 spin_lock_irqsave(&adapter->mwifiex_cmd_lock, flags);
56 adapter->scan_processing = false;
57 adapter->scan_delay_cnt = 0;
58 adapter->empty_tx_q_cnt = 0;
59 spin_unlock_irqrestore(&adapter->mwifiex_cmd_lock, flags);
61 if (priv->scan_request) {
62 dev_dbg(adapter->dev, "info: aborting scan\n");
63 cfg80211_scan_done(priv->scan_request, 1);
64 priv->scan_request = NULL;
66 priv->scan_aborting = false;
67 dev_dbg(adapter->dev, "info: scan already aborted\n");
72 if (!atomic_read(&priv->adapter->is_tx_received)) {
73 adapter->empty_tx_q_cnt++;
74 if (adapter->empty_tx_q_cnt == MWIFIEX_MAX_EMPTY_TX_Q_CNT) {
76 * No Tx traffic for 200msec. Get scan command from
77 * scan pending queue and put to cmd pending queue to
78 * resume scan operation
80 adapter->scan_delay_cnt = 0;
81 adapter->empty_tx_q_cnt = 0;
82 spin_lock_irqsave(&adapter->scan_pending_q_lock, flags);
83 cmd_node = list_first_entry(&adapter->scan_pending_q,
84 struct cmd_ctrl_node, list);
85 list_del(&cmd_node->list);
86 spin_unlock_irqrestore(&adapter->scan_pending_q_lock,
89 mwifiex_insert_cmd_to_pending_q(adapter, cmd_node,
91 queue_work(adapter->workqueue, &adapter->main_work);
95 adapter->empty_tx_q_cnt = 0;
98 /* Delay scan operation further by 20msec */
99 mod_timer(&priv->scan_delay_timer, jiffies +
100 msecs_to_jiffies(MWIFIEX_SCAN_DELAY_MSEC));
101 adapter->scan_delay_cnt++;
104 if (atomic_read(&priv->adapter->is_tx_received))
105 atomic_set(&priv->adapter->is_tx_received, false);
111 * This function registers the device and performs all the necessary
114 * The following initialization operations are performed -
115 * - Allocate adapter structure
116 * - Save interface specific operations table in adapter
117 * - Call interface specific initialization routine
118 * - Allocate private structures
119 * - Set default adapter structure parameters
122 * In case of any errors during inittialization, this function also ensures
123 * proper cleanup before exiting.
125 static int mwifiex_register(void *card, struct mwifiex_if_ops *if_ops,
128 struct mwifiex_adapter *adapter;
131 adapter = kzalloc(sizeof(struct mwifiex_adapter), GFP_KERNEL);
136 adapter->card = card;
138 /* Save interface specific operations in adapter */
139 memmove(&adapter->if_ops, if_ops, sizeof(struct mwifiex_if_ops));
141 /* card specific initialization has been deferred until now .. */
142 if (adapter->if_ops.init_if)
143 if (adapter->if_ops.init_if(adapter))
146 adapter->priv_num = 0;
148 for (i = 0; i < MWIFIEX_MAX_BSS_NUM; i++) {
149 /* Allocate memory for private structure */
151 kzalloc(sizeof(struct mwifiex_private), GFP_KERNEL);
152 if (!adapter->priv[i])
155 adapter->priv[i]->adapter = adapter;
158 setup_timer(&adapter->priv[i]->scan_delay_timer,
160 (unsigned long)adapter->priv[i]);
162 mwifiex_init_lock_list(adapter);
164 init_timer(&adapter->cmd_timer);
165 adapter->cmd_timer.function = mwifiex_cmd_timeout_func;
166 adapter->cmd_timer.data = (unsigned long) adapter;
171 dev_dbg(adapter->dev, "info: leave mwifiex_register with error\n");
173 for (i = 0; i < adapter->priv_num; i++)
174 kfree(adapter->priv[i]);
182 * This function unregisters the device and performs all the necessary
185 * The following cleanup operations are performed -
187 * - Free beacon buffers
188 * - Free private structures
189 * - Free adapter structure
191 static int mwifiex_unregister(struct mwifiex_adapter *adapter)
195 if (adapter->if_ops.cleanup_if)
196 adapter->if_ops.cleanup_if(adapter);
198 del_timer_sync(&adapter->cmd_timer);
200 /* Free private structures */
201 for (i = 0; i < adapter->priv_num; i++) {
202 if (adapter->priv[i]) {
203 mwifiex_free_curr_bcn(adapter->priv[i]);
204 del_timer_sync(&adapter->priv[i]->scan_delay_timer);
205 kfree(adapter->priv[i]);
216 * This function is the main procedure of the driver and handles various driver
217 * operations. It runs in a loop and provides the core functionalities.
219 * The main responsibilities of this function are -
220 * - Ensure concurrency control
221 * - Handle pending interrupts and call interrupt handlers
222 * - Wake up the card if required
223 * - Handle command responses and call response handlers
224 * - Handle events and call event handlers
225 * - Execute pending commands
226 * - Transmit pending data packets
228 int mwifiex_main_process(struct mwifiex_adapter *adapter)
234 spin_lock_irqsave(&adapter->main_proc_lock, flags);
236 /* Check if already processing */
237 if (adapter->mwifiex_processing) {
238 spin_unlock_irqrestore(&adapter->main_proc_lock, flags);
241 adapter->mwifiex_processing = true;
242 spin_unlock_irqrestore(&adapter->main_proc_lock, flags);
246 if ((adapter->hw_status == MWIFIEX_HW_STATUS_CLOSING) ||
247 (adapter->hw_status == MWIFIEX_HW_STATUS_NOT_READY))
250 /* Handle pending interrupt if any */
251 if (adapter->int_status) {
252 if (adapter->hs_activated)
253 mwifiex_process_hs_config(adapter);
254 if (adapter->if_ops.process_int_status)
255 adapter->if_ops.process_int_status(adapter);
258 /* Need to wake up the card ? */
259 if ((adapter->ps_state == PS_STATE_SLEEP) &&
260 (adapter->pm_wakeup_card_req &&
261 !adapter->pm_wakeup_fw_try) &&
262 (is_command_pending(adapter) ||
263 !mwifiex_wmm_lists_empty(adapter))) {
264 adapter->pm_wakeup_fw_try = true;
265 adapter->if_ops.wakeup(adapter);
269 if (IS_CARD_RX_RCVD(adapter)) {
270 adapter->pm_wakeup_fw_try = false;
271 if (adapter->ps_state == PS_STATE_SLEEP)
272 adapter->ps_state = PS_STATE_AWAKE;
274 /* We have tried to wakeup the card already */
275 if (adapter->pm_wakeup_fw_try)
277 if (adapter->ps_state != PS_STATE_AWAKE ||
278 adapter->tx_lock_flag)
281 if ((adapter->scan_processing &&
282 !adapter->scan_delay_cnt) || adapter->data_sent ||
283 mwifiex_wmm_lists_empty(adapter)) {
284 if (adapter->cmd_sent || adapter->curr_cmd ||
285 (!is_command_pending(adapter)))
290 /* Check Rx data for USB */
291 if (adapter->iface_type == MWIFIEX_USB)
292 while ((skb = skb_dequeue(&adapter->usb_rx_data_q)))
293 mwifiex_handle_rx_packet(adapter, skb);
295 /* Check for Cmd Resp */
296 if (adapter->cmd_resp_received) {
297 adapter->cmd_resp_received = false;
298 mwifiex_process_cmdresp(adapter);
300 /* call mwifiex back when init_fw is done */
301 if (adapter->hw_status == MWIFIEX_HW_STATUS_INIT_DONE) {
302 adapter->hw_status = MWIFIEX_HW_STATUS_READY;
303 mwifiex_init_fw_complete(adapter);
307 /* Check for event */
308 if (adapter->event_received) {
309 adapter->event_received = false;
310 mwifiex_process_event(adapter);
313 /* Check if we need to confirm Sleep Request
314 received previously */
315 if (adapter->ps_state == PS_STATE_PRE_SLEEP) {
316 if (!adapter->cmd_sent && !adapter->curr_cmd)
317 mwifiex_check_ps_cond(adapter);
320 /* * The ps_state may have been changed during processing of
321 * Sleep Request event.
323 if ((adapter->ps_state == PS_STATE_SLEEP) ||
324 (adapter->ps_state == PS_STATE_PRE_SLEEP) ||
325 (adapter->ps_state == PS_STATE_SLEEP_CFM) ||
326 adapter->tx_lock_flag)
329 if (!adapter->cmd_sent && !adapter->curr_cmd) {
330 if (mwifiex_exec_next_cmd(adapter) == -1) {
336 if ((!adapter->scan_processing || adapter->scan_delay_cnt) &&
337 !adapter->data_sent && !mwifiex_wmm_lists_empty(adapter)) {
338 mwifiex_wmm_process_tx(adapter);
339 if (adapter->hs_activated) {
340 adapter->is_hs_configured = false;
341 mwifiex_hs_activated_event
343 (adapter, MWIFIEX_BSS_ROLE_ANY),
348 if (adapter->delay_null_pkt && !adapter->cmd_sent &&
349 !adapter->curr_cmd && !is_command_pending(adapter) &&
350 mwifiex_wmm_lists_empty(adapter)) {
351 if (!mwifiex_send_null_packet
352 (mwifiex_get_priv(adapter, MWIFIEX_BSS_ROLE_STA),
353 MWIFIEX_TxPD_POWER_MGMT_NULL_PACKET |
354 MWIFIEX_TxPD_POWER_MGMT_LAST_PACKET)) {
355 adapter->delay_null_pkt = false;
356 adapter->ps_state = PS_STATE_SLEEP;
362 spin_lock_irqsave(&adapter->main_proc_lock, flags);
363 if ((adapter->int_status) || IS_CARD_RX_RCVD(adapter)) {
364 spin_unlock_irqrestore(&adapter->main_proc_lock, flags);
368 adapter->mwifiex_processing = false;
369 spin_unlock_irqrestore(&adapter->main_proc_lock, flags);
372 if (adapter->hw_status == MWIFIEX_HW_STATUS_CLOSING)
373 mwifiex_shutdown_drv(adapter);
376 EXPORT_SYMBOL_GPL(mwifiex_main_process);
379 * This function frees the adapter structure.
381 * Additionally, this closes the netlink socket, frees the timers
382 * and private structures.
384 static void mwifiex_free_adapter(struct mwifiex_adapter *adapter)
387 pr_err("%s: adapter is NULL\n", __func__);
391 mwifiex_unregister(adapter);
392 pr_debug("info: %s: free adapter\n", __func__);
396 * This function cancels all works in the queue and destroys
397 * the main workqueue.
399 static void mwifiex_terminate_workqueue(struct mwifiex_adapter *adapter)
401 flush_workqueue(adapter->workqueue);
402 destroy_workqueue(adapter->workqueue);
403 adapter->workqueue = NULL;
407 * This function gets firmware and initializes it.
409 * The main initialization steps followed are -
410 * - Download the correct firmware to card
411 * - Issue the init commands to firmware
413 static void mwifiex_fw_dpc(const struct firmware *firmware, void *context)
417 struct mwifiex_private *priv;
418 struct mwifiex_adapter *adapter = context;
419 struct mwifiex_fw_image fw;
420 struct semaphore *sem = adapter->card_sem;
421 bool init_failed = false;
422 struct wireless_dev *wdev;
425 dev_err(adapter->dev,
426 "Failed to get firmware %s\n", adapter->fw_name);
430 memset(&fw, 0, sizeof(struct mwifiex_fw_image));
431 adapter->firmware = firmware;
432 fw.fw_buf = (u8 *) adapter->firmware->data;
433 fw.fw_len = adapter->firmware->size;
435 if (adapter->if_ops.dnld_fw)
436 ret = adapter->if_ops.dnld_fw(adapter, &fw);
438 ret = mwifiex_dnld_fw(adapter, &fw);
442 dev_notice(adapter->dev, "WLAN FW is active\n");
445 if ((request_firmware(&adapter->cal_data, cal_data_cfg,
447 dev_err(adapter->dev,
448 "Cal data request_firmware() failed\n");
451 /* enable host interrupt after fw dnld is successful */
452 if (adapter->if_ops.enable_int) {
453 if (adapter->if_ops.enable_int(adapter))
457 adapter->init_wait_q_woken = false;
458 ret = mwifiex_init_fw(adapter);
462 adapter->hw_status = MWIFIEX_HW_STATUS_READY;
465 /* Wait for mwifiex_init to complete */
466 wait_event_interruptible(adapter->init_wait_q,
467 adapter->init_wait_q_woken);
468 if (adapter->hw_status != MWIFIEX_HW_STATUS_READY)
471 priv = adapter->priv[MWIFIEX_BSS_ROLE_STA];
472 if (mwifiex_register_cfg80211(adapter)) {
473 dev_err(adapter->dev, "cannot register with cfg80211\n");
478 /* Create station interface by default */
479 wdev = mwifiex_add_virtual_intf(adapter->wiphy, "mlan%d",
480 NL80211_IFTYPE_STATION, NULL, NULL);
482 dev_err(adapter->dev, "cannot create default STA interface\n");
488 mwifiex_drv_get_driver_version(adapter, fmt, sizeof(fmt) - 1);
489 dev_notice(adapter->dev, "driver_version = %s\n", fmt);
493 wiphy_unregister(adapter->wiphy);
494 wiphy_free(adapter->wiphy);
496 if (adapter->if_ops.disable_int)
497 adapter->if_ops.disable_int(adapter);
499 pr_debug("info: %s: unregister device\n", __func__);
500 if (adapter->if_ops.unregister_dev)
501 adapter->if_ops.unregister_dev(adapter);
503 if ((adapter->hw_status == MWIFIEX_HW_STATUS_FW_READY) ||
504 (adapter->hw_status == MWIFIEX_HW_STATUS_READY)) {
505 pr_debug("info: %s: shutdown mwifiex\n", __func__);
506 adapter->init_wait_q_woken = false;
508 if (mwifiex_shutdown_drv(adapter) == -EINPROGRESS)
509 wait_event_interruptible(adapter->init_wait_q,
510 adapter->init_wait_q_woken);
512 adapter->surprise_removed = true;
513 mwifiex_terminate_workqueue(adapter);
516 if (adapter->cal_data) {
517 release_firmware(adapter->cal_data);
518 adapter->cal_data = NULL;
520 if (adapter->firmware) {
521 release_firmware(adapter->firmware);
522 adapter->firmware = NULL;
524 complete(&adapter->fw_load);
526 mwifiex_free_adapter(adapter);
532 * This function initializes the hardware and gets firmware.
534 static int mwifiex_init_hw_fw(struct mwifiex_adapter *adapter)
538 init_completion(&adapter->fw_load);
539 ret = request_firmware_nowait(THIS_MODULE, 1, adapter->fw_name,
540 adapter->dev, GFP_KERNEL, adapter,
543 dev_err(adapter->dev,
544 "request_firmware_nowait() returned error %d\n", ret);
549 * CFG802.11 network device handler for open.
551 * Starts the data queue.
554 mwifiex_open(struct net_device *dev)
556 netif_tx_start_all_queues(dev);
561 * CFG802.11 network device handler for close.
564 mwifiex_close(struct net_device *dev)
566 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
568 if (priv->scan_request) {
569 dev_dbg(priv->adapter->dev, "aborting scan on ndo_stop\n");
570 cfg80211_scan_done(priv->scan_request, 1);
571 priv->scan_request = NULL;
572 priv->scan_aborting = true;
579 * Add buffer into wmm tx queue and queue work to transmit it.
581 int mwifiex_queue_tx_pkt(struct mwifiex_private *priv, struct sk_buff *skb)
583 struct netdev_queue *txq;
584 int index = mwifiex_1d_to_wmm_queue[skb->priority];
586 if (atomic_inc_return(&priv->wmm_tx_pending[index]) >= MAX_TX_PENDING) {
587 txq = netdev_get_tx_queue(priv->netdev, index);
588 if (!netif_tx_queue_stopped(txq)) {
589 netif_tx_stop_queue(txq);
590 dev_dbg(priv->adapter->dev, "stop queue: %d\n", index);
594 atomic_inc(&priv->adapter->tx_pending);
595 mwifiex_wmm_add_buf_txqueue(priv, skb);
597 if (priv->adapter->scan_delay_cnt)
598 atomic_set(&priv->adapter->is_tx_received, true);
600 queue_work(priv->adapter->workqueue, &priv->adapter->main_work);
606 * CFG802.11 network device handler for data transmission.
609 mwifiex_hard_start_xmit(struct sk_buff *skb, struct net_device *dev)
611 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
612 struct sk_buff *new_skb;
613 struct mwifiex_txinfo *tx_info;
616 dev_dbg(priv->adapter->dev, "data: %lu BSS(%d-%d): Data <= kernel\n",
617 jiffies, priv->bss_type, priv->bss_num);
619 if (priv->adapter->surprise_removed) {
621 priv->stats.tx_dropped++;
624 if (!skb->len || (skb->len > ETH_FRAME_LEN)) {
625 dev_err(priv->adapter->dev, "Tx: bad skb len %d\n", skb->len);
627 priv->stats.tx_dropped++;
630 if (skb_headroom(skb) < MWIFIEX_MIN_DATA_HEADER_LEN) {
631 dev_dbg(priv->adapter->dev,
632 "data: Tx: insufficient skb headroom %d\n",
634 /* Insufficient skb headroom - allocate a new skb */
636 skb_realloc_headroom(skb, MWIFIEX_MIN_DATA_HEADER_LEN);
637 if (unlikely(!new_skb)) {
638 dev_err(priv->adapter->dev, "Tx: cannot alloca new_skb\n");
640 priv->stats.tx_dropped++;
645 dev_dbg(priv->adapter->dev, "info: new skb headroomd %d\n",
649 tx_info = MWIFIEX_SKB_TXCB(skb);
650 tx_info->bss_num = priv->bss_num;
651 tx_info->bss_type = priv->bss_type;
652 tx_info->pkt_len = skb->len;
654 /* Record the current time the packet was queued; used to
655 * determine the amount of time the packet was queued in
656 * the driver before it was sent to the firmware.
657 * The delay is then sent along with the packet to the
658 * firmware for aggregate delay calculation for stats and
659 * MSDU lifetime expiry.
661 do_gettimeofday(&tv);
662 skb->tstamp = timeval_to_ktime(tv);
664 mwifiex_queue_tx_pkt(priv, skb);
670 * CFG802.11 network device handler for setting MAC address.
673 mwifiex_set_mac_address(struct net_device *dev, void *addr)
675 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
676 struct sockaddr *hw_addr = addr;
679 memcpy(priv->curr_addr, hw_addr->sa_data, ETH_ALEN);
681 /* Send request to firmware */
682 ret = mwifiex_send_cmd(priv, HostCmd_CMD_802_11_MAC_ADDRESS,
683 HostCmd_ACT_GEN_SET, 0, NULL, true);
686 memcpy(priv->netdev->dev_addr, priv->curr_addr, ETH_ALEN);
688 dev_err(priv->adapter->dev,
689 "set mac address failed: ret=%d\n", ret);
691 memcpy(dev->dev_addr, priv->curr_addr, ETH_ALEN);
697 * CFG802.11 network device handler for setting multicast list.
699 static void mwifiex_set_multicast_list(struct net_device *dev)
701 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
702 struct mwifiex_multicast_list mcast_list;
704 if (dev->flags & IFF_PROMISC) {
705 mcast_list.mode = MWIFIEX_PROMISC_MODE;
706 } else if (dev->flags & IFF_ALLMULTI ||
707 netdev_mc_count(dev) > MWIFIEX_MAX_MULTICAST_LIST_SIZE) {
708 mcast_list.mode = MWIFIEX_ALL_MULTI_MODE;
710 mcast_list.mode = MWIFIEX_MULTICAST_MODE;
711 mcast_list.num_multicast_addr =
712 mwifiex_copy_mcast_addr(&mcast_list, dev);
714 mwifiex_request_set_multicast_list(priv, &mcast_list);
718 * CFG802.11 network device handler for transmission timeout.
721 mwifiex_tx_timeout(struct net_device *dev)
723 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
725 priv->num_tx_timeout++;
726 priv->tx_timeout_cnt++;
727 dev_err(priv->adapter->dev,
728 "%lu : Tx timeout(#%d), bss_type-num = %d-%d\n",
729 jiffies, priv->tx_timeout_cnt, priv->bss_type, priv->bss_num);
730 mwifiex_set_trans_start(dev);
732 if (priv->tx_timeout_cnt > TX_TIMEOUT_THRESHOLD &&
733 priv->adapter->if_ops.card_reset) {
734 dev_err(priv->adapter->dev,
735 "tx_timeout_cnt exceeds threshold. Triggering card reset!\n");
736 priv->adapter->if_ops.card_reset(priv->adapter);
741 * CFG802.11 network device handler for statistics retrieval.
743 static struct net_device_stats *mwifiex_get_stats(struct net_device *dev)
745 struct mwifiex_private *priv = mwifiex_netdev_get_priv(dev);
751 mwifiex_netdev_select_wmm_queue(struct net_device *dev, struct sk_buff *skb,
752 void *accel_priv, select_queue_fallback_t fallback)
754 skb->priority = cfg80211_classify8021d(skb, NULL);
755 return mwifiex_1d_to_wmm_queue[skb->priority];
758 /* Network device handlers */
759 static const struct net_device_ops mwifiex_netdev_ops = {
760 .ndo_open = mwifiex_open,
761 .ndo_stop = mwifiex_close,
762 .ndo_start_xmit = mwifiex_hard_start_xmit,
763 .ndo_set_mac_address = mwifiex_set_mac_address,
764 .ndo_tx_timeout = mwifiex_tx_timeout,
765 .ndo_get_stats = mwifiex_get_stats,
766 .ndo_set_rx_mode = mwifiex_set_multicast_list,
767 .ndo_select_queue = mwifiex_netdev_select_wmm_queue,
771 * This function initializes the private structure parameters.
773 * The following wait queues are initialized -
775 * - Command wait queue
776 * - Statistics wait queue
778 * ...and the following default parameters are set -
779 * - Current key index : Set to 0
780 * - Rate index : Set to auto
781 * - Media connected : Set to disconnected
782 * - Adhoc link sensed : Set to false
783 * - Nick name : Set to null
784 * - Number of Tx timeout : Set to 0
785 * - Device address : Set to current address
787 * In addition, the CFG80211 work queue is also created.
789 void mwifiex_init_priv_params(struct mwifiex_private *priv,
790 struct net_device *dev)
792 dev->netdev_ops = &mwifiex_netdev_ops;
793 dev->destructor = free_netdev;
794 /* Initialize private structure */
795 priv->current_key_index = 0;
796 priv->media_connected = false;
797 memset(&priv->nick_name, 0, sizeof(priv->nick_name));
798 memset(priv->mgmt_ie, 0,
799 sizeof(struct mwifiex_ie) * MAX_MGMT_IE_INDEX);
800 priv->beacon_idx = MWIFIEX_AUTO_IDX_MASK;
801 priv->proberesp_idx = MWIFIEX_AUTO_IDX_MASK;
802 priv->assocresp_idx = MWIFIEX_AUTO_IDX_MASK;
803 priv->rsn_idx = MWIFIEX_AUTO_IDX_MASK;
804 priv->num_tx_timeout = 0;
805 memcpy(dev->dev_addr, priv->curr_addr, ETH_ALEN);
809 * This function check if command is pending.
811 int is_command_pending(struct mwifiex_adapter *adapter)
814 int is_cmd_pend_q_empty;
816 spin_lock_irqsave(&adapter->cmd_pending_q_lock, flags);
817 is_cmd_pend_q_empty = list_empty(&adapter->cmd_pending_q);
818 spin_unlock_irqrestore(&adapter->cmd_pending_q_lock, flags);
820 return !is_cmd_pend_q_empty;
824 * This is the main work queue function.
826 * It handles the main process, which in turn handles the complete
829 static void mwifiex_main_work_queue(struct work_struct *work)
831 struct mwifiex_adapter *adapter =
832 container_of(work, struct mwifiex_adapter, main_work);
834 if (adapter->surprise_removed)
836 mwifiex_main_process(adapter);
840 * This function adds the card.
842 * This function follows the following major steps to set up the device -
843 * - Initialize software. This includes probing the card, registering
844 * the interface operations table, and allocating/initializing the
846 * - Set up the netlink socket
847 * - Create and start the main work queue
848 * - Register the device
849 * - Initialize firmware and hardware
850 * - Add logical interfaces
853 mwifiex_add_card(void *card, struct semaphore *sem,
854 struct mwifiex_if_ops *if_ops, u8 iface_type)
856 struct mwifiex_adapter *adapter;
858 if (down_interruptible(sem))
861 if (mwifiex_register(card, if_ops, (void **)&adapter)) {
862 pr_err("%s: software init failed\n", __func__);
866 adapter->iface_type = iface_type;
867 adapter->card_sem = sem;
869 adapter->hw_status = MWIFIEX_HW_STATUS_INITIALIZING;
870 adapter->surprise_removed = false;
871 init_waitqueue_head(&adapter->init_wait_q);
872 adapter->is_suspended = false;
873 adapter->hs_activated = false;
874 init_waitqueue_head(&adapter->hs_activate_wait_q);
875 init_waitqueue_head(&adapter->cmd_wait_q.wait);
876 adapter->cmd_wait_q.status = 0;
877 adapter->scan_wait_q_woken = false;
880 alloc_workqueue("MWIFIEX_WORK_QUEUE",
881 WQ_HIGHPRI | WQ_MEM_RECLAIM | WQ_UNBOUND, 1);
882 if (!adapter->workqueue)
885 INIT_WORK(&adapter->main_work, mwifiex_main_work_queue);
887 /* Register the device. Fill up the private data structure with relevant
888 information from the card. */
889 if (adapter->if_ops.register_dev(adapter)) {
890 pr_err("%s: failed to register mwifiex device\n", __func__);
891 goto err_registerdev;
894 if (mwifiex_init_hw_fw(adapter)) {
895 pr_err("%s: firmware init failed\n", __func__);
902 pr_debug("info: %s: unregister device\n", __func__);
903 if (adapter->if_ops.unregister_dev)
904 adapter->if_ops.unregister_dev(adapter);
905 if ((adapter->hw_status == MWIFIEX_HW_STATUS_FW_READY) ||
906 (adapter->hw_status == MWIFIEX_HW_STATUS_READY)) {
907 pr_debug("info: %s: shutdown mwifiex\n", __func__);
908 adapter->init_wait_q_woken = false;
910 if (mwifiex_shutdown_drv(adapter) == -EINPROGRESS)
911 wait_event_interruptible(adapter->init_wait_q,
912 adapter->init_wait_q_woken);
915 adapter->surprise_removed = true;
916 mwifiex_terminate_workqueue(adapter);
918 mwifiex_free_adapter(adapter);
926 EXPORT_SYMBOL_GPL(mwifiex_add_card);
929 * This function removes the card.
931 * This function follows the following major steps to remove the device -
932 * - Stop data traffic
933 * - Shutdown firmware
934 * - Remove the logical interfaces
935 * - Terminate the work queue
936 * - Unregister the device
937 * - Free the adapter structure
939 int mwifiex_remove_card(struct mwifiex_adapter *adapter, struct semaphore *sem)
941 struct mwifiex_private *priv = NULL;
944 if (down_interruptible(sem))
950 /* We can no longer handle interrupts once we start doing the teardown
952 if (adapter->if_ops.disable_int)
953 adapter->if_ops.disable_int(adapter);
955 adapter->surprise_removed = true;
958 for (i = 0; i < adapter->priv_num; i++) {
959 priv = adapter->priv[i];
960 if (priv && priv->netdev) {
961 mwifiex_stop_net_dev_queue(priv->netdev, adapter);
962 if (netif_carrier_ok(priv->netdev))
963 netif_carrier_off(priv->netdev);
967 dev_dbg(adapter->dev, "cmd: calling mwifiex_shutdown_drv...\n");
968 adapter->init_wait_q_woken = false;
970 if (mwifiex_shutdown_drv(adapter) == -EINPROGRESS)
971 wait_event_interruptible(adapter->init_wait_q,
972 adapter->init_wait_q_woken);
973 dev_dbg(adapter->dev, "cmd: mwifiex_shutdown_drv done\n");
974 if (atomic_read(&adapter->rx_pending) ||
975 atomic_read(&adapter->tx_pending) ||
976 atomic_read(&adapter->cmd_pending)) {
977 dev_err(adapter->dev, "rx_pending=%d, tx_pending=%d, "
979 atomic_read(&adapter->rx_pending),
980 atomic_read(&adapter->tx_pending),
981 atomic_read(&adapter->cmd_pending));
984 for (i = 0; i < adapter->priv_num; i++) {
985 priv = adapter->priv[i];
991 if (priv->wdev && priv->netdev)
992 mwifiex_del_virtual_intf(adapter->wiphy, priv->wdev);
996 wiphy_unregister(adapter->wiphy);
997 wiphy_free(adapter->wiphy);
999 mwifiex_terminate_workqueue(adapter);
1001 /* Unregister device */
1002 dev_dbg(adapter->dev, "info: unregister device\n");
1003 if (adapter->if_ops.unregister_dev)
1004 adapter->if_ops.unregister_dev(adapter);
1005 /* Free adapter structure */
1006 dev_dbg(adapter->dev, "info: free adapter\n");
1007 mwifiex_free_adapter(adapter);
1014 EXPORT_SYMBOL_GPL(mwifiex_remove_card);
1017 * This function initializes the module.
1019 * The debug FS is also initialized if configured.
1022 mwifiex_init_module(void)
1024 #ifdef CONFIG_DEBUG_FS
1025 mwifiex_debugfs_init();
1031 * This function cleans up the module.
1033 * The debug FS is removed if available.
1036 mwifiex_cleanup_module(void)
1038 #ifdef CONFIG_DEBUG_FS
1039 mwifiex_debugfs_remove();
1043 module_init(mwifiex_init_module);
1044 module_exit(mwifiex_cleanup_module);
1046 MODULE_AUTHOR("Marvell International Ltd.");
1047 MODULE_DESCRIPTION("Marvell WiFi-Ex Driver version " VERSION);
1048 MODULE_VERSION(VERSION);
1049 MODULE_LICENSE("GPL v2");