/**
* @brief Shutdown firmware
*
* @param pmlan_adapter A pointer to mlan_adapter structure
*
* @return MLAN_STATUS_SUCCESS
* The firmware shutdown call succeeded.
* MLAN_STATUS_PENDING
* The firmware shutdown call is pending.
* MLAN_STATUS_FAILURE
* The firmware shutdown call failed.
*/
mlan_status
mlan_shutdown_fw(IN t_void * pmlan_adapter)
{
mlan_status ret = MLAN_STATUS_PENDING;
mlan_adapter *pmadapter = (mlan_adapter *) pmlan_adapter;
pmlan_callbacks pcb;
t_s32 i = 0;
ENTER();
MASSERT(pmlan_adapter);
/* MLAN already shutdown */
if (pmadapter->hw_status == WlanHardwareStatusNotReady) {
LEAVE();
return MLAN_STATUS_SUCCESS;
}
pmadapter->hw_status = WlanHardwareStatusClosing;
/* Wait for mlan_process to complete */
if (pmadapter->mlan_processing) {
PRINTM(MWARN, "MLAN main processing is still running\n");
LEAVE();
return ret;
}
/* Shut down MLAN */
PRINTM(MINFO, "Shutdown MLAN...\n");
/* Cancel all pending commands and complete ioctls */
wlan_cancel_all_pending_cmd(pmadapter);
/* Clean up priv structures */
for (i = 0; i < pmadapter->priv_num; i++) {
if (pmadapter->priv[i]) {
wlan_free_priv(pmadapter->priv[i]);
}
}
pcb = &pmadapter->callbacks;
if (pcb->moal_spin_lock(pmadapter->pmoal_handle, pmadapter->pmlan_lock)
!= MLAN_STATUS_SUCCESS) {
ret = MLAN_STATUS_FAILURE;
goto exit_shutdown_fw;
}
if (pcb->moal_spin_unlock(pmadapter->pmoal_handle, pmadapter->pmlan_lock)
!= MLAN_STATUS_SUCCESS) {
ret = MLAN_STATUS_FAILURE;
goto exit_shutdown_fw;
}
/* Notify completion */
ret = wlan_shutdown_fw_complete(pmadapter);
exit_shutdown_fw:
LEAVE();
return ret;
}
/**
* @brief Shutdown firmware
*
* @param pmlan_adapter A pointer to mlan_adapter structure
*
* @return MLAN_STATUS_SUCCESS
* The firmware shutdown call succeeded.
* MLAN_STATUS_PENDING
* The firmware shutdown call is pending.
* MLAN_STATUS_FAILURE
* The firmware shutdown call failed.
*/
mlan_status
mlan_shutdown_fw(IN t_void * pmlan_adapter)
{
mlan_status ret = MLAN_STATUS_PENDING;
mlan_adapter *pmadapter = (mlan_adapter *) pmlan_adapter;
pmlan_buffer pmbuf;
pmlan_callbacks pcb;
t_s32 i = 0;
ENTER();
MASSERT(pmlan_adapter);
/* MLAN already shutdown */
if (pmadapter->hw_status == WlanHardwareStatusNotReady) {
LEAVE();
return MLAN_STATUS_SUCCESS;
}
pmadapter->hw_status = WlanHardwareStatusClosing;
/* Wait for mlan_process to complete */
if (pmadapter->mlan_processing) {
PRINTM(MWARN, "MLAN main processing is still running\n");
LEAVE();
return ret;
}
/* Shut down MLAN */
PRINTM(MINFO, "Shutdown MLAN...\n");
/* Cancel all pending commands and complete ioctls */
wlan_cancel_all_pending_cmd(pmadapter);
/* Clean up priv structures */
for (i = 0; i < pmadapter->priv_num; i++) {
if (pmadapter->priv[i]) {
wlan_free_priv(pmadapter->priv[i]);
}
}
pcb = &pmadapter->callbacks;
while ((pmbuf =
(pmlan_buffer) util_dequeue_list(pmadapter->pmoal_handle,
&pmadapter->rx_data_queue,
pcb->moal_spin_lock,
pcb->moal_spin_unlock))) {
wlan_free_mlan_buffer(pmadapter, pmbuf);
}
util_scalar_write(pmadapter->pmoal_handle, &pmadapter->rx_pkts_queued,
0, pmadapter->callbacks.moal_spin_lock,
pmadapter->callbacks.moal_spin_unlock);
/* Notify completion */
ret = wlan_shutdown_fw_complete(pmadapter);
LEAVE();
return ret;
}
/**
* @brief This function frees the structure of adapter
*
* @param pmadapter A pointer to mlan_adapter structure
*
* @return N/A
*/
t_void
wlan_free_adapter(pmlan_adapter pmadapter)
{
mlan_callbacks *pcb = (mlan_callbacks *) & pmadapter->callbacks;
ENTER();
if (!pmadapter) {
PRINTM(MERROR, "The adapter is NULL\n");
LEAVE();
return;
}
wlan_cancel_all_pending_cmd(pmadapter);
/* Free command buffer */
PRINTM(MINFO, "Free Command buffer\n");
wlan_free_cmd_buffer(pmadapter);
if (pmadapter->cmd_timer_is_set) {
/* Cancel command timeout timer */
pcb->moal_stop_timer(pmadapter->pmoal_handle,
pmadapter->pmlan_cmd_timer);
pmadapter->cmd_timer_is_set = MFALSE;
}
#ifdef STA_SUPPORT
PRINTM(MINFO, "Free ScanTable\n");
if (pmadapter->pscan_table) {
pcb->moal_mfree(pmadapter->pmoal_handle,
(t_u8 *) pmadapter->pscan_table);
pmadapter->pscan_table = MNULL;
}
if (pmadapter->bcn_buf) {
pcb->moal_mfree(pmadapter->pmoal_handle, (t_u8 *) pmadapter->bcn_buf);
pmadapter->bcn_buf = MNULL;
}
#endif
wlan_11h_cleanup(pmadapter);
if (pmadapter->mp_regs_buf) {
pcb->moal_mfree(pmadapter->pmoal_handle,
(t_u8 *) pmadapter->mp_regs_buf);
pmadapter->mp_regs_buf = MNULL;
pmadapter->mp_regs = MNULL;
}
#if defined(SDIO_MULTI_PORT_TX_AGGR) || defined(SDIO_MULTI_PORT_RX_AGGR)
wlan_free_sdio_mpa_buffers(pmadapter);
#endif
wlan_free_mlan_buffer(pmadapter, pmadapter->psleep_cfm);
pmadapter->psleep_cfm = MNULL;
LEAVE();
return;
}
/**
* @brief This function frees the structure of adapter
*
* @param pmadapter A pointer to mlan_adapter structure
*
* @return N/A
*/
t_void
wlan_free_adapter(pmlan_adapter pmadapter)
{
mlan_callbacks *pcb = (mlan_callbacks *) & pmadapter->callbacks;
ENTER();
if (!pmadapter) {
PRINTM(MERROR, "The adapter is MNULL.\n");
LEAVE();
return;
}
wlan_cancel_all_pending_cmd(pmadapter);
/* Free command buffer */
PRINTM(MINFO, "Free Command buffer\n");
wlan_free_cmd_buffer(pmadapter);
util_free_list_head(&pmadapter->cmd_free_q,
pmadapter->callbacks.moal_free_lock);
util_free_list_head(&pmadapter->cmd_pending_q,
pmadapter->callbacks.moal_free_lock);
util_free_list_head(&pmadapter->scan_pending_q,
pmadapter->callbacks.moal_free_lock);
if (pmadapter->cmd_timer_is_set) {
/* Cancel command timeout timer */
pcb->moal_stop_timer(pmadapter->pmlan_cmd_timer);
pmadapter->cmd_timer_is_set = MFALSE;
}
PRINTM(MINFO, "Free ScanTable\n");
if (pmadapter->pscan_table) {
pcb->moal_mfree((t_u8 *) pmadapter->pscan_table);
pmadapter->pscan_table = MNULL;
}
if (pmadapter->mp_regs_buf) {
pcb->moal_mfree((t_u8 *) pmadapter->mp_regs_buf);
pmadapter->mp_regs_buf = MNULL;
pmadapter->mp_regs = MNULL;
}
#if defined(SDIO_MULTI_PORT_TX_AGGR) || defined(SDIO_MULTI_PORT_RX_AGGR)
wlan_free_sdio_mpa_buffers(pmadapter);
#endif
wlan_free_mlan_buffer(&pmadapter->callbacks, pmadapter->psleep_cfm);
LEAVE();
return;
}
/**
* @brief This function frees the structure of adapter
*
* @param pmadapter A pointer to mlan_adapter structure
*
* @return N/A
*/
t_void
wlan_free_adapter(pmlan_adapter pmadapter)
{
mlan_callbacks *pcb = (mlan_callbacks *) & pmadapter->callbacks;
ENTER();
if (!pmadapter) {
PRINTM(ERROR, "The adapter is MNULL.\n");
LEAVE();
return;
}
wlan_cancel_all_pending_cmd(pmadapter);
/* Free command buffer */
PRINTM(INFO, "Free Command buffer\n");
wlan_free_cmd_buffer(pmadapter);
util_free_list_head(&pmadapter->cmd_free_q,
pmadapter->callbacks.moal_free_lock);
util_free_list_head(&pmadapter->cmd_pending_q,
pmadapter->callbacks.moal_free_lock);
util_free_list_head(&pmadapter->scan_pending_q,
pmadapter->callbacks.moal_free_lock);
if (pmadapter->cmd_timer_is_set) {
/* Cancel command timeout timer */
pcb->moal_stop_timer(pmadapter->pmlan_cmd_timer);
pmadapter->cmd_timer_is_set = MFALSE;
}
if (pmadapter->hb_host_timer_is_set) {
pcb->moal_stop_timer(pmadapter->hb_host_timer);
pmadapter->hb_host_timer_is_set = MFALSE;
}
if (pmadapter->hb_dev_timer_is_set) {
pcb->moal_stop_timer(pmadapter->hb_device_timer);
pmadapter->hb_dev_timer_is_set = MFALSE;
}
PRINTM(INFO, "Free ScanTable\n");
if (pmadapter->pscan_table) {
pcb->moal_mfree((t_u8 *) pmadapter->pscan_table);
pmadapter->pscan_table = MNULL;
}
LEAVE();
return;
}