Skip to content
Snippets Groups Projects
Commit c8881632 authored by Mike McCormack's avatar Mike McCormack Committed by Greg Kroah-Hartman
Browse files

staging: rtl8192e: Tidy up function header comments 


Signed-off-by: default avatarMike McCormack <mikem@ring3k.org>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@suse.de>
parent bf2c9de4
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
drivers/staging/rtl8192e/ieee80211/rtl819x_BAProc.c
+ 52
− 150
View file @ c8881632
/******************************************************************************************************************************** /*
* This file is created to process BA Action Frame. According to 802.11 spec, there are 3 BA action types at all. And as BA is * This file is created to process BA Action Frame. According to 802.11 spec,
* related to TS, this part need some struture defined in QOS side code. Also TX RX is going to be resturctured, so how to send * there are 3 BA action types at all. And as BA is related to TS, this part
* ADDBAREQ ADDBARSP and DELBA packet is still on consideration. Temporarily use MANAGE QUEUE instead of Normal Queue. * need some struture defined in QOS side code. Also TX RX is going to be
* WB 2008-05-27 * resturctured, so how to send ADDBAREQ ADDBARSP and DELBA packet is still
* *****************************************************************************************************************************/ * on consideration. Temporarily use MANAGE QUEUE instead of Normal Queue.
*/
#include "ieee80211.h" #include "ieee80211.h"
#include "rtl819x_BA.h" #include "rtl819x_BA.h"
/******************************************************************************************************************** /*
*function: Activate BA entry. And if Time is nozero, start timer. * Activate BA entry. And if Time is nozero, start timer.
* input: PBA_RECORD pBA //BA entry to be enabled */
* u16 Time //indicate time delay.
* output: none
********************************************************************************************************************/
void ActivateBAEntry(struct ieee80211_device* ieee, PBA_RECORD pBA, u16 Time) void ActivateBAEntry(struct ieee80211_device* ieee, PBA_RECORD pBA, u16 Time)
{ {
pBA->bValid = true; pBA->bValid = true;
...@@ -20,23 +18,18 @@ void ActivateBAEntry(struct ieee80211_device* ieee, PBA_RECORD pBA, u16 Time) ...@@ -20,23 +18,18 @@ void ActivateBAEntry(struct ieee80211_device* ieee, PBA_RECORD pBA, u16 Time)
mod_timer(&pBA->Timer, jiffies + MSECS(Time)); mod_timer(&pBA->Timer, jiffies + MSECS(Time));
} }
/******************************************************************************************************************** /*
*function: deactivate BA entry, including its timer. * deactivate BA entry, including its timer.
* input: PBA_RECORD pBA //BA entry to be disabled */
* output: none
********************************************************************************************************************/
void DeActivateBAEntry( struct ieee80211_device* ieee, PBA_RECORD pBA) void DeActivateBAEntry( struct ieee80211_device* ieee, PBA_RECORD pBA)
{ {
pBA->bValid = false; pBA->bValid = false;
del_timer_sync(&pBA->Timer); del_timer_sync(&pBA->Timer);
} }
/********************************************************************************************************************
*function: deactivete BA entry in Tx Ts, and send DELBA. /*
* input: * deactivete BA entry in Tx Ts, and send DELBA.
* PTX_TS_RECORD pTxTs //Tx Ts which is to deactivate BA entry. */
* output: none
* notice: As PTX_TS_RECORD structure will be defined in QOS, so wait to be merged. //FIXME
********************************************************************************************************************/
u8 TxTsDeleteBA( struct ieee80211_device* ieee, PTX_TS_RECORD pTxTs) u8 TxTsDeleteBA( struct ieee80211_device* ieee, PTX_TS_RECORD pTxTs)
{ {
PBA_RECORD pAdmittedBa = &pTxTs->TxAdmittedBARecord; //These two BA entries must exist in TS structure PBA_RECORD pAdmittedBa = &pTxTs->TxAdmittedBARecord; //These two BA entries must exist in TS structure
...@@ -60,13 +53,9 @@ u8 TxTsDeleteBA( struct ieee80211_device* ieee, PTX_TS_RECORD pTxTs) ...@@ -60,13 +53,9 @@ u8 TxTsDeleteBA( struct ieee80211_device* ieee, PTX_TS_RECORD pTxTs)
return bSendDELBA; return bSendDELBA;
} }
/******************************************************************************************************************** /*
*function: deactivete BA entry in Tx Ts, and send DELBA. * deactivete BA entry in Tx Ts, and send DELBA.
* input: */
* PRX_TS_RECORD pRxTs //Rx Ts which is to deactivate BA entry.
* output: none
* notice: As PRX_TS_RECORD structure will be defined in QOS, so wait to be merged. //FIXME, same with above
********************************************************************************************************************/
u8 RxTsDeleteBA( struct ieee80211_device* ieee, PRX_TS_RECORD pRxTs) u8 RxTsDeleteBA( struct ieee80211_device* ieee, PRX_TS_RECORD pRxTs)
{ {
PBA_RECORD pBa = &pRxTs->RxAdmittedBARecord; PBA_RECORD pBa = &pRxTs->RxAdmittedBARecord;
...@@ -81,12 +70,9 @@ u8 RxTsDeleteBA( struct ieee80211_device* ieee, PRX_TS_RECORD pRxTs) ...@@ -81,12 +70,9 @@ u8 RxTsDeleteBA( struct ieee80211_device* ieee, PRX_TS_RECORD pRxTs)
return bSendDELBA; return bSendDELBA;
} }
/******************************************************************************************************************** /*
*function: reset BA entry * reset BA entry
* input: */
* PBA_RECORD pBA //entry to be reset
* output: none
********************************************************************************************************************/
void ResetBaEntry( PBA_RECORD pBA) void ResetBaEntry( PBA_RECORD pBA)
{ {
pBA->bValid = false; pBA->bValid = false;
...@@ -95,16 +81,11 @@ void ResetBaEntry( PBA_RECORD pBA) ...@@ -95,16 +81,11 @@ void ResetBaEntry( PBA_RECORD pBA)
pBA->DialogToken = 0; pBA->DialogToken = 0;
pBA->BaStartSeqCtrl.ShortData = 0; pBA->BaStartSeqCtrl.ShortData = 0;
} }
//These functions need porting here or not?
/******************************************************************************************************************************* /*
*function: construct ADDBAREQ and ADDBARSP frame here together. * construct ADDBAREQ and ADDBARSP frame here together.
* input: u8* Dst //ADDBA frame's destination * return constructed skb to xmit
* PBA_RECORD pBA //BA_RECORD entry which stores the necessary information for BA. */
* u16 StatusCode //status code in RSP and I will use it to indicate whether it's RSP or REQ(will I?)
* u8 type //indicate whether it's RSP(ACT_ADDBARSP) ow REQ(ACT_ADDBAREQ)
* output: none
* return: sk_buff* skb //return constructed skb to xmit
*******************************************************************************************************************************/
static struct sk_buff* ieee80211_ADDBA(struct ieee80211_device* ieee, u8* Dst, PBA_RECORD pBA, u16 StatusCode, u8 type) static struct sk_buff* ieee80211_ADDBA(struct ieee80211_device* ieee, u8* Dst, PBA_RECORD pBA, u16 StatusCode, u8 type)
{ {
struct sk_buff *skb = NULL; struct sk_buff *skb = NULL;
...@@ -174,58 +155,9 @@ static struct sk_buff* ieee80211_ADDBA(struct ieee80211_device* ieee, u8* Dst, P ...@@ -174,58 +155,9 @@ static struct sk_buff* ieee80211_ADDBA(struct ieee80211_device* ieee, u8* Dst, P
//return NULL; //return NULL;
} }
#if 0 //I try to merge ADDBA_REQ and ADDBA_RSP frames together.. /*
/******************************************************************************************************************** * construct DELBA frame
*function: construct ADDBAREQ frame */
* input: u8* dst //ADDBARsp frame's destination
* PBA_RECORD pBA //BA_RECORD entry which stores the necessary information for BA_RSP.
* u16 StatusCode //status code.
* output: none
* return: sk_buff* skb //return constructed skb to xmit
********************************************************************************************************************/
static struct sk_buff* ieee80211_ADDBA_Rsp( IN struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA, u16 StatusCode)
{
OCTET_STRING osADDBAFrame, tmp;
FillOctetString(osADDBAFrame, Buffer, 0);
*pLength = 0;
ConstructMaFrameHdr(
Adapter,
Addr,
ACT_CAT_BA,
ACT_ADDBARSP,
&osADDBAFrame );
// Dialog Token
FillOctetString(tmp, &pBA->DialogToken, 1);
PacketAppendData(&osADDBAFrame, tmp);
// Status Code
FillOctetString(tmp, &StatusCode, 2);
PacketAppendData(&osADDBAFrame, tmp);
// BA Parameter Set
FillOctetString(tmp, &pBA->BaParamSet, 2);
PacketAppendData(&osADDBAFrame, tmp);
// BA Timeout Value
FillOctetString(tmp, &pBA->BaTimeoutValue, 2);
PacketAppendData(&osADDBAFrame, tmp);
*pLength = osADDBAFrame.Length;
}
#endif
/********************************************************************************************************************
*function: construct DELBA frame
* input: u8* dst //DELBA frame's destination
* PBA_RECORD pBA //BA_RECORD entry which stores the necessary information for BA
* TR_SELECT TxRxSelect //TX RX direction
* u16 ReasonCode //status code.
* output: none
* return: sk_buff* skb //return constructed skb to xmit
********************************************************************************************************************/
static struct sk_buff* ieee80211_DELBA( static struct sk_buff* ieee80211_DELBA(
struct ieee80211_device* ieee, struct ieee80211_device* ieee,
u8* dst, u8* dst,
...@@ -286,13 +218,11 @@ static struct sk_buff* ieee80211_DELBA( ...@@ -286,13 +218,11 @@ static struct sk_buff* ieee80211_DELBA(
return skb; return skb;
} }
/******************************************************************************************************************** /*
*function: send ADDBAReq frame out * send ADDBAReq frame out
* input: u8* dst //ADDBAReq frame's destination * If any possible, please hide pBA in ieee.
* PBA_RECORD pBA //BA_RECORD entry which stores the necessary information for BA * And temporarily use Manage Queue as softmac_mgmt_xmit() usually does
* output: none */
* notice: If any possible, please hide pBA in ieee. And temporarily use Manage Queue as softmac_mgmt_xmit() usually does
********************************************************************************************************************/
void ieee80211_send_ADDBAReq(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA) void ieee80211_send_ADDBAReq(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA)
{ {
struct sk_buff *skb = NULL; struct sk_buff *skb = NULL;
...@@ -311,14 +241,11 @@ void ieee80211_send_ADDBAReq(struct ieee80211_device* ieee, u8* dst, PBA_RECORD ...@@ -311,14 +241,11 @@ void ieee80211_send_ADDBAReq(struct ieee80211_device* ieee, u8* dst, PBA_RECORD
} }
} }
/******************************************************************************************************************** /*
*function: send ADDBARSP frame out * send ADDBARSP frame out
* input: u8* dst //DELBA frame's destination * If any possible, please hide pBA in ieee.
* PBA_RECORD pBA //BA_RECORD entry which stores the necessary information for BA * And temporarily use Manage Queue as softmac_mgmt_xmit() usually does
* u16 StatusCode //RSP StatusCode */
* output: none
* notice: If any possible, please hide pBA in ieee. And temporarily use Manage Queue as softmac_mgmt_xmit() usually does
********************************************************************************************************************/
void ieee80211_send_ADDBARsp(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA, u16 StatusCode) void ieee80211_send_ADDBARsp(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA, u16 StatusCode)
{ {
struct sk_buff *skb = NULL; struct sk_buff *skb = NULL;
...@@ -333,16 +260,12 @@ void ieee80211_send_ADDBARsp(struct ieee80211_device* ieee, u8* dst, PBA_RECORD ...@@ -333,16 +260,12 @@ void ieee80211_send_ADDBARsp(struct ieee80211_device* ieee, u8* dst, PBA_RECORD
IEEE80211_DEBUG(IEEE80211_DL_ERR, "alloc skb error in function %s()\n", __FUNCTION__); IEEE80211_DEBUG(IEEE80211_DL_ERR, "alloc skb error in function %s()\n", __FUNCTION__);
} }
} }
/********************************************************************************************************************
*function: send ADDBARSP frame out
* input: u8* dst //DELBA frame's destination
* PBA_RECORD pBA //BA_RECORD entry which stores the necessary information for BA
* TR_SELECT TxRxSelect //TX or RX
* u16 ReasonCode //DEL ReasonCode
* output: none
* notice: If any possible, please hide pBA in ieee. And temporarily use Manage Queue as softmac_mgmt_xmit() usually does
********************************************************************************************************************/
/*
* send ADDBARSP frame out
* If any possible, please hide pBA in ieee.
* And temporarily use Manage Queue as softmac_mgmt_xmit() usually does
*/
void ieee80211_send_DELBA(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA, TR_SELECT TxRxSelect, u16 ReasonCode) void ieee80211_send_DELBA(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA, TR_SELECT TxRxSelect, u16 ReasonCode)
{ {
struct sk_buff *skb = NULL; struct sk_buff *skb = NULL;
...@@ -359,12 +282,6 @@ void ieee80211_send_DELBA(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA ...@@ -359,12 +282,6 @@ void ieee80211_send_DELBA(struct ieee80211_device* ieee, u8* dst, PBA_RECORD pBA
return ; return ;
} }
/********************************************************************************************************************
*function: RX ADDBAReq
* input: struct sk_buff * skb //incoming ADDBAReq skb.
* return: 0(pass), other(fail)
* notice: As this function need support of QOS, I comment some code out. And when qos is ready, this code need to be support.
********************************************************************************************************************/
int ieee80211_rx_ADDBAReq( struct ieee80211_device* ieee, struct sk_buff *skb) int ieee80211_rx_ADDBAReq( struct ieee80211_device* ieee, struct sk_buff *skb)
{ {
struct ieee80211_hdr_3addr* req = NULL; struct ieee80211_hdr_3addr* req = NULL;
...@@ -459,12 +376,6 @@ OnADDBAReq_Fail: ...@@ -459,12 +376,6 @@ OnADDBAReq_Fail:
} }
/********************************************************************************************************************
*function: RX ADDBARSP
* input: struct sk_buff * skb //incoming ADDBAReq skb.
* return: 0(pass), other(fail)
* notice: As this function need support of QOS, I comment some code out. And when qos is ready, this code need to be support.
********************************************************************************************************************/
int ieee80211_rx_ADDBARsp( struct ieee80211_device* ieee, struct sk_buff *skb) int ieee80211_rx_ADDBARsp( struct ieee80211_device* ieee, struct sk_buff *skb)
{ {
struct ieee80211_hdr_3addr* rsp = NULL; struct ieee80211_hdr_3addr* rsp = NULL;
...@@ -592,12 +503,6 @@ OnADDBARsp_Reject: ...@@ -592,12 +503,6 @@ OnADDBARsp_Reject:
} }
/********************************************************************************************************************
*function: RX DELBA
* input: struct sk_buff * skb //incoming ADDBAReq skb.
* return: 0(pass), other(fail)
* notice: As this function need support of QOS, I comment some code out. And when qos is ready, this code need to be support.
********************************************************************************************************************/
int ieee80211_rx_DELBA(struct ieee80211_device* ieee,struct sk_buff *skb) int ieee80211_rx_DELBA(struct ieee80211_device* ieee,struct sk_buff *skb)
{ {
struct ieee80211_hdr_3addr* delba = NULL; struct ieee80211_hdr_3addr* delba = NULL;
...@@ -669,9 +574,7 @@ int ieee80211_rx_DELBA(struct ieee80211_device* ieee,struct sk_buff *skb) ...@@ -669,9 +574,7 @@ int ieee80211_rx_DELBA(struct ieee80211_device* ieee,struct sk_buff *skb)
return 0; return 0;
} }
// /* ADDBA initiate. This can only be called by TX side. */
// ADDBA initiate. This can only be called by TX side.
//
void void
TsInitAddBA( TsInitAddBA(
struct ieee80211_device* ieee, struct ieee80211_device* ieee,
...@@ -730,12 +633,11 @@ TsInitDelBA( struct ieee80211_device* ieee, PTS_COMMON_INFO pTsCommonInfo, TR_SE ...@@ -730,12 +633,11 @@ TsInitDelBA( struct ieee80211_device* ieee, PTS_COMMON_INFO pTsCommonInfo, TR_SE
DELBA_REASON_END_BA ); DELBA_REASON_END_BA );
} }
} }
/********************************************************************************************************************
*function: BA setup timer /*
* input: unsigned long data //acturally we send TX_TS_RECORD or RX_TS_RECORD to these timer * BA setup timer
* return: NULL * acturally we send TX_TS_RECORD or RX_TS_RECORD to these timer
* notice: */
********************************************************************************************************************/
void BaSetupTimeOut(unsigned long data) void BaSetupTimeOut(unsigned long data)
{ {
PTX_TS_RECORD pTxTs = (PTX_TS_RECORD)data; PTX_TS_RECORD pTxTs = (PTX_TS_RECORD)data;
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment