2 * Marvell Wireless LAN device driver: HW/FW Initialization
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.
29 * This function adds a BSS priority table to the table list.
31 * The function allocates a new BSS priority table node and adds it to
32 * the end of BSS priority table list, kept in driver memory.
34 static int mwifiex_add_bss_prio_tbl(struct mwifiex_private
*priv
)
36 struct mwifiex_adapter
*adapter
= priv
->adapter
;
37 struct mwifiex_bss_prio_node
*bss_prio
;
40 bss_prio
= kzalloc(sizeof(struct mwifiex_bss_prio_node
), GFP_KERNEL
);
42 dev_err(adapter
->dev
, "%s: failed to alloc bss_prio\n",
47 bss_prio
->priv
= priv
;
48 INIT_LIST_HEAD(&bss_prio
->list
);
49 if (!adapter
->bss_prio_tbl
[priv
->bss_priority
].bss_prio_cur
)
50 adapter
->bss_prio_tbl
[priv
->bss_priority
].bss_prio_cur
=
53 spin_lock_irqsave(&adapter
->bss_prio_tbl
[priv
->bss_priority
]
54 .bss_prio_lock
, flags
);
55 list_add_tail(&bss_prio
->list
,
56 &adapter
->bss_prio_tbl
[priv
->bss_priority
]
58 spin_unlock_irqrestore(&adapter
->bss_prio_tbl
[priv
->bss_priority
]
59 .bss_prio_lock
, flags
);
65 * This function initializes the private structure and sets default
66 * values to the members.
68 * Additionally, it also initializes all the locks and sets up all the
71 static int mwifiex_init_priv(struct mwifiex_private
*priv
)
75 priv
->media_connected
= false;
76 memset(priv
->curr_addr
, 0xff, ETH_ALEN
);
78 priv
->pkt_tx_ctrl
= 0;
79 priv
->bss_mode
= NL80211_IFTYPE_STATION
;
80 priv
->data_rate
= 0; /* Initially indicate the rate as auto */
81 priv
->is_data_rate_auto
= true;
82 priv
->bcn_avg_factor
= DEFAULT_BCN_AVG_FACTOR
;
83 priv
->data_avg_factor
= DEFAULT_DATA_AVG_FACTOR
;
85 priv
->sec_info
.wep_status
= MWIFIEX_802_11_WEP_DISABLED
;
86 priv
->sec_info
.authentication_mode
= NL80211_AUTHTYPE_OPEN_SYSTEM
;
87 priv
->sec_info
.encryption_mode
= 0;
88 for (i
= 0; i
< ARRAY_SIZE(priv
->wep_key
); i
++)
89 memset(&priv
->wep_key
[i
], 0, sizeof(struct mwifiex_wep_key
));
90 priv
->wep_key_curr_index
= 0;
91 priv
->curr_pkt_filter
= HostCmd_ACT_MAC_RX_ON
| HostCmd_ACT_MAC_TX_ON
|
92 HostCmd_ACT_MAC_ETHERNETII_ENABLE
;
94 priv
->beacon_period
= 100; /* beacon interval */ ;
95 priv
->attempted_bss_desc
= NULL
;
96 memset(&priv
->curr_bss_params
, 0, sizeof(priv
->curr_bss_params
));
97 priv
->listen_interval
= MWIFIEX_DEFAULT_LISTEN_INTERVAL
;
99 memset(&priv
->prev_ssid
, 0, sizeof(priv
->prev_ssid
));
100 memset(&priv
->prev_bssid
, 0, sizeof(priv
->prev_bssid
));
101 memset(&priv
->assoc_rsp_buf
, 0, sizeof(priv
->assoc_rsp_buf
));
102 priv
->assoc_rsp_size
= 0;
103 priv
->adhoc_channel
= DEFAULT_AD_HOC_CHANNEL
;
104 priv
->atim_window
= 0;
105 priv
->adhoc_state
= ADHOC_IDLE
;
106 priv
->tx_power_level
= 0;
107 priv
->max_tx_power_level
= 0;
108 priv
->min_tx_power_level
= 0;
110 priv
->rxpd_htinfo
= 0;
112 priv
->rate_bitmap
= 0;
113 priv
->data_rssi_last
= 0;
114 priv
->data_rssi_avg
= 0;
115 priv
->data_nf_avg
= 0;
116 priv
->data_nf_last
= 0;
117 priv
->bcn_rssi_last
= 0;
118 priv
->bcn_rssi_avg
= 0;
119 priv
->bcn_nf_avg
= 0;
120 priv
->bcn_nf_last
= 0;
121 memset(&priv
->wpa_ie
, 0, sizeof(priv
->wpa_ie
));
122 memset(&priv
->aes_key
, 0, sizeof(priv
->aes_key
));
123 priv
->wpa_ie_len
= 0;
124 priv
->wpa_is_gtk_set
= false;
126 memset(&priv
->assoc_tlv_buf
, 0, sizeof(priv
->assoc_tlv_buf
));
127 priv
->assoc_tlv_buf_len
= 0;
128 memset(&priv
->wps
, 0, sizeof(priv
->wps
));
129 memset(&priv
->gen_ie_buf
, 0, sizeof(priv
->gen_ie_buf
));
130 priv
->gen_ie_buf_len
= 0;
131 memset(priv
->vs_ie
, 0, sizeof(priv
->vs_ie
));
133 priv
->wmm_required
= true;
134 priv
->wmm_enabled
= false;
135 priv
->wmm_qosinfo
= 0;
136 priv
->curr_bcn_buf
= NULL
;
137 priv
->curr_bcn_size
= 0;
139 priv
->scan_block
= false;
141 return mwifiex_add_bss_prio_tbl(priv
);
145 * This function allocates buffers for members of the adapter
148 * The memory allocated includes scan table, command buffers, and
149 * sleep confirm command buffer. In addition, the queues are
152 static int mwifiex_allocate_adapter(struct mwifiex_adapter
*adapter
)
156 struct mwifiex_bssdescriptor
*temp_scan_table
;
158 /* Allocate buffer to store the BSSID list */
159 buf_size
= sizeof(struct mwifiex_bssdescriptor
) * IW_MAX_AP
;
160 temp_scan_table
= kzalloc(buf_size
, GFP_KERNEL
);
161 if (!temp_scan_table
) {
162 dev_err(adapter
->dev
, "%s: failed to alloc temp_scan_table\n",
167 adapter
->scan_table
= temp_scan_table
;
169 /* Allocate command buffer */
170 ret
= mwifiex_alloc_cmd_buffer(adapter
);
172 dev_err(adapter
->dev
, "%s: failed to alloc cmd buffer\n",
178 dev_alloc_skb(sizeof(struct mwifiex_opt_sleep_confirm
)
181 if (!adapter
->sleep_cfm
) {
182 dev_err(adapter
->dev
, "%s: failed to alloc sleep cfm"
183 " cmd buffer\n", __func__
);
186 skb_reserve(adapter
->sleep_cfm
, INTF_HEADER_LEN
);
192 * This function initializes the adapter structure and sets default
193 * values to the members of adapter.
195 * This also initializes the WMM related parameters in the driver private
198 static void mwifiex_init_adapter(struct mwifiex_adapter
*adapter
)
200 struct mwifiex_opt_sleep_confirm
*sleep_cfm_buf
= NULL
;
202 skb_put(adapter
->sleep_cfm
, sizeof(struct mwifiex_opt_sleep_confirm
));
203 sleep_cfm_buf
= (struct mwifiex_opt_sleep_confirm
*)
204 (adapter
->sleep_cfm
->data
);
206 adapter
->cmd_sent
= false;
207 adapter
->data_sent
= true;
208 adapter
->cmd_resp_received
= false;
209 adapter
->event_received
= false;
210 adapter
->data_received
= false;
212 adapter
->surprise_removed
= false;
214 adapter
->hw_status
= MWIFIEX_HW_STATUS_INITIALIZING
;
216 adapter
->ps_mode
= MWIFIEX_802_11_POWER_MODE_CAM
;
217 adapter
->ps_state
= PS_STATE_AWAKE
;
218 adapter
->need_to_wakeup
= false;
220 adapter
->scan_mode
= HostCmd_BSS_MODE_ANY
;
221 adapter
->specific_scan_time
= MWIFIEX_SPECIFIC_SCAN_CHAN_TIME
;
222 adapter
->active_scan_time
= MWIFIEX_ACTIVE_SCAN_CHAN_TIME
;
223 adapter
->passive_scan_time
= MWIFIEX_PASSIVE_SCAN_CHAN_TIME
;
225 adapter
->num_in_scan_table
= 0;
226 memset(adapter
->scan_table
, 0,
227 (sizeof(struct mwifiex_bssdescriptor
) * IW_MAX_AP
));
228 adapter
->scan_probes
= 1;
230 memset(adapter
->bcn_buf
, 0, sizeof(adapter
->bcn_buf
));
231 adapter
->bcn_buf_end
= adapter
->bcn_buf
;
233 adapter
->multiple_dtim
= 1;
235 adapter
->local_listen_interval
= 0; /* default value in firmware
238 adapter
->is_deep_sleep
= false;
240 adapter
->delay_null_pkt
= false;
241 adapter
->delay_to_ps
= 1000;
242 adapter
->enhanced_ps_mode
= PS_MODE_AUTO
;
244 adapter
->gen_null_pkt
= false; /* Disable NULL Pkg generation by
246 adapter
->pps_uapsd_mode
= false; /* Disable pps/uapsd mode by
248 adapter
->pm_wakeup_card_req
= false;
250 adapter
->pm_wakeup_fw_try
= false;
252 adapter
->max_tx_buf_size
= MWIFIEX_TX_DATA_BUF_SIZE_2K
;
253 adapter
->tx_buf_size
= MWIFIEX_TX_DATA_BUF_SIZE_2K
;
254 adapter
->curr_tx_buf_size
= MWIFIEX_TX_DATA_BUF_SIZE_2K
;
256 adapter
->is_hs_configured
= false;
257 adapter
->hs_cfg
.conditions
= cpu_to_le32(HOST_SLEEP_CFG_COND_DEF
);
258 adapter
->hs_cfg
.gpio
= HOST_SLEEP_CFG_GPIO_DEF
;
259 adapter
->hs_cfg
.gap
= HOST_SLEEP_CFG_GAP_DEF
;
260 adapter
->hs_activated
= false;
262 memset(adapter
->event_body
, 0, sizeof(adapter
->event_body
));
263 adapter
->hw_dot_11n_dev_cap
= 0;
264 adapter
->hw_dev_mcs_support
= 0;
265 adapter
->chan_offset
= 0;
266 adapter
->adhoc_11n_enabled
= false;
268 mwifiex_wmm_init(adapter
);
270 if (adapter
->sleep_cfm
) {
271 memset(sleep_cfm_buf
, 0, adapter
->sleep_cfm
->len
);
272 sleep_cfm_buf
->command
=
273 cpu_to_le16(HostCmd_CMD_802_11_PS_MODE_ENH
);
274 sleep_cfm_buf
->size
=
275 cpu_to_le16(adapter
->sleep_cfm
->len
);
276 sleep_cfm_buf
->result
= 0;
277 sleep_cfm_buf
->action
= cpu_to_le16(SLEEP_CONFIRM
);
278 sleep_cfm_buf
->resp_ctrl
= cpu_to_le16(RESP_NEEDED
);
280 memset(&adapter
->sleep_params
, 0, sizeof(adapter
->sleep_params
));
281 memset(&adapter
->sleep_period
, 0, sizeof(adapter
->sleep_period
));
282 adapter
->tx_lock_flag
= false;
283 adapter
->null_pkt_interval
= 0;
284 adapter
->fw_bands
= 0;
285 adapter
->config_bands
= 0;
286 adapter
->adhoc_start_band
= 0;
287 adapter
->scan_channels
= NULL
;
288 adapter
->fw_release_number
= 0;
289 adapter
->fw_cap_info
= 0;
290 memset(&adapter
->upld_buf
, 0, sizeof(adapter
->upld_buf
));
291 adapter
->event_cause
= 0;
292 adapter
->region_code
= 0;
293 adapter
->bcn_miss_time_out
= DEFAULT_BCN_MISS_TIMEOUT
;
294 adapter
->adhoc_awake_period
= 0;
295 memset(&adapter
->arp_filter
, 0, sizeof(adapter
->arp_filter
));
296 adapter
->arp_filter_size
= 0;
300 * This function frees the adapter structure.
302 * The freeing operation is done recursively, by canceling all
303 * pending commands, freeing the member buffers previously
304 * allocated (command buffers, scan table buffer, sleep confirm
305 * command buffer), stopping the timers and calling the cleanup
306 * routines for every interface, before the actual adapter
307 * structure is freed.
310 mwifiex_free_adapter(struct mwifiex_adapter
*adapter
)
313 pr_err("%s: adapter is NULL\n", __func__
);
317 mwifiex_cancel_all_pending_cmd(adapter
);
319 /* Free lock variables */
320 mwifiex_free_lock_list(adapter
);
322 /* Free command buffer */
323 dev_dbg(adapter
->dev
, "info: free cmd buffer\n");
324 mwifiex_free_cmd_buffer(adapter
);
326 del_timer(&adapter
->cmd_timer
);
328 dev_dbg(adapter
->dev
, "info: free scan table\n");
329 kfree(adapter
->scan_table
);
330 adapter
->scan_table
= NULL
;
332 adapter
->if_ops
.cleanup_if(adapter
);
334 dev_kfree_skb_any(adapter
->sleep_cfm
);
338 * This function intializes the lock variables and
341 int mwifiex_init_lock_list(struct mwifiex_adapter
*adapter
)
343 struct mwifiex_private
*priv
;
346 spin_lock_init(&adapter
->mwifiex_lock
);
347 spin_lock_init(&adapter
->int_lock
);
348 spin_lock_init(&adapter
->main_proc_lock
);
349 spin_lock_init(&adapter
->mwifiex_cmd_lock
);
350 for (i
= 0; i
< adapter
->priv_num
; i
++) {
351 if (adapter
->priv
[i
]) {
352 priv
= adapter
->priv
[i
];
353 spin_lock_init(&priv
->rx_pkt_lock
);
354 spin_lock_init(&priv
->wmm
.ra_list_spinlock
);
355 spin_lock_init(&priv
->curr_bcn_buf_lock
);
359 /* Initialize cmd_free_q */
360 INIT_LIST_HEAD(&adapter
->cmd_free_q
);
361 /* Initialize cmd_pending_q */
362 INIT_LIST_HEAD(&adapter
->cmd_pending_q
);
363 /* Initialize scan_pending_q */
364 INIT_LIST_HEAD(&adapter
->scan_pending_q
);
366 spin_lock_init(&adapter
->cmd_free_q_lock
);
367 spin_lock_init(&adapter
->cmd_pending_q_lock
);
368 spin_lock_init(&adapter
->scan_pending_q_lock
);
370 for (i
= 0; i
< adapter
->priv_num
; ++i
) {
371 INIT_LIST_HEAD(&adapter
->bss_prio_tbl
[i
].bss_prio_head
);
372 adapter
->bss_prio_tbl
[i
].bss_prio_cur
= NULL
;
373 spin_lock_init(&adapter
->bss_prio_tbl
[i
].bss_prio_lock
);
376 for (i
= 0; i
< adapter
->priv_num
; i
++) {
377 if (!adapter
->priv
[i
])
379 priv
= adapter
->priv
[i
];
380 for (j
= 0; j
< MAX_NUM_TID
; ++j
) {
381 INIT_LIST_HEAD(&priv
->wmm
.tid_tbl_ptr
[j
].ra_list
);
382 spin_lock_init(&priv
->wmm
.tid_tbl_ptr
[j
].tid_tbl_lock
);
384 INIT_LIST_HEAD(&priv
->tx_ba_stream_tbl_ptr
);
385 INIT_LIST_HEAD(&priv
->rx_reorder_tbl_ptr
);
387 spin_lock_init(&priv
->tx_ba_stream_tbl_lock
);
388 spin_lock_init(&priv
->rx_reorder_tbl_lock
);
395 * This function releases the lock variables and frees the locks and
398 void mwifiex_free_lock_list(struct mwifiex_adapter
*adapter
)
400 struct mwifiex_private
*priv
;
404 list_del(&adapter
->cmd_free_q
);
405 list_del(&adapter
->cmd_pending_q
);
406 list_del(&adapter
->scan_pending_q
);
408 for (i
= 0; i
< adapter
->priv_num
; i
++)
409 list_del(&adapter
->bss_prio_tbl
[i
].bss_prio_head
);
411 for (i
= 0; i
< adapter
->priv_num
; i
++) {
412 if (adapter
->priv
[i
]) {
413 priv
= adapter
->priv
[i
];
414 for (j
= 0; j
< MAX_NUM_TID
; ++j
)
415 list_del(&priv
->wmm
.tid_tbl_ptr
[j
].ra_list
);
416 list_del(&priv
->tx_ba_stream_tbl_ptr
);
417 list_del(&priv
->rx_reorder_tbl_ptr
);
423 * This function initializes the firmware.
425 * The following operations are performed sequentially -
426 * - Allocate adapter structure
427 * - Initialize the adapter structure
428 * - Initialize the private structure
429 * - Add BSS priority tables to the adapter structure
430 * - For each interface, send the init commands to firmware
431 * - Send the first command in command pending queue, if available
433 int mwifiex_init_fw(struct mwifiex_adapter
*adapter
)
436 struct mwifiex_private
*priv
;
437 u8 i
, first_sta
= true;
438 int is_cmd_pend_q_empty
;
441 adapter
->hw_status
= MWIFIEX_HW_STATUS_INITIALIZING
;
443 /* Allocate memory for member of adapter structure */
444 ret
= mwifiex_allocate_adapter(adapter
);
448 /* Initialize adapter structure */
449 mwifiex_init_adapter(adapter
);
451 for (i
= 0; i
< adapter
->priv_num
; i
++) {
452 if (adapter
->priv
[i
]) {
453 priv
= adapter
->priv
[i
];
455 /* Initialize private structure */
456 ret
= mwifiex_init_priv(priv
);
461 for (i
= 0; i
< adapter
->priv_num
; i
++) {
462 if (adapter
->priv
[i
]) {
463 ret
= mwifiex_sta_init_cmd(adapter
->priv
[i
], first_sta
);
471 spin_lock_irqsave(&adapter
->cmd_pending_q_lock
, flags
);
472 is_cmd_pend_q_empty
= list_empty(&adapter
->cmd_pending_q
);
473 spin_unlock_irqrestore(&adapter
->cmd_pending_q_lock
, flags
);
474 if (!is_cmd_pend_q_empty
) {
475 /* Send the first command in queue and return */
476 if (mwifiex_main_process(adapter
) != -1)
479 adapter
->hw_status
= MWIFIEX_HW_STATUS_READY
;
486 * This function deletes the BSS priority tables.
488 * The function traverses through all the allocated BSS priority nodes
489 * in every BSS priority table and frees them.
491 static void mwifiex_delete_bss_prio_tbl(struct mwifiex_private
*priv
)
494 struct mwifiex_adapter
*adapter
= priv
->adapter
;
495 struct mwifiex_bss_prio_node
*bssprio_node
, *tmp_node
, **cur
;
496 struct list_head
*head
;
500 for (i
= 0; i
< adapter
->priv_num
; ++i
) {
501 head
= &adapter
->bss_prio_tbl
[i
].bss_prio_head
;
502 cur
= &adapter
->bss_prio_tbl
[i
].bss_prio_cur
;
503 lock
= &adapter
->bss_prio_tbl
[i
].bss_prio_lock
;
504 dev_dbg(adapter
->dev
, "info: delete BSS priority table,"
505 " index = %d, i = %d, head = %p, cur = %p\n",
506 priv
->bss_index
, i
, head
, *cur
);
508 spin_lock_irqsave(lock
, flags
);
509 if (list_empty(head
)) {
510 spin_unlock_irqrestore(lock
, flags
);
513 bssprio_node
= list_first_entry(head
,
514 struct mwifiex_bss_prio_node
, list
);
515 spin_unlock_irqrestore(lock
, flags
);
517 list_for_each_entry_safe(bssprio_node
, tmp_node
, head
,
519 if (bssprio_node
->priv
== priv
) {
520 dev_dbg(adapter
->dev
, "info: Delete "
521 "node %p, next = %p\n",
522 bssprio_node
, tmp_node
);
523 spin_lock_irqsave(lock
, flags
);
524 list_del(&bssprio_node
->list
);
525 spin_unlock_irqrestore(lock
, flags
);
529 *cur
= (struct mwifiex_bss_prio_node
*)head
;
535 * This function is used to shutdown the driver.
537 * The following operations are performed sequentially -
538 * - Check if already shut down
539 * - Make sure the main process has stopped
540 * - Clean up the Tx and Rx queues
541 * - Delete BSS priority tables
543 * - Notify completion
546 mwifiex_shutdown_drv(struct mwifiex_adapter
*adapter
)
548 int ret
= -EINPROGRESS
;
549 struct mwifiex_private
*priv
;
553 /* mwifiex already shutdown */
554 if (adapter
->hw_status
== MWIFIEX_HW_STATUS_NOT_READY
)
557 adapter
->hw_status
= MWIFIEX_HW_STATUS_CLOSING
;
558 /* wait for mwifiex_process to complete */
559 if (adapter
->mwifiex_processing
) {
560 dev_warn(adapter
->dev
, "main process is still running\n");
564 /* shut down mwifiex */
565 dev_dbg(adapter
->dev
, "info: shutdown mwifiex...\n");
567 /* Clean up Tx/Rx queues and delete BSS priority table */
568 for (i
= 0; i
< adapter
->priv_num
; i
++) {
569 if (adapter
->priv
[i
]) {
570 priv
= adapter
->priv
[i
];
572 mwifiex_clean_txrx(priv
);
573 mwifiex_delete_bss_prio_tbl(priv
);
577 spin_lock_irqsave(&adapter
->mwifiex_lock
, flags
);
579 /* Free adapter structure */
580 mwifiex_free_adapter(adapter
);
582 spin_unlock_irqrestore(&adapter
->mwifiex_lock
, flags
);
584 /* Notify completion */
585 ret
= mwifiex_shutdown_fw_complete(adapter
);
591 * This function downloads the firmware to the card.
593 * The actual download is preceded by two sanity checks -
594 * - Check if firmware is already running
595 * - Check if the interface is the winner to download the firmware
597 * ...and followed by another -
598 * - Check if the firmware is downloaded successfully
600 * After download is successfully completed, the host interrupts are enabled.
602 int mwifiex_dnld_fw(struct mwifiex_adapter
*adapter
,
603 struct mwifiex_fw_image
*pmfw
)
608 /* Check if firmware is already running */
609 ret
= adapter
->if_ops
.check_fw_status(adapter
, poll_num
, &winner
);
611 dev_notice(adapter
->dev
,
612 "WLAN FW already running! Skip FW download\n");
615 poll_num
= MAX_FIRMWARE_POLL_TRIES
;
617 /* Check if we are the winner for downloading FW */
619 dev_notice(adapter
->dev
,
620 "Other interface already running!"
621 " Skip FW download\n");
622 poll_num
= MAX_MULTI_INTERFACE_POLL_TRIES
;
626 /* Download firmware with helper */
627 ret
= adapter
->if_ops
.prog_fw(adapter
, pmfw
);
629 dev_err(adapter
->dev
, "prog_fw failed ret=%#x\n", ret
);
635 /* Check if the firmware is downloaded successfully or not */
636 ret
= adapter
->if_ops
.check_fw_status(adapter
, poll_num
, NULL
);
638 dev_err(adapter
->dev
, "FW failed to be active in time\n");
642 /* re-enable host interrupt for mwifiex after fw dnld is successful */
643 adapter
->if_ops
.enable_int(adapter
);