staging: bcm: HandleControlPacket.c: fix comments

Signed-off-by: Johannes Tenschert <Johannes.Tenschert@informatik.stud.uni-erlangen.de>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
This commit is contained in:
Johannes Tenschert 2011-12-09 20:38:07 +01:00 committed by Greg Kroah-Hartman
parent efa6f862d3
commit 77eb7585db
1 changed files with 45 additions and 36 deletions

View File

@ -1,16 +1,16 @@
/** /**
@file HandleControlPacket.c * @file HandleControlPacket.c
This file contains the routines to deal with * This file contains the routines to deal with
sending and receiving of control packets. * sending and receiving of control packets.
*/ */
#include "headers.h" #include "headers.h"
/** /**
When a control packet is received, analyze the * When a control packet is received, analyze the
"status" and call appropriate response function. * "status" and call appropriate response function.
Enqueue the control packet for Application. * Enqueue the control packet for Application.
@return None * @return None
*/ */
static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb) static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb)
{ {
PPER_TARANG_DATA pTarang = NULL; PPER_TARANG_DATA pTarang = NULL;
@ -26,7 +26,7 @@ static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb)
switch (usStatus) switch (usStatus)
{ {
case CM_RESPONSES: // 0xA0 case CM_RESPONSES: /* 0xA0 */
BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "MAC Version Seems to be Non Multi-Classifier, rejected by Driver"); BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "MAC Version Seems to be Non Multi-Classifier, rejected by Driver");
HighPriorityMessage = TRUE; HighPriorityMessage = TRUE;
break; break;
@ -37,17 +37,17 @@ static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb)
CmControlResponseMessage(Adapter, (skb->data + sizeof(USHORT))); CmControlResponseMessage(Adapter, (skb->data + sizeof(USHORT)));
} }
break; break;
case LINK_CONTROL_RESP: //0xA2 case LINK_CONTROL_RESP: /* 0xA2 */
case STATUS_RSP: //0xA1 case STATUS_RSP: /* 0xA1 */
BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "LINK_CONTROL_RESP"); BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "LINK_CONTROL_RESP");
HighPriorityMessage = TRUE; HighPriorityMessage = TRUE;
LinkControlResponseMessage(Adapter, (skb->data + sizeof(USHORT))); LinkControlResponseMessage(Adapter, (skb->data + sizeof(USHORT)));
break; break;
case STATS_POINTER_RESP: //0xA6 case STATS_POINTER_RESP: /* 0xA6 */
HighPriorityMessage = TRUE; HighPriorityMessage = TRUE;
StatisticsResponse(Adapter, (skb->data + sizeof(USHORT))); StatisticsResponse(Adapter, (skb->data + sizeof(USHORT)));
break; break;
case IDLE_MODE_STATUS: //0xA3 case IDLE_MODE_STATUS: /* 0xA3 */
BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "IDLE_MODE_STATUS Type Message Got from F/W"); BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "IDLE_MODE_STATUS Type Message Got from F/W");
InterfaceIdleModeRespond(Adapter, (PUINT)(skb->data + InterfaceIdleModeRespond(Adapter, (PUINT)(skb->data +
sizeof(USHORT))); sizeof(USHORT)));
@ -64,7 +64,7 @@ static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb)
break; break;
} }
//Queue The Control Packet to The Application Queues /* Queue The Control Packet to The Application Queues */
down(&Adapter->RxAppControlQueuelock); down(&Adapter->RxAppControlQueuelock);
for (pTarang = Adapter->pTarangs; pTarang; pTarang = pTarang->next) for (pTarang = Adapter->pTarangs; pTarang; pTarang = pTarang->next)
@ -76,12 +76,18 @@ static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb)
drop_pkt_flag = TRUE; drop_pkt_flag = TRUE;
/* /*
There are cntrl msg from A0 to AC. It has been mapped to 0 to C bit in the cntrl mask. * There are cntrl msg from A0 to AC. It has been mapped to 0 to
Also, by default AD to BF has been masked to the rest of the bits... which wil be ON by default. * C bit in the cntrl mask.
if mask bit is enable to particular pkt status, send it out to app else stop it. * Also, by default AD to BF has been masked to the rest of the
*/ * bits... which wil be ON by default.
* if mask bit is enable to particular pkt status, send it out
* to app else stop it.
*/
cntrl_msg_mask_bit = (usStatus & 0x1F); cntrl_msg_mask_bit = (usStatus & 0x1F);
//printk("\ninew msg mask bit which is disable in mask:%X", cntrl_msg_mask_bit); /*
* printk("\ninew msg mask bit which is disable in mask:%X",
* cntrl_msg_mask_bit);
*/
if (pTarang->RxCntrlMsgBitMask & (1 << cntrl_msg_mask_bit)) if (pTarang->RxCntrlMsgBitMask & (1 << cntrl_msg_mask_bit))
drop_pkt_flag = FALSE; drop_pkt_flag = FALSE;
@ -89,12 +95,13 @@ static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb)
((pTarang->AppCtrlQueueLen > MAX_APP_QUEUE_LEN / 2) && (HighPriorityMessage == FALSE))) ((pTarang->AppCtrlQueueLen > MAX_APP_QUEUE_LEN / 2) && (HighPriorityMessage == FALSE)))
{ {
/* /*
Assumption:- * Assumption:-
1. every tarang manages it own dropped pkt statitistics * 1. every tarang manages it own dropped pkt
2. Total packet dropped per tarang will be equal to the sum of all types of dropped * statitistics
pkt by that tarang only. * 2. Total packet dropped per tarang will be equal to
* the sum of all types of dropped pkt by that
*/ * tarang only.
*/
switch (*(PUSHORT)skb->data) switch (*(PUSHORT)skb->data)
{ {
case CM_RESPONSES: case CM_RESPONSES:
@ -140,16 +147,15 @@ static VOID handle_rx_control_packet(PMINI_ADAPTER Adapter, struct sk_buff *skb)
} }
/** /**
@ingroup ctrl_pkt_functions * @ingroup ctrl_pkt_functions
Thread to handle control pkt reception * Thread to handle control pkt reception
*/ */
int control_packet_handler(PMINI_ADAPTER Adapter /**< pointer to adapter object*/ int control_packet_handler(PMINI_ADAPTER Adapter /* pointer to adapter object*/)
)
{ {
struct sk_buff *ctrl_packet = NULL; struct sk_buff *ctrl_packet = NULL;
unsigned long flags = 0; unsigned long flags = 0;
//struct timeval tv; /* struct timeval tv; */
//int *puiBuffer = NULL; /* int *puiBuffer = NULL; */
BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "Entering to make thread wait on control packet event!"); BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "Entering to make thread wait on control packet event!");
while (1) while (1)
{ {
@ -171,7 +177,10 @@ int control_packet_handler(PMINI_ADAPTER Adapter /**< pointer to adapter object
((TRUE == Adapter->IdleMode) || (TRUE == Adapter->bShutStatus))) ((TRUE == Adapter->IdleMode) || (TRUE == Adapter->bShutStatus)))
{ {
BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "Calling InterfaceAbortIdlemode\n"); BCM_DEBUG_PRINT(Adapter, DBG_TYPE_OTHERS, CP_CTRL_PKT, DBG_LVL_ALL, "Calling InterfaceAbortIdlemode\n");
// Adapter->bTriedToWakeUpFromlowPowerMode = TRUE; /*
* Adapter->bTriedToWakeUpFromlowPowerMode
* = TRUE;
*/
InterfaceIdleModeWakeup(Adapter); InterfaceIdleModeWakeup(Adapter);
} }
continue; continue;
@ -184,7 +193,7 @@ int control_packet_handler(PMINI_ADAPTER Adapter /**< pointer to adapter object
if (ctrl_packet) if (ctrl_packet)
{ {
DEQUEUEPACKET(Adapter->RxControlHead, Adapter->RxControlTail); DEQUEUEPACKET(Adapter->RxControlHead, Adapter->RxControlTail);
// Adapter->RxControlHead=ctrl_packet->next; /* Adapter->RxControlHead=ctrl_packet->next; */
} }
spin_unlock_irqrestore(&Adapter->control_queue_lock, flags); spin_unlock_irqrestore(&Adapter->control_queue_lock, flags);
@ -211,7 +220,7 @@ INT flushAllAppQ(void)
dev_kfree_skb(PacketToDrop); dev_kfree_skb(PacketToDrop);
} }
pTarang->AppCtrlQueueLen = 0; pTarang->AppCtrlQueueLen = 0;
//dropped contrl packet statistics also should be reset. /* dropped contrl packet statistics also should be reset. */
memset((PVOID)&pTarang->stDroppedAppCntrlMsgs, 0, sizeof(S_MIBS_DROPPED_APP_CNTRL_MESSAGES)); memset((PVOID)&pTarang->stDroppedAppCntrlMsgs, 0, sizeof(S_MIBS_DROPPED_APP_CNTRL_MESSAGES));
} }