| /* |
| * Copyright (c) 2012-2013, The Linux Foundation. All rights reserved. |
| * |
| * Previously licensed under the ISC license by Qualcomm Atheros, Inc. |
| * |
| * |
| * Permission to use, copy, modify, and/or distribute this software for |
| * any purpose with or without fee is hereby granted, provided that the |
| * above copyright notice and this permission notice appear in all |
| * copies. |
| * |
| * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL |
| * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED |
| * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE |
| * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL |
| * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR |
| * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER |
| * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR |
| * PERFORMANCE OF THIS SOFTWARE. |
| */ |
| /* |
| * Copyright (c) 2012, The Linux Foundation. All rights reserved. |
| * |
| * Previously licensed under the ISC license by Qualcomm Atheros, Inc. |
| * |
| * |
| * Permission to use, copy, modify, and/or distribute this software for |
| * any purpose with or without fee is hereby granted, provided that the |
| * above copyright notice and this permission notice appear in all |
| * copies. |
| * |
| * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL |
| * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED |
| * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE |
| * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL |
| * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR |
| * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER |
| * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR |
| * PERFORMANCE OF THIS SOFTWARE. |
| */ |
| |
| /*=========================================================================== |
| |
| |
| W L A N _ Q C T _ WDA _ DS . C |
| |
| OVERVIEW: |
| |
| This software unit holds the implementation of WLAN Data Abtraction APIs |
| for the WLAN Transport Layer. |
| |
| DEPENDENCIES: |
| |
| Are listed for each API below. |
| |
| |
| Copyright (c) 2010-2011 QUALCOMM Incorporated. |
| All Rights Reserved. |
| Qualcomm Confidential and Proprietary |
| ===========================================================================*/ |
| |
| /*=========================================================================== |
| |
| EDIT HISTORY FOR FILE |
| |
| |
| This section contains comments describing changes made to the module. |
| Notice that changes are listed in reverse chronological order. |
| |
| |
| $Header:$ $DateTime: $ $Author: $ |
| |
| |
| when who what, where, why |
| -------- --- ---------------------------------------------- |
| 12/08/2010 seokyoun Created. Move down HAL interfaces from TL to WDA |
| for UMAC convergence btween Volans/Libra and Prima |
| =========================================================================== */ |
| |
| #include "wlan_qct_wda.h" |
| #include "wlan_qct_tl.h" |
| #include "wlan_qct_tli.h" |
| #include "tlDebug.h" |
| #if defined( FEATURE_WLAN_NON_INTEGRATED_SOC ) |
| #include "wlan_bal_misc.h" |
| #endif |
| |
| #define WDA_DS_DXE_RES_COUNT (WDA_TLI_MIN_RES_DATA + 20) |
| |
| #define VOS_TO_WPAL_PKT(_vos_pkt) ((wpt_packet*)_vos_pkt) |
| |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| #define WDA_HI_FLOW_MASK 0xF0 |
| #define WDA_LO_FLOW_MASK 0x0F |
| |
| static v_VOID_t |
| WDA_DS_TxCompleteCB |
| ( |
| v_PVOID_t pvosGCtx, |
| v_PVOID_t pFrameDataBuff |
| ); |
| #endif |
| |
| #if defined( FEATURE_WLAN_NON_INTEGRATED_SOC ) |
| /*========================================================================== |
| FUNCTION WDA_DS_PrepareBDHeader |
| |
| DESCRIPTION |
| Inline function for preparing BD header before HAL processing. |
| |
| DEPENDENCIES |
| Just notify HAL that suspend in TL is complete. |
| |
| PARAMETERS |
| |
| IN |
| vosDataBuff: vos data buffer |
| ucDisableFrmXtl: is frame xtl disabled |
| |
| OUT |
| ppvBDHeader: it will contain the BD header |
| pvDestMacAddr: it will contain the destination MAC address |
| pvosStatus: status of the combined processing |
| pusPktLen: packet len. |
| |
| RETURN VALUE |
| No return. |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| void |
| WDA_DS_PrepareBDHeader |
| ( |
| vos_pkt_t* vosDataBuff, |
| v_PVOID_t* ppvBDHeader, |
| v_MACADDR_t* pvDestMacAddr, |
| v_U8_t ucDisableFrmXtl, |
| VOS_STATUS* pvosStatus, |
| v_U16_t* pusPktLen, |
| v_U8_t ucQosEnabled, |
| v_U8_t ucWDSEnabled, |
| v_U8_t extraHeadSpace |
| ) |
| { |
| v_U8_t ucHeaderOffset; |
| v_U8_t ucHeaderLen; |
| #ifndef WLAN_SOFTAP_FEATURE |
| v_PVOID_t pvPeekData; |
| #endif |
| v_U8_t ucBDHeaderLen = WLANTL_BD_HEADER_LEN(ucDisableFrmXtl); |
| |
| /*- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ |
| /*------------------------------------------------------------------------- |
| Get header pointer from VOSS |
| !!! make sure reserve head zeros out the memory |
| -------------------------------------------------------------------------*/ |
| vos_pkt_get_packet_length( vosDataBuff, pusPktLen); |
| |
| if ( WLANTL_MAC_HEADER_LEN(ucDisableFrmXtl) > *pusPktLen ) |
| { |
| TLLOGE(VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL: Length of the packet smaller than expected network" |
| " header %d", *pusPktLen )); |
| |
| *pvosStatus = VOS_STATUS_E_INVAL; |
| return; |
| } |
| |
| vos_pkt_reserve_head( vosDataBuff, ppvBDHeader, |
| ucBDHeaderLen ); |
| if ( NULL == *ppvBDHeader ) |
| { |
| TLLOGE(VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:VOSS packet corrupted on Attach BD header")); |
| *pvosStatus = VOS_STATUS_E_INVAL; |
| return; |
| } |
| |
| /*----------------------------------------------------------------------- |
| Extract MAC address |
| -----------------------------------------------------------------------*/ |
| #ifdef WLAN_SOFTAP_FEATURE |
| { |
| v_SIZE_t usMacAddrSize = VOS_MAC_ADDR_SIZE; |
| *pvosStatus = vos_pkt_extract_data( vosDataBuff, |
| ucBDHeaderLen + |
| WLANTL_MAC_ADDR_ALIGN(ucDisableFrmXtl), |
| (v_PVOID_t)pvDestMacAddr, |
| &usMacAddrSize ); |
| } |
| #else |
| *pvosStatus = vos_pkt_peek_data( vosDataBuff, |
| ucBDHeaderLen + |
| WLANTL_MAC_ADDR_ALIGN(ucDisableFrmXtl), |
| (v_PVOID_t)&pvPeekData, |
| VOS_MAC_ADDR_SIZE ); |
| |
| /*Fix me*/ |
| vos_copy_macaddr(pvDestMacAddr, (v_MACADDR_t*)pvPeekData); |
| #endif |
| if ( VOS_STATUS_SUCCESS != *pvosStatus ) |
| { |
| TLLOGE(VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:Failed while attempting to extract MAC Addr %d", |
| *pvosStatus)); |
| } |
| else |
| { |
| /*--------------------------------------------------------------------- |
| Fill MPDU info fields: |
| - MPDU data start offset |
| - MPDU header start offset |
| - MPDU header length |
| - MPDU length - this is a 16b field - needs swapping |
| --------------------------------------------------------------------*/ |
| ucHeaderOffset = ucBDHeaderLen; |
| ucHeaderLen = WLANTL_MAC_HEADER_LEN(ucDisableFrmXtl); |
| |
| if ( 0 != ucDisableFrmXtl ) |
| { |
| if ( 0 != ucQosEnabled ) |
| { |
| ucHeaderLen += WLANTL_802_11_HEADER_QOS_CTL; |
| } |
| |
| // Similar to Qos we need something for WDS format ! |
| if ( ucWDSEnabled != 0 ) |
| { |
| // If we have frame translation enabled |
| ucHeaderLen += WLANTL_802_11_HEADER_ADDR4_LEN; |
| } |
| if ( extraHeadSpace != 0 ) |
| { |
| // Decrease the packet length with the extra padding after the header |
| *pusPktLen = *pusPktLen - extraHeadSpace; |
| } |
| } |
| |
| WLANHAL_TX_BD_SET_MPDU_HEADER_LEN( *ppvBDHeader, ucHeaderLen); |
| WLANHAL_TX_BD_SET_MPDU_HEADER_OFFSET( *ppvBDHeader, ucHeaderOffset); |
| WLANHAL_TX_BD_SET_MPDU_DATA_OFFSET( *ppvBDHeader, |
| ucHeaderOffset + ucHeaderLen + extraHeadSpace); |
| WLANHAL_TX_BD_SET_MPDU_LEN( *ppvBDHeader, *pusPktLen); |
| |
| TLLOG2(VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_HIGH, |
| "WLAN TL: VALUES ARE HLen=%x Hoff=%x doff=%x len=%x ex=%d", |
| ucHeaderLen, ucHeaderOffset, |
| (ucHeaderOffset + ucHeaderLen + extraHeadSpace), |
| *pusPktLen, extraHeadSpace)); |
| }/* if peek MAC success*/ |
| |
| }/* WLANTL_PrepareBDHeader */ |
| #endif /* FEATURE_WLAN_NON_INTEGRATED_SOC */ |
| |
| #ifdef WLAN_PERF |
| /*========================================================================== |
| FUNCTION WDA_TLI_FastHwFwdDataFrame |
| |
| DESCRIPTION |
| For NON integrated SOC, this function is called by TL. |
| |
| Fast path function to quickly forward a data frame if HAL determines BD |
| signature computed here matches the signature inside current VOSS packet. |
| If there is a match, HAL and TL fills in the swapped packet length into |
| BD header and DxE header, respectively. Otherwise, packet goes back to |
| normal (slow) path and a new BD signature would be tagged into BD in this |
| VOSS packet later by the WLANHAL_FillTxBd() function. |
| |
| TODO For integrated SOC, this function does nothing yet. Pima SLM/HAL |
| should provide the equivelant functionality. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| vosDataBuff Ptr to VOSS packet |
| pMetaInfo For getting frame's TID |
| pStaInfo For checking STA type |
| |
| OUT |
| pvosStatus returned status |
| puFastFwdOK Flag to indicate whether frame could be fast forwarded |
| |
| RETURN VALUE |
| No return. |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| void WDA_TLI_FastHwFwdDataFrame |
| ( |
| v_PVOID_t pvosGCtx, |
| vos_pkt_t* vosDataBuff, |
| VOS_STATUS* pvosStatus, |
| v_U32_t* puFastFwdOK, |
| WLANTL_MetaInfoType* pMetaInfo, |
| WLAN_STADescType* pStaInfo |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /* FIXME WDI/WDA should support this function |
| once HAL supports it |
| */ |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| v_PVOID_t pvPeekData; |
| v_U8_t ucDxEBDWLANHeaderLen = WLANTL_BD_HEADER_LEN(0) + sizeof(WLANBAL_sDXEHeaderType); |
| v_U8_t ucIsUnicast; |
| WLANBAL_sDXEHeaderType *pDxEHeader; |
| v_PVOID_t pvBDHeader; |
| v_PVOID_t pucBuffPtr; |
| v_U16_t usPktLen; |
| |
| /*----------------------------------------------------------------------- |
| Extract packet length |
| -----------------------------------------------------------------------*/ |
| |
| vos_pkt_get_packet_length( vosDataBuff, &usPktLen); |
| |
| /*----------------------------------------------------------------------- |
| Extract MAC address |
| -----------------------------------------------------------------------*/ |
| *pvosStatus = vos_pkt_peek_data( vosDataBuff, |
| WLANTL_MAC_ADDR_ALIGN(0), |
| (v_PVOID_t)&pvPeekData, |
| VOS_MAC_ADDR_SIZE ); |
| |
| if ( VOS_STATUS_SUCCESS != *pvosStatus ) |
| { |
| TLLOGE(VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:Failed while attempting to extract MAC Addr %d", |
| *pvosStatus)); |
| *pvosStatus = VOS_STATUS_E_INVAL; |
| return; |
| } |
| |
| /*----------------------------------------------------------------------- |
| Reserve head room for DxE header, BD, and WLAN header |
| -----------------------------------------------------------------------*/ |
| |
| vos_pkt_reserve_head( vosDataBuff, &pucBuffPtr, |
| ucDxEBDWLANHeaderLen ); |
| if ( NULL == pucBuffPtr ) |
| { |
| TLLOGE(VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:No enough space in VOSS packet %p for DxE/BD/WLAN header", vosDataBuff)); |
| *pvosStatus = VOS_STATUS_E_INVAL; |
| return; |
| } |
| pDxEHeader = (WLANBAL_sDXEHeaderType *)pucBuffPtr; |
| pvBDHeader = (v_PVOID_t) &pDxEHeader[1]; |
| |
| /* UMA Tx acceleration is enabled. |
| * UMA would help convert frames to 802.11, fill partial BD fields and |
| * construct LLC header. To further accelerate this kind of frames, |
| * HAL would attempt to reuse the BD descriptor if the BD signature |
| * matches to the saved BD descriptor. |
| */ |
| if(pStaInfo->wSTAType == WLAN_STA_IBSS) |
| ucIsUnicast = !(((tANI_U8 *)pvPeekData)[0] & 0x01); |
| else |
| ucIsUnicast = 1; |
| |
| *puFastFwdOK = (v_U32_t) WLANHAL_TxBdFastFwd(pvosGCtx, pvPeekData, pMetaInfo->ucTID, ucIsUnicast, pvBDHeader, usPktLen ); |
| |
| /* Can't be fast forwarded. Trim the VOS head back to original location. */ |
| if(! *puFastFwdOK){ |
| vos_pkt_trim_head(vosDataBuff, ucDxEBDWLANHeaderLen); |
| }else{ |
| /* could be fast forwarded. Now notify BAL DxE header filling could be completely skipped |
| */ |
| v_U32_t uPacketSize = WLANTL_BD_HEADER_LEN(0) + usPktLen; |
| vos_pkt_set_user_data_ptr( vosDataBuff, VOS_PKT_USER_DATA_ID_BAL, |
| (v_PVOID_t)uPacketSize); |
| pDxEHeader->size = SWAP_ENDIAN_UINT32(uPacketSize); |
| } |
| |
| *pvosStatus = VOS_STATUS_SUCCESS; |
| return; |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| #endif /*WLAN_PERF*/ |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_Register |
| |
| DESCRIPTION |
| Register TL client to WDA. This function registers TL RX/TX functions |
| to WDI by calling WDI_DS_Register. |
| |
| |
| For NON integrated SOC, this function calls WLANBAL_RegTlCbFunctions |
| to register TL's RX/TX functions to BAL |
| |
| TODO |
| For Prima, pfnResourceCB gets called in WDTS_OOResourceNotification. |
| The uCount parameter is AC mask. It should be redefined to use the |
| same resource callback function. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| pfnTxCompleteCallback TX complete callback upon TX completion |
| pfnRxPacketCallback RX callback |
| pfnTxPacketCallback TX callback |
| pfnResourceCB gets called when updating TX PDU number |
| uResTheshold minimum TX PDU size for a packet |
| pCallbackContext WDI calls callback function with it |
| VOS global context pointer |
| OUT |
| uAvailableTxBuf available TX PDU numbder. |
| BAL returns it for NON integrated SOC |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS WDA_DS_Register |
| ( |
| v_PVOID_t pvosGCtx, |
| WDA_DS_TxCompleteCallback pfnTxCompleteCallback, |
| WDA_DS_RxPacketCallback pfnRxPacketCallback, |
| WDA_DS_TxPacketCallback pfnTxPacketCallback, |
| WDA_DS_ResourceCB pfnResourceCB, |
| v_U32_t uResTheshold, |
| v_PVOID_t pCallbackContext, |
| v_U32_t *uAvailableTxBuf |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| tWDA_CbContext *wdaContext = NULL; |
| WDI_Status wdiStatus; |
| |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_HIGH, |
| "WLAN WDA: WDA_DS_Register" ); |
| |
| /*------------------------------------------------------------------------ |
| Sanity check |
| ------------------------------------------------------------------------*/ |
| if ( ( NULL == pvosGCtx ) || |
| ( NULL == pfnTxPacketCallback ) || |
| ( NULL == pfnTxCompleteCallback ) || |
| ( NULL == pfnRxPacketCallback ) || |
| ( NULL == pfnResourceCB) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WLAN WDA:Invalid pointers on WDA_DS_Register" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| /*------------------------------------------------------------------------ |
| Extract WDA context |
| ------------------------------------------------------------------------*/ |
| wdaContext = (tWDA_CbContext *)vos_get_context( VOS_MODULE_ID_WDA, pvosGCtx ); |
| if ( NULL == wdaContext ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WLAN WDA:Invalid wda context pointer " |
| "from pvosGCtx on WDA_DS_Register" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| /*------------------------------------------------------------------------ |
| Register with WDI as transport layer client |
| ------------------------------------------------------------------------*/ |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_HIGH, "WDA: WDA_DS_Register"); |
| |
| wdaContext->pfnTxResourceCB = pfnResourceCB; |
| wdaContext->pfnTxCompleteCallback = pfnTxCompleteCallback; |
| |
| wdiStatus = WDI_DS_Register( wdaContext->pWdiContext, |
| (WDI_DS_TxCompleteCallback)WDA_DS_TxCompleteCB, |
| (WDI_DS_RxPacketCallback)pfnRxPacketCallback, |
| WDA_DS_TxFlowControlCallback, |
| pvosGCtx ); |
| |
| if ( WDI_STATUS_SUCCESS != wdiStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:TL failed to register with DAL, Err: %d", wdiStatus ); |
| return VOS_STATUS_E_FAILURE; |
| } |
| |
| /* TODO Out-of-resource condition if PDU size is less than WLANTL_MIN_RES_MF |
| Put hardcoded value not to put TL into OOR. Revisit it */ |
| *uAvailableTxBuf = WDA_DS_DXE_RES_COUNT; |
| |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| VOS_STATUS vosStatus; |
| WLANBAL_TlRegType tlReg; |
| |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_HIGH, |
| "WLAN WDA: WDA_DS_Register" ); |
| |
| /*------------------------------------------------------------------------ |
| Sanity check |
| ------------------------------------------------------------------------*/ |
| if ( ( NULL == pvosGCtx ) || |
| ( NULL == pfnTxPacketCallback ) || |
| ( NULL == pfnTxCompleteCallback ) || |
| ( NULL == pfnRxPacketCallback ) || |
| ( NULL == pfnResourceCB ) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN WDA:Invalid pointers on WDA_DS_Register" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| /*------------------------------------------------------------------------ |
| Register with BAL as transport layer client |
| ------------------------------------------------------------------------*/ |
| tlReg.receiveFrameCB = pfnRxPacketCallback; |
| tlReg.getTXFrameCB = pfnTxPacketCallback; |
| tlReg.txCompleteCB = pfnTxCompleteCallback; |
| tlReg.txResourceCB = pfnResourceCB; |
| tlReg.txResourceThreashold = uResTheshold; |
| tlReg.tlUsrData = pvosGCtx; |
| |
| vosStatus = WLANBAL_RegTlCbFunctions( pvosGCtx, &tlReg ); |
| |
| if ( VOS_STATUS_SUCCESS != vosStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL: TL failed to register with BAL, Err: %d", vosStatus ); |
| return vosStatus; |
| } |
| |
| /*------------------------------------------------------------------------ |
| Request resources for tx from bus |
| ------------------------------------------------------------------------*/ |
| vosStatus = WLANBAL_GetTxResources( pvosGCtx, uAvailableTxBuf ); |
| |
| if ( VOS_STATUS_SUCCESS != vosStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:TL failed to get resources from BAL, Err: %d", |
| vosStatus ); |
| return vosStatus; |
| } |
| |
| return vosStatus; |
| #endif |
| } |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_StartXmit |
| |
| DESCRIPTION |
| Serialize TX transmit reques to TX thread. |
| |
| TODO This sends TX transmit request to TL. It should send to WDI for |
| abstraction. |
| |
| For NON integrated SOC, this function calls WLANBAL_StartXmit |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_StartXmit |
| ( |
| v_PVOID_t pvosGCtx |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| vos_msg_t sMessage; |
| /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */ |
| |
| if ( NULL == pvosGCtx ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN WDA:Invalid pointers on WDA_DS_StartXmit" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| /* Serialize our event */ |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_HIGH, |
| "Serializing WDA TX Start Xmit event" ); |
| |
| vos_mem_zero( &sMessage, sizeof(vos_msg_t) ); |
| |
| sMessage.bodyptr = NULL; |
| sMessage.type = WDA_DS_TX_START_XMIT; |
| |
| return vos_tx_mq_serialize(VOS_MQ_ID_TL, &sMessage); |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| return WLANBAL_StartXmit( pvosGCtx ); |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_FinishULA |
| |
| DESCRIPTION |
| Serialize Finish Upper Level Authentication reques to TX thread. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| callbackRoutine routine to be called in TX thread |
| callbackContext user data for the above routine |
| |
| RETURN VALUE |
| please see vos_tx_mq_serialize |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_FinishULA |
| ( |
| void (*callbackRoutine) (void *callbackContext), |
| void *callbackContext |
| ) |
| { |
| vos_msg_t sMessage; |
| /* - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - */ |
| |
| /* Serialize our event */ |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_HIGH, |
| "Serializing WDA_DS_FinishULA event" ); |
| |
| vos_mem_zero( &sMessage, sizeof(vos_msg_t) ); |
| |
| sMessage.bodyval = (v_U32_t)callbackContext; |
| sMessage.bodyptr = callbackRoutine; |
| sMessage.type = WDA_DS_FINISH_ULA; |
| |
| return vos_tx_mq_serialize(VOS_MQ_ID_TL, &sMessage); |
| }/*WDA_DS_FinishULA*/ |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_BuildTxPacketInfo |
| |
| DESCRIPTION |
| Build TX meta info for integrated SOC. |
| |
| Same function calls HAL for reserve BD header space into VOS packet and |
| HAL function to fill it. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| vosDataBuff vos data buffer |
| pvDestMacAddr destination MAC address ponter |
| ucDisableFrmXtl Is frame xtl disabled? |
| ucQosEnabled Is QoS enabled? |
| ucWDSEnabled Is WDS enabled? |
| extraHeadSpace Extra head bytes. If it's not 0 due to 4 bytes align |
| of BD header. |
| typeSubtype typeSubtype from MAC header or TX metainfo/BD |
| pAddr2 address 2 |
| uTid tid |
| txFlag |
| timeStamp |
| ucIsEapol |
| ucUP |
| |
| OUT |
| *pusPktLen Packet length |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_BuildTxPacketInfo |
| ( |
| v_PVOID_t pvosGCtx, |
| vos_pkt_t* vosDataBuff, |
| v_MACADDR_t* pvDestMacAddr, |
| v_U8_t ucDisableFrmXtl, |
| v_U16_t* pusPktLen, |
| v_U8_t ucQosEnabled, |
| v_U8_t ucWDSEnabled, |
| v_U8_t extraHeadSpace, |
| v_U8_t typeSubtype, |
| v_PVOID_t pAddr2, |
| v_U8_t uTid, |
| v_U8_t txFlag, |
| v_U32_t timeStamp, |
| v_U8_t ucIsEapol, |
| v_U8_t ucUP |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| VOS_STATUS vosStatus; |
| WDI_DS_TxMetaInfoType* pTxMetaInfo = NULL; |
| v_SIZE_t usMacAddrSize; |
| /*- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ |
| |
| /*------------------------------------------------------------------------ |
| Sanity check |
| Extract TL control block |
| ------------------------------------------------------------------------*/ |
| if ( ( NULL == pvosGCtx ) || ( NULL == vosDataBuff ) || ( NULL == pvDestMacAddr ) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA:Invalid parameter sent on WDA_DS_BuildTxPacketInfo" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| /*------------------------------------------------------------------------ |
| Extract TX Meta Info pointer from PAL packet |
| ------------------------------------------------------------------------*/ |
| pTxMetaInfo = WDI_DS_ExtractTxMetaData( VOS_TO_WPAL_PKT(vosDataBuff) ); |
| if ( NULL == pTxMetaInfo ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:Invalid RxMetaInfo pointer from PAL packet on WLANTL_RxFrames"); |
| VOS_ASSERT( 0 ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| /* Zero out memeory */ |
| vos_mem_zero( pTxMetaInfo, sizeof( WDI_DS_TxMetaInfoType ) ); |
| |
| /* Fill the TX Meta info */ |
| pTxMetaInfo->txFlags = txFlag; |
| pTxMetaInfo->qosEnabled = ucQosEnabled; |
| pTxMetaInfo->fenableWDS = ucWDSEnabled; |
| pTxMetaInfo->ac = ucUP; |
| pTxMetaInfo->fUP = uTid; |
| pTxMetaInfo->isEapol = ucIsEapol; |
| pTxMetaInfo->fdisableFrmXlt = ucDisableFrmXtl; |
| pTxMetaInfo->frmType = ( ( typeSubtype & 0x30 ) >> 4 ); |
| pTxMetaInfo->typeSubtype = typeSubtype; |
| |
| /* Length = MAC header + payload */ |
| vos_pkt_get_packet_length( vosDataBuff, pusPktLen); |
| pTxMetaInfo->fPktlen = *pusPktLen; |
| |
| // Dst address |
| usMacAddrSize = VOS_MAC_ADDR_SIZE; |
| vosStatus = vos_pkt_extract_data( vosDataBuff, |
| WLANTL_MAC_ADDR_ALIGN( ucDisableFrmXtl ), |
| (v_PVOID_t)pvDestMacAddr, |
| &usMacAddrSize ); |
| if ( VOS_STATUS_SUCCESS != vosStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WDA:Failed while attempting to extract MAC Addr %d", |
| vosStatus ); |
| VOS_ASSERT( 0 ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| VOS_ASSERT(usMacAddrSize == VOS_MAC_ADDR_SIZE); |
| |
| vos_copy_macaddr( (v_MACADDR_t*)pTxMetaInfo->fSTAMACAddress, pvDestMacAddr ); |
| |
| // ADDR2 |
| vos_copy_macaddr( (v_MACADDR_t*)pTxMetaInfo->addr2MACAddress, pAddr2 ); |
| |
| /* Dump TX meta infro for debugging */ |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_LOW, |
| "WLAN TL: Dump TX meta info: " |
| "txFlags:%d, qosEnabled:%d, ac:%d, " |
| "isEapol:%d, fdisableFrmXlt:%d" "frmType%d", |
| pTxMetaInfo->txFlags, ucQosEnabled, pTxMetaInfo->ac, |
| pTxMetaInfo->isEapol, pTxMetaInfo->fdisableFrmXlt, pTxMetaInfo->frmType ); |
| |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| VOS_STATUS vosStatus; |
| v_PVOID_t pvBDHeader; |
| |
| WDA_DS_PrepareBDHeader( vosDataBuff, &pvBDHeader, pvDestMacAddr, ucDisableFrmXtl, |
| &vosStatus, pusPktLen, ucQosEnabled, ucWDSEnabled, extraHeadSpace ); |
| |
| if ( VOS_STATUS_SUCCESS != vosStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:Failed while attempting to prepare BD %d", vosStatus ); |
| return vosStatus; |
| } |
| |
| vosStatus = WLANHAL_FillTxBd( pvosGCtx, typeSubtype, pvDestMacAddr, pAddr2, |
| &uTid, ucDisableFrmXtl, pvBDHeader, txFlag, timeStamp ); |
| |
| if ( VOS_STATUS_SUCCESS != vosStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL:Failed while attempting to fill BD %d", vosStatus ); |
| return vosStatus; |
| } |
| |
| return VOS_STATUS_SUCCESS; |
| |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| |
| /*========================================================================== |
| FUNCTION WDS_DS_TrimRxPacketInfo |
| |
| DESCRIPTION |
| Trim/Remove RX BD header for NON integrated SOC. |
| It does nothing for integrated SOC. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| vosDataBuff vos data buffer |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_TrimRxPacketInfo |
| ( |
| vos_pkt_t *vosDataBuff |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /* Nothing to trim |
| * Do Nothing */ |
| |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| VOS_STATUS vosStatus = VOS_STATUS_SUCCESS; |
| v_U16_t usPktLen; |
| v_U8_t ucMPDUHOffset; |
| v_U16_t usMPDUDOffset; |
| v_U16_t usMPDULen; |
| v_U8_t ucMPDUHLen = 0; |
| v_U8_t aucBDHeader[WLANHAL_RX_BD_HEADER_SIZE]; |
| |
| vos_pkt_pop_head( vosDataBuff, aucBDHeader, WLANHAL_RX_BD_HEADER_SIZE); |
| |
| ucMPDUHOffset = (v_U8_t)WLANHAL_RX_BD_GET_MPDU_H_OFFSET(aucBDHeader); |
| usMPDUDOffset = (v_U16_t)WLANHAL_RX_BD_GET_MPDU_D_OFFSET(aucBDHeader); |
| usMPDULen = (v_U16_t)WLANHAL_RX_BD_GET_MPDU_LEN(aucBDHeader); |
| ucMPDUHLen = (v_U8_t)WLANHAL_RX_BD_GET_MPDU_H_LEN(aucBDHeader); |
| |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_INFO_HIGH, |
| "WLAN TL:BD header processing data: HO %d DO %d Len %d HLen %d" |
| " Tid %d BD %d", |
| ucMPDUHOffset, usMPDUDOffset, usMPDULen, ucMPDUHLen, |
| WLANHAL_RX_BD_HEADER_SIZE ); |
| |
| vos_pkt_get_packet_length( vosDataBuff, &usPktLen); |
| |
| if (( ucMPDUHOffset >= WLANHAL_RX_BD_HEADER_SIZE ) && |
| ( usMPDUDOffset > ucMPDUHOffset ) && |
| ( usMPDULen >= ucMPDUHLen ) && |
| ( usPktLen >= usMPDULen )) |
| { |
| if((ucMPDUHOffset - WLANHAL_RX_BD_HEADER_SIZE) > 0) |
| { |
| vos_pkt_trim_head( vosDataBuff, ucMPDUHOffset - WLANHAL_RX_BD_HEADER_SIZE); |
| } |
| else |
| { |
| /* Nothing to trim |
| * Do Nothing */ |
| } |
| vosStatus = VOS_STATUS_SUCCESS; |
| } |
| else |
| { |
| vosStatus = VOS_STATUS_E_FAILURE; |
| } |
| |
| return vosStatus; |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_PeekRxPacketInfo |
| |
| DESCRIPTION |
| Return RX metainfo pointer for for integrated SOC. |
| |
| Same function will return BD header pointer. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| vosDataBuff vos data buffer |
| |
| pvDestMacAddr destination MAC address ponter |
| bSwap Want to swap BD header? For backward compatability |
| It does nothing for integrated SOC |
| OUT |
| *ppRxHeader RX metainfo pointer |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_PeekRxPacketInfo |
| ( |
| vos_pkt_t *vosDataBuff, |
| v_PVOID_t *ppRxHeader, |
| v_BOOL_t bSwap |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /*------------------------------------------------------------------------ |
| Sanity check |
| ------------------------------------------------------------------------*/ |
| if ( NULL == vosDataBuff ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA:Invalid parameter sent on WDA_DS_PeekRxPacketInfo" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| *ppRxHeader = WDI_DS_ExtractRxMetaData( (wpt_packet*)vosDataBuff ); |
| |
| if ( NULL == *ppRxHeader ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA:Failed to get RX meta data from WDI" ); |
| return VOS_STATUS_E_FAILURE; |
| } |
| |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| VOS_STATUS vosStatus; |
| |
| vosStatus = vos_pkt_peek_data( vosDataBuff, 0, (v_PVOID_t)ppRxHeader, |
| WLANHAL_RX_BD_HEADER_SIZE); |
| |
| if ( ( VOS_STATUS_SUCCESS != vosStatus ) || ( NULL == (v_PVOID_t)ppRxHeader ) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WDA :Cannot extract BD header" ); |
| return VOS_STATUS_E_FAILURE; |
| } |
| |
| if ( VOS_TRUE == bSwap ) |
| { |
| WLANHAL_SwapRxBd( *ppRxHeader ); |
| } |
| |
| return VOS_STATUS_SUCCESS; |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_GetFrameTypeSubType |
| |
| DESCRIPTION |
| Get typeSubtype from the packet. The BD header should have this. |
| But some reason, Libra/Volans read it from 802.11 header and save it |
| back to BD header. So for NON integrated SOC, this function does |
| the same. |
| |
| For integrated SOC, WDI does the same, not TL. |
| It does return typeSubtype from RX meta info for integrated SOC. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| vosDataBuff vos data buffer |
| pRxHeader RX meta info or BD header pointer |
| |
| OUT |
| ucTypeSubtype typeSubtype |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_GetFrameTypeSubType |
| ( |
| v_PVOID_t pvosGCtx, |
| vos_pkt_t *vosDataBuff, |
| v_PVOID_t pRxHeader, |
| v_U8_t *ucTypeSubtype |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /*------------------------------------------------------------------------ |
| Sanity check |
| ------------------------------------------------------------------------*/ |
| if ( NULL == pRxHeader ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA:Invalid parameter sent on WDA_DS_GetFrameTypeSubType" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| *ucTypeSubtype = ( WDA_GET_RX_TYPE( pRxHeader ) << 4 ) | WDA_GET_RX_SUBTYPE( pRxHeader ); |
| |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| v_PVOID_t pvBDHeader = pRxHeader; |
| v_U16_t usFrmCtrl = 0; |
| v_U8_t ucFrmType; |
| v_SIZE_t usFrmCtrlSize = sizeof(usFrmCtrl); |
| VOS_STATUS vosStatus; |
| |
| /*--------------------------------------------------------------------- |
| Extract frame control field from 802.11 header if present |
| (frame translation not done) |
| ---------------------------------------------------------------------*/ |
| vosStatus = vos_pkt_extract_data( vosDataBuff, |
| ( 0 == WLANHAL_RX_BD_GET_FT(pvBDHeader) ) ? |
| WLANHAL_RX_BD_GET_MPDU_H_OFFSET(pvBDHeader): |
| WLANHAL_RX_BD_HEADER_SIZE, |
| &usFrmCtrl, &usFrmCtrlSize ); |
| |
| if (( VOS_STATUS_SUCCESS != vosStatus ) || |
| ( sizeof(usFrmCtrl) != usFrmCtrlSize )) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WLAN TL: Cannot extract Frame Control Field" ); |
| return VOS_STATUS_E_FAILURE; |
| } |
| |
| |
| ucFrmType = (v_U8_t)WLANHAL_RxBD_GetFrameTypeSubType( pvBDHeader, |
| usFrmCtrl); |
| WLANHAL_RX_BD_SET_TYPE_SUBTYPE(pvBDHeader, ucFrmType); |
| |
| *ucTypeSubtype = ucFrmType; |
| |
| return VOS_STATUS_SUCCESS; |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_RxAmsduBdFix |
| |
| DESCRIPTION |
| For backward compatability with Libra/Volans. Need to call HAL function |
| for HW BD bug fix |
| |
| It does nothing for integrated SOC. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| pvBDHeader BD header pointer |
| |
| OUT |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_RxAmsduBdFix |
| ( |
| v_PVOID_t pvosGCtx, |
| v_PVOID_t pvBDHeader |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /* Do nothing for Prima */ |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| /* AMSDU HW bug fix |
| * After 2nd AMSDU subframe HW could not handle BD correctly |
| * HAL workaround is needed */ |
| WLANHAL_RxAmsduBdFix(pvosGCtx, pvBDHeader); |
| return VOS_STATUS_SUCCESS; |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_GetRssi |
| |
| DESCRIPTION |
| Get RSSI |
| |
| TODO It returns hardcoded value in the meantime since WDA/WDI does nothing |
| support it yet for Prima. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| vosDataBuff vos data buffer |
| |
| OUT |
| puRssi RSSI |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_GetRssi |
| ( |
| v_PVOID_t pvosGCtx, |
| v_S7_t* puRssi |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WDA:halPS_GetRssi no longer supported. Need replacement"); |
| |
| *puRssi = -30; |
| |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| halPS_GetRssi(vos_get_context(VOS_MODULE_ID_SME, pvosGCtx), puRssi); |
| return VOS_STATUS_SUCCESS; |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_GetTxResources |
| |
| DESCRIPTION |
| It does return hardcoded value. It should bigger number than 0. |
| Returning 0 will put TL in out-of-resource condition for TX. |
| |
| Return current PDU resources from BAL for NON integrated SOC. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| vosDataBuff vos data buffer |
| |
| OUT |
| puResCount available PDU number for TX |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_GetTxResources |
| ( |
| v_PVOID_t pvosGCtx, |
| v_U32_t* puResCount |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /* Return minimum necessary number of packet(DXE descriptor) for data */ |
| /* TODO Need to get this from DXE??? */ |
| *puResCount = WDA_TLI_BD_PDU_RESERVE_THRESHOLD + 50; |
| return VOS_STATUS_SUCCESS; |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| return WLANBAL_GetTxResources( pvosGCtx, puResCount ); |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_GetReplayCounter |
| |
| DESCRIPTION |
| Return replay counter from BD header or RX meta info |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pRxHeader RX meta info or BD header pointer |
| |
| OUT |
| |
| RETURN VALUE |
| Replay Counter |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| v_U64_t |
| WDA_DS_GetReplayCounter |
| ( |
| v_PVOID_t pRxHeader |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| return WDA_GET_RX_REPLAY_COUNT( pRxHeader ); |
| #else /* FEATURE_WLAN_INTEGRATED_SOC */ |
| v_U8_t *pucRxBDHeader = pRxHeader; |
| |
| /* 48-bit replay counter is created as follows |
| from RX BD 6 byte PMI command: |
| Addr : AES/TKIP |
| 0x38 : pn3/tsc3 |
| 0x39 : pn2/tsc2 |
| 0x3a : pn1/tsc1 |
| 0x3b : pn0/tsc0 |
| |
| 0x3c : pn5/tsc5 |
| 0x3d : pn4/tsc4 */ |
| |
| #ifdef ANI_BIG_BYTE_ENDIAN |
| v_U64_t ullcurrentReplayCounter = 0; |
| /* Getting 48-bit replay counter from the RX BD */ |
| ullcurrentReplayCounter = WLANHAL_RX_BD_GET_PMICMD_20TO23(pucRxBDHeader); |
| ullcurrentReplayCounter <<= 16; |
| ullcurrentReplayCounter |= (( WLANHAL_RX_BD_GET_PMICMD_24TO25(pucRxBDHeader) & 0xFFFF0000) >> 16); |
| return ullcurrentReplayCounter; |
| #else |
| v_U64_t ullcurrentReplayCounter = 0; |
| /* Getting 48-bit replay counter from the RX BD */ |
| ullcurrentReplayCounter = (WLANHAL_RX_BD_GET_PMICMD_24TO25(pucRxBDHeader) & 0x0000FFFF); |
| ullcurrentReplayCounter <<= 32; |
| ullcurrentReplayCounter |= WLANHAL_RX_BD_GET_PMICMD_20TO23(pucRxBDHeader); |
| return ullcurrentReplayCounter; |
| #endif |
| |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /*========================================================================== |
| FUNCTION WDA_DS_TxFrames |
| |
| DESCRIPTION |
| Pull packets from TL and push them to WDI. It gets invoked upon |
| WDA_DS_TX_START_XMIT. |
| |
| This function is equivelant of WLANSSC_Transmit in Libra/Volans. |
| |
| TODO |
| This function should be implemented and moved in WDI. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| |
| OUT |
| |
| RETURN VALUE |
| VOS_STATUS_E_FAULT: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| |
| VOS_STATUS |
| WDA_DS_TxFrames |
| ( |
| v_PVOID_t pvosGCtx |
| ) |
| { |
| VOS_STATUS vosStatus; |
| vos_pkt_t *pTxMgmtChain = NULL; |
| vos_pkt_t *pTxDataChain = NULL; |
| vos_pkt_t *pTxPacket = NULL; |
| v_BOOL_t bUrgent; |
| wpt_uint32 ucTxResReq; |
| WDI_Status wdiStatus; |
| tWDA_CbContext *wdaContext = NULL; |
| v_U32_t uMgmtAvailRes; |
| v_U32_t uDataAvailRes; |
| WLANTL_TxCompCBType pfnTxComp = NULL; |
| |
| wdaContext = (tWDA_CbContext *)vos_get_context(VOS_MODULE_ID_WDA, pvosGCtx); |
| if ( NULL == wdaContext ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA:Invalid wda context pointer from pvosGCtx on WDA_DS_TxFrames" ); |
| return VOS_STATUS_E_FAULT; |
| } |
| |
| /*------------------------------------------------------------------------- |
| Need to fetch separatelly for Mgmt and Data frames because TL is not |
| aware of separate resource management at the lower levels |
| -------------------------------------------------------------------------*/ |
| /*Mgmt tx*/ |
| uMgmtAvailRes = WDI_GetAvailableResCount(wdaContext->pWdiContext, |
| WDI_MGMT_POOL_ID); |
| |
| ucTxResReq = WLANTL_GetFrames( pvosGCtx, |
| &pTxMgmtChain, |
| uMgmtAvailRes, |
| (wdaContext->uTxFlowMask & WDA_HI_FLOW_MASK), |
| &bUrgent ); |
| |
| // We need to initialize vsoStatus in case we don't enter the "while" |
| // loop. If we don't enter the loop, it means that there are no packets, |
| // available, and that is considered success. If we enter the loop, |
| // vosStatus will be set appropriately inside the loop |
| vosStatus = VOS_STATUS_SUCCESS; |
| |
| while ( NULL != pTxMgmtChain ) |
| { |
| /* Walk the chain and unchain the packet */ |
| pTxPacket = pTxMgmtChain; |
| vosStatus = vos_pkt_walk_packet_chain( pTxMgmtChain, &pTxMgmtChain, VOS_TRUE ); |
| |
| if( (VOS_STATUS_SUCCESS != vosStatus) && |
| (VOS_STATUS_E_EMPTY != vosStatus) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA Walking packet chain returned status : %d", vosStatus ); |
| VOS_ASSERT( 0 ); |
| vosStatus = VOS_STATUS_E_FAILURE; |
| break; |
| } |
| |
| if ( VOS_STATUS_E_EMPTY == vosStatus ) |
| { |
| vosStatus = VOS_STATUS_SUCCESS; |
| } |
| |
| wdiStatus = WDI_DS_TxPacket( wdaContext->pWdiContext, |
| (wpt_packet*)pTxPacket, |
| 0 /* more */ ); |
| if ( WDI_STATUS_SUCCESS != wdiStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WDA : Pushing a packet to WDI failed."); |
| VOS_ASSERT( wdiStatus != WDI_STATUS_E_NOT_ALLOWED ); |
| //We need to free the packet here |
| vos_pkt_get_user_data_ptr(pTxPacket, VOS_PKT_USER_DATA_ID_TL, (void **)&pfnTxComp); |
| if(pfnTxComp) |
| { |
| pfnTxComp(pvosGCtx, pTxPacket, VOS_STATUS_E_FAILURE); |
| } |
| } |
| |
| }; |
| |
| /*Data tx*/ |
| uDataAvailRes = WDI_GetAvailableResCount(wdaContext->pWdiContext, |
| WDI_DATA_POOL_ID); |
| |
| ucTxResReq = WLANTL_GetFrames( pvosGCtx, |
| &pTxDataChain, |
| /*WDA_DS_DXE_RES_COUNT*/ uDataAvailRes, |
| (wdaContext->uTxFlowMask & WDA_LO_FLOW_MASK), |
| &bUrgent ); |
| |
| // We need to initialize vsoStatus in case we don't enter the "while" |
| // loop. If we don't enter the loop, it means that there are no packets, |
| // available, and that is considered success. If we enter the loop, |
| // vosStatus will be set appropriately inside the loop |
| vosStatus = VOS_STATUS_SUCCESS; |
| |
| while ( NULL != pTxDataChain ) |
| { |
| /* Walk the chain and unchain the packet */ |
| pTxPacket = pTxDataChain; |
| vosStatus = vos_pkt_walk_packet_chain( pTxDataChain, &pTxDataChain, VOS_TRUE ); |
| |
| if( (VOS_STATUS_SUCCESS != vosStatus) && |
| (VOS_STATUS_E_EMPTY != vosStatus) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA Walking packet chain returned status : %d", vosStatus ); |
| VOS_ASSERT( 0 ); |
| vosStatus = VOS_STATUS_E_FAILURE; |
| break; |
| } |
| |
| if ( VOS_STATUS_E_EMPTY == vosStatus ) |
| { |
| vosStatus = VOS_STATUS_SUCCESS; |
| } |
| |
| wdiStatus = WDI_DS_TxPacket( wdaContext->pWdiContext, |
| (wpt_packet*)pTxPacket, |
| 0 /* more */ ); |
| if ( WDI_STATUS_SUCCESS != wdiStatus ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_TL, VOS_TRACE_LEVEL_ERROR, |
| "WDA : Pushing a packet to WDI failed."); |
| VOS_ASSERT( wdiStatus != WDI_STATUS_E_NOT_ALLOWED ); |
| //We need to free the packet here |
| vos_pkt_get_user_data_ptr(pTxPacket, VOS_PKT_USER_DATA_ID_TL, (void **)&pfnTxComp); |
| if(pfnTxComp) |
| { |
| pfnTxComp(pvosGCtx, pTxPacket, VOS_STATUS_E_FAILURE); |
| } |
| } |
| |
| }; |
| |
| WDI_DS_TxComplete(wdaContext->pWdiContext, ucTxResReq); |
| |
| return vosStatus; |
| } |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| /*========================================================================== |
| FUNCTION WDA_DS_TxFlowControlCallback |
| |
| DESCRIPTION |
| Invoked by WDI to control TX flow. |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| uFlowMask TX channel mask for flow control |
| Defined in WDA_TXFlowEnumType |
| |
| OUT |
| |
| RETURN VALUE |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| v_VOID_t |
| WDA_DS_TxFlowControlCallback |
| ( |
| v_PVOID_t pvosGCtx, |
| v_U8_t ucFlowMask |
| ) |
| { |
| tWDA_CbContext* wdaContext = NULL; |
| v_U8_t ucOldFlowMask; |
| /*- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ |
| |
| /*------------------------------------------------------------------------ |
| Sanity check |
| ------------------------------------------------------------------------*/ |
| if ( NULL == pvosGCtx ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA: Invalid parameter sent on WDA_DS_TxFlowControlCallback" ); |
| return; |
| } |
| |
| wdaContext = (tWDA_CbContext *)vos_get_context( VOS_MODULE_ID_WDA, pvosGCtx ); |
| if ( NULL == wdaContext ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA: Invalid context on WDA_DS_TxFlowControlCallback" ); |
| return; |
| } |
| |
| /* two physical DXE channels |
| 1) data packets(all four AC) and BAP for the low priority channel(lower 4 bits) |
| 2) management packets for high priority channel(5th bit) |
| */ |
| |
| |
| /*Save and reset */ |
| ucOldFlowMask = wdaContext->uTxFlowMask; |
| wdaContext->uTxFlowMask = ucFlowMask; |
| |
| /*If the AC is being enabled - resume data xfer |
| |
| Assume previous value of wdaContext->uTxFlowMask: |
| |
| DATA\MGM | ON | OFF |
| ---------------------- |
| ON | 1F | 0F * |
| ---------------------- |
| OFF | 10 *| 00 * |
| |
| * - states in which a channel can be enabled |
| |
| ucFlowMask will tell which channel must be enabled |
| to enable a channel a new bit must be turned on => |
| ucFlowMask > wdaContext->uTxFlowMask when enable happens |
| */ |
| |
| if ( ucFlowMask > ucOldFlowMask ) |
| { |
| WDA_DS_StartXmit(pvosGCtx); |
| } |
| |
| } |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| |
| /*========================================================================== |
| FUNCTION WDA_DS_GetTxFlowMask |
| |
| DESCRIPTION |
| return TX flow mask control value |
| |
| DEPENDENCIES |
| |
| PARAMETERS |
| |
| IN |
| pvosGCtx VOS context |
| |
| OUT |
| uFlowMask TX channel mask for flow control |
| Defined in WDA_TXFlowEnumType |
| |
| RETURN VALUE |
| VOS_STATUS_E_INVAL: pointer is NULL and other errors |
| VOS_STATUS_SUCCESS: Everything is good :) |
| |
| SIDE EFFECTS |
| |
| ============================================================================*/ |
| VOS_STATUS |
| WDA_DS_GetTxFlowMask |
| ( |
| v_PVOID_t pvosGCtx, |
| v_U8_t* puFlowMask |
| ) |
| { |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| tWDA_CbContext* wdaContext = NULL; |
| /*- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ |
| |
| /*------------------------------------------------------------------------ |
| Sanity check |
| ------------------------------------------------------------------------*/ |
| if ( ( NULL == pvosGCtx ) || ( NULL == puFlowMask ) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA: Invalid parameter sent on WDA_DS_GetTxFlowMask" ); |
| return VOS_STATUS_E_INVAL; |
| } |
| |
| wdaContext = (tWDA_CbContext *)vos_get_context( VOS_MODULE_ID_WDA, pvosGCtx ); |
| if ( NULL == wdaContext ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA: Invalid context on WDA_DS_GetTxFlowMask" ); |
| return VOS_STATUS_E_INVAL; |
| } |
| |
| *puFlowMask = wdaContext->uTxFlowMask; |
| |
| return VOS_STATUS_SUCCESS; |
| #else |
| *puFlowMask = WDA_TXFLOWMASK; |
| return VOS_STATUS_SUCCESS; |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |
| } |
| |
| #if defined( FEATURE_WLAN_INTEGRATED_SOC ) |
| v_VOID_t |
| WDA_DS_TxCompleteCB |
| ( |
| v_PVOID_t pvosGCtx, |
| v_PVOID_t pFrameDataBuff |
| ) |
| { |
| tWDA_CbContext* wdaContext = NULL; |
| WDI_DS_TxMetaInfoType* pTxMetadata; |
| VOS_STATUS vosStatus; |
| /*- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -*/ |
| |
| /*------------------------------------------------------------------------ |
| Sanity check |
| ------------------------------------------------------------------------*/ |
| |
| if ( ( NULL == pvosGCtx ) || ( NULL == pFrameDataBuff ) ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA: Invalid parameter sent on WDA_DS_TxCompleteCB" ); |
| return; |
| } |
| |
| wdaContext = (tWDA_CbContext *)vos_get_context( VOS_MODULE_ID_WDA, pvosGCtx ); |
| if ( NULL == wdaContext ) |
| { |
| VOS_TRACE( VOS_MODULE_ID_WDA, VOS_TRACE_LEVEL_ERROR, |
| "WDA: Invalid context on WDA_DS_TxCompleteCB" ); |
| return; |
| } |
| |
| // extract metadata from PAL packet |
| pTxMetadata = WDI_DS_ExtractTxMetaData( (wpt_packet*)pFrameDataBuff ); |
| |
| if ( eWLAN_PAL_STATUS_SUCCESS == pTxMetadata->txCompleteStatus ) |
| vosStatus = VOS_STATUS_SUCCESS; |
| else |
| vosStatus = VOS_STATUS_E_FAILURE; |
| |
| wdaContext->pfnTxCompleteCallback( pvosGCtx, pFrameDataBuff, vosStatus ); |
| } |
| #endif /* FEATURE_WLAN_INTEGRATED_SOC */ |