/*--------------------------------------------------------------------------- wpalPacketSetRxLength – Set the valid data length on a RX packet. This function must be called once per RX packet per receiving. It indicates the available data length from the start of the buffer. Param: pPkt - pointer to a wpt_packet. Return: NULL - fail. Otherwise the address of the starting of the buffer ---------------------------------------------------------------------------*/ wpt_status wpalPacketSetRxLength(wpt_packet *pPkt, wpt_uint32 len) { // Validate the parameter pointers if (unlikely(NULL == pPkt)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL packet pointer", __func__); return eWLAN_PAL_STATUS_E_INVAL; } /*Only allowed for RX Raw packets */ if( (eWLAN_PAL_PKT_TYPE_RX_RAW != WPAL_PACKET_GET_TYPE(pPkt))) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s Invalid packet type(%d)", __func__, WPAL_PACKET_GET_TYPE(pPkt)); return eWLAN_PAL_STATUS_E_INVAL; } if(VOS_IS_STATUS_SUCCESS(vos_pkt_set_rx_length(WPAL_TO_VOS_PKT(pPkt), len))) { return eWLAN_PAL_STATUS_SUCCESS; } else { return eWLAN_PAL_STATUS_E_INVAL; } }/*wpalPacketSetRxLength*/
/*--------------------------------------------------------------------------- wpalPacketRawTrimTail – reduce the length of the packet. Param: pPkt - pointer to a wpt_packet. size – number of bytes to take of the packet length Return: eWLAN_PAL_STATUS_SUCCESS – success. Otherwise fail. ---------------------------------------------------------------------------*/ wpt_status wpalPacketRawTrimTail(wpt_packet *pPkt, wpt_uint32 size) { wpt_status status = eWLAN_PAL_STATUS_SUCCESS; // Validate the parameter pointers if (unlikely(NULL == pPkt)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL packet pointer", __func__); return eWLAN_PAL_STATUS_E_INVAL; } if ((eWLAN_PAL_PKT_TYPE_TX_802_11_MGMT == WPAL_PACKET_GET_TYPE(pPkt)) || (eWLAN_PAL_PKT_TYPE_RX_RAW == WPAL_PACKET_GET_TYPE(pPkt))) { // Continue to trim the packet } else { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : neither 80211 managment packet nor RAW packet", __func__); VOS_ASSERT(0); return eWLAN_PAL_STATUS_E_INVAL; } if( !VOS_IS_STATUS_SUCCESS(vos_pkt_trim_tail(WPAL_TO_VOS_PKT(pPkt), (v_SIZE_t)size)) ) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s Invalid trim(%d)", __func__, size); status = eWLAN_PAL_STATUS_E_INVAL; } return status; }/*wpalPacketRawTrimTail*/
/*--------------------------------------------------------------------------- wpalPacketGetRawBuf – Return the starting buffer virtual address for the RAW flat buffer It is inline in hope of faster implementation for certain platform. For Winxp, it will be slow. Param: pPkt - pointer to a wpt_packet. Return: NULL - fail. Otherwise the address of the starting of the buffer ---------------------------------------------------------------------------*/ wpt_uint8 *wpalPacketGetRawBuf(wpt_packet *pPkt) { wpt_uint8 *pRet = NULL; // Validate the parameter pointers if (unlikely(NULL == pPkt)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL packet pointer", __func__); return NULL; } //Since it is a flat buffer, all we need is to get one byte of offset 0 if( (eWLAN_PAL_PKT_TYPE_RX_RAW == WPAL_PACKET_GET_TYPE(pPkt)) || (eWLAN_PAL_PKT_TYPE_TX_802_11_MGMT == WPAL_PACKET_GET_TYPE(pPkt)) ) { vos_pkt_peek_data(WPAL_TO_VOS_PKT(pPkt), 0, (v_VOID_t**)&pRet, 1); WPAL_ASSERT(NULL != pRet); } return pRet; }/*wpalPacketGetRawBuf*/
wpt_uint8 *wpalPacketGetRawBuf(wpt_packet *pPkt) { wpt_uint8 *pRet = NULL; // if (unlikely(NULL == pPkt)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL packet pointer", __func__); return NULL; } // if( (eWLAN_PAL_PKT_TYPE_RX_RAW == WPAL_PACKET_GET_TYPE(pPkt)) || (eWLAN_PAL_PKT_TYPE_TX_802_11_MGMT == WPAL_PACKET_GET_TYPE(pPkt)) ) { vos_pkt_peek_data(WPAL_TO_VOS_PKT(pPkt), 0, (v_VOID_t**)&pRet, 1); WPAL_ASSERT(NULL != pRet); } return pRet; }/* */
/*--------------------------------------------------------------------------- wpalUnlockPacket – Unmap the data buffer from dma so that cpu can regain ownership on it Param: pPacket – pointer to a wpt_packet Return: eWLAN_PAL_STATUS_SUCCESS - success ---------------------------------------------------------------------------*/ wpt_status wpalUnlockPacket( wpt_packet *pPacket) { wpt_iterator_info* pInfo; // Validate the parameter pointers if (unlikely(NULL == pPacket)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL input pointer pPacket", __func__); return eWLAN_PAL_STATUS_E_INVAL; } pInfo = (wpt_iterator_info*)pPacket->pInternalData; // Validate pInfo if (unlikely(NULL == pInfo)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_FATAL, "%s : NULL input pointer pInfo", __func__); return eWLAN_PAL_STATUS_E_INVAL; } switch(WPAL_PACKET_GET_TYPE(pPacket)) { /* For management frames, BD is allocated by WDI, header is in raw buffer, rest of the frame is also in raw buffer */ case eWLAN_PAL_PKT_TYPE_TX_802_11_MGMT: { /*TX Packets need to be DMA-ed to the device, perform DMA mapping accordingly */ itReturnOSPktAddrForDevice(pPacket, pInfo->pPhyAddr, pInfo->uLen); } break; /* Data packets - BD (allocated by WDI), header (in VOSS header), rest of the packet (DSM items) */ case eWLAN_PAL_PKT_TYPE_TX_802_11_DATA: case eWLAN_PAL_PKT_TYPE_TX_802_3_DATA: { /*TX Packets need to be DMA-ed to the device, perform DMA mapping accordingly */ itReturnOSPktAddrForDevice(pPacket, pInfo->pPhyAddr, pInfo->uLen); } break; /* For Raw RX, BD + header + rest of the packet is all contained in the raw buffer */ case eWLAN_PAL_PKT_TYPE_RX_RAW: { /*RX Packets need to be DMA-ed from the device, perform DMA mapping accordingly */ if(NULL == pInfo->pPhyAddr) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, " WLAN_PAL: %s: RX frame was not locked properly", __func__); } else { itReturnOSPktAddrFromDevice(pPacket, pInfo->pPhyAddr, pInfo->uLen); } } break; default: { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, " WLAN_PAL: %s: Invalid packet type %d!", __func__, WPAL_PACKET_GET_TYPE(pPacket) ); WPAL_ASSERT(0); return eWLAN_PAL_STATUS_E_FAILURE; } } wpalMemoryFree(pInfo); pPacket->pInternalData = NULL; return eWLAN_PAL_STATUS_SUCCESS; }/*wpalUnlockPacket*/
/*--------------------------------------------------------------------------- wpalLockPacketForTransfer – Map the data buffer from dma so that the data is commited from cache and the cpu relinquishes ownership of the buffer Param: pPacket – pointer to a wpt_packet Return: eWLAN_PAL_STATUS_SUCCESS - success ---------------------------------------------------------------------------*/ wpt_status wpalLockPacketForTransfer( wpt_packet *pPacket) { void* pPhyData = NULL; wpt_iterator_info* pInfo = NULL; v_U16_t uLenData = 0; // Validate the parameter pointers if (unlikely(NULL == pPacket)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL input pointer", __func__); return eWLAN_PAL_STATUS_E_INVAL; } switch(WPAL_PACKET_GET_TYPE(pPacket)) { /* For management frames, BD is allocated by WDI, header is in raw buffer, rest of the frame is also in raw buffer */ case eWLAN_PAL_PKT_TYPE_TX_802_11_MGMT: { /*TX Packets need to be DMA-ed to the device, perform DMA mapping accordingly */ pPhyData = (void*)itGetOSPktAddrForDevice( pPacket ); } break; /* Data packets - BD (allocated by WDI), header (in VOSS header), rest of the packet (DSM items) */ case eWLAN_PAL_PKT_TYPE_TX_802_11_DATA: case eWLAN_PAL_PKT_TYPE_TX_802_3_DATA: { /*TX Packets need to be DMA-ed to the device, perform DMA mapping accordingly */ pPhyData = (void*)itGetOSPktAddrForDevice( pPacket ); } break; /* For Raw RX, BD + header + rest of the packet is all contained in the raw buffer */ case eWLAN_PAL_PKT_TYPE_RX_RAW: { /*RX Packets need to be DMA-ed from the device, perform DMA mapping accordingly */ pPhyData = (void*)itGetOSPktAddrFromDevice( pPacket ); } break; default: { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, " WLAN_PAL: %s: Invalid packet type %d!", __func__, WPAL_PACKET_GET_TYPE(pPacket) ); WPAL_ASSERT(0); return eWLAN_PAL_STATUS_E_FAILURE; } } /*Get packet length*/ vos_pkt_get_packet_length(WPAL_TO_VOS_PKT(pPacket),&uLenData); /*Allocate memory for the current info*/ pInfo = wpalMemoryAllocate( sizeof(wpt_iterator_info) ); // Validate the memory allocation if (unlikely(NULL == pInfo)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : Failed to allocate memory ", __func__); return eWLAN_PAL_STATUS_E_INVAL; } pInfo->pPhyAddr = pPhyData; pInfo->uLen = uLenData; pPacket->pInternalData = pInfo; return eWLAN_PAL_STATUS_SUCCESS; }/*wpalLockPacketForTransfer*/
wpt_status wpalUnlockPacket( wpt_packet *pPacket) { wpt_iterator_info* pInfo; // if (unlikely(NULL == pPacket)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL input pointer pPacket", __func__); return eWLAN_PAL_STATUS_E_INVAL; } pInfo = (wpt_iterator_info*)pPacket->pInternalData; // if (unlikely(NULL == pInfo)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_FATAL, "%s : NULL input pointer pInfo", __func__); return eWLAN_PAL_STATUS_E_INVAL; } switch(WPAL_PACKET_GET_TYPE(pPacket)) { /* */ case eWLAN_PAL_PKT_TYPE_TX_802_11_MGMT: { /* */ itReturnOSPktAddrForDevice(pPacket, pInfo->pPhyAddr, pInfo->uLen); } break; /* */ case eWLAN_PAL_PKT_TYPE_TX_802_11_DATA: case eWLAN_PAL_PKT_TYPE_TX_802_3_DATA: { /* */ itReturnOSPktAddrForDevice(pPacket, pInfo->pPhyAddr, pInfo->uLen); } break; /* */ case eWLAN_PAL_PKT_TYPE_RX_RAW: { /* */ if(NULL == pInfo->pPhyAddr) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, " WLAN_PAL: %s: RX frame was not locked properly", __func__); } else { itReturnOSPktAddrFromDevice(pPacket, pInfo->pPhyAddr, pInfo->uLen); } } break; default: { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, " WLAN_PAL: %s: Invalid packet type %d!", __func__, WPAL_PACKET_GET_TYPE(pPacket) ); WPAL_ASSERT(0); return eWLAN_PAL_STATUS_E_FAILURE; } } wpalMemoryFree(pInfo); pPacket->pInternalData = NULL; return eWLAN_PAL_STATUS_SUCCESS; }/* */
wpt_status wpalLockPacketForTransfer( wpt_packet *pPacket) { void* pPhyData = NULL; wpt_iterator_info* pInfo = NULL; v_U16_t uLenData = 0; // if (unlikely(NULL == pPacket)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : NULL input pointer", __func__); return eWLAN_PAL_STATUS_E_INVAL; } switch(WPAL_PACKET_GET_TYPE(pPacket)) { /* */ case eWLAN_PAL_PKT_TYPE_TX_802_11_MGMT: { /* */ pPhyData = (void*)itGetOSPktAddrForDevice( pPacket ); } break; /* */ case eWLAN_PAL_PKT_TYPE_TX_802_11_DATA: case eWLAN_PAL_PKT_TYPE_TX_802_3_DATA: { /* */ pPhyData = (void*)itGetOSPktAddrForDevice( pPacket ); } break; /* */ case eWLAN_PAL_PKT_TYPE_RX_RAW: { /* */ pPhyData = (void*)itGetOSPktAddrFromDevice( pPacket ); } break; default: { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, " WLAN_PAL: %s: Invalid packet type %d!", __func__, WPAL_PACKET_GET_TYPE(pPacket) ); WPAL_ASSERT(0); return eWLAN_PAL_STATUS_E_FAILURE; } } /* */ vos_pkt_get_packet_length(WPAL_TO_VOS_PKT(pPacket),&uLenData); /* */ pInfo = wpalMemoryAllocate( sizeof(wpt_iterator_info) ); // if (unlikely(NULL == pInfo)) { WPAL_TRACE(eWLAN_MODULE_PAL, eWLAN_PAL_TRACE_LEVEL_ERROR, "%s : Failed to allocate memory ", __func__); return eWLAN_PAL_STATUS_E_INVAL; } pInfo->pPhyAddr = pPhyData; pInfo->uLen = uLenData; pPacket->pInternalData = pInfo; return eWLAN_PAL_STATUS_SUCCESS; }/* */