staging: rtl8192u: fix comments in r819xU_cmdpkt.c

/******************************************************************************

     (c) Copyright 2008, RealTEK Technologies Inc. All Rights Reserved.

 Module:	r819xusb_cmdpkt.c	(RTL8190 TX/RX command packet handler Source C File)

 Note:      The module is responsible for handling TX and RX command packet.

			1. TX : Send set and query configuration command packet.

			2. RX : Receive tx feedback, beacon state, query configuration

				command packet.

 Function:

 Export:

 Abbrev:

 History:

	Data		Who		Remark

	05/06/2008  amy		Create initial version porting from windows driver.

 *

 *  (c) Copyright 2008, RealTEK Technologies Inc. All Rights Reserved.

 *

 *  Module:	r819xusb_cmdpkt.c

 *		(RTL8190 TX/RX command packet handler Source C File)

 *

 *  Note:	The module is responsible for handling TX and RX command packet.

 *		1. TX : Send set and query configuration command packet.

 *		2. RX : Receive tx feedback, beacon state, query configuration

 *			command packet.

 *

 *  Function:

 *

 *  Export:

 *

 *  Abbrev:

 *

 *  History:

 *

 *	Date		Who		Remark

 *	05/06/2008	amy		Create initial version porting from

 *					windows driver.

 *

 ******************************************************************************/

#include "r8192U.h"

#include "r819xU_cmdpkt.h"

/*---------------------------Define Local Constant---------------------------*/

/* Debug constant */

#define		CMPK_DEBOUNCE_CNT			1

/* 2007/10/24 MH Add for printing a range of data. */

/* Add for printing a range of data. */

#define		CMPK_PRINT(Address)\

{\

	unsigned char	i;\

	for (i = 0; i < 40; i += 4)\

		printk("\r\n %08x", temp[i]);\

}\

/*---------------------------Define functions---------------------------------*/

rt_status SendTxCommandPacket(struct net_device *dev, void *pData, u32 DataLen)

{

	cb_desc		    *tcb_desc;

	unsigned char	    *ptr_buf;

	//Get TCB and local buffer from common pool. (It is shared by CmdQ, MgntQ, and USB coalesce DataQ)

	/* Get TCB and local buffer from common pool.

	   (It is shared by CmdQ, MgntQ, and USB coalesce DataQ) */

	skb  = dev_alloc_skb(USB_HWDESC_HEADER_LEN + DataLen + 4);

	memcpy((unsigned char *)(skb->cb), &dev, sizeof(dev));

	tcb_desc = (cb_desc *)(skb->cb + MAX_DEV_ADDR_SIZE);

	u8                  bLastIniPkt;

	firmware_init_param(dev);

	//Fragmentation might be required

	/* Fragmentation might be required */

	frag_threshold = pfirmware->cmdpacket_frag_thresold;

	do {

		if ((buffer_len - frag_offset) > frag_threshold) {

		}

		/* Allocate skb buffer to contain firmware info and tx descriptor info

		 * add 4 to avoid packet appending overflow.

		 * */

		/* Allocate skb buffer to contain firmware info and tx

		   descriptor info add 4 to avoid packet appending overflow. */

		#ifdef RTL8192U

		skb  = dev_alloc_skb(USB_HWDESC_HEADER_LEN + frag_length + 4);

		#else

#endif

}	/* CMPK_Message_Handle_Tx */

}

/*-----------------------------------------------------------------------------

 * Function:    cmpk_counttxstatistic()

 *

 * Overview:

 *

 * Input:       PADAPTER	pAdapter		-	.

 *				CMPK_TXFB_T *psTx_FB	-	.

 * Input:       PADAPTER	pAdapter

 *              CMPK_TXFB_T	*psTx_FB

 *

 * Output:      NONE

 *

	pAdapter->HalFunc.GetHwRegHandler(pAdapter, HW_VAR_RF_STATE, (pu1Byte)(&rtState));

	// When RF is off, we should not count the packet for hw/sw synchronize

	// reason, ie. there may be a duration while sw switch is changed and hw

	// switch is being changed. 2006.12.04, by shien chang.

	/* When RF is off, we should not count the packet for hw/sw synchronize

	   reason, ie. there may be a duration while sw switch is changed and

	   hw switch is being changed. */

	if (rtState == eRfOff)

		return;

#endif

	if (pAdapter->bInHctTest)

		return;

#endif

	/* We can not know the packet length and transmit type: broadcast or uni

	   or multicast. So the relative statistics must be collected in tx

	   feedback info. */

	/* We can not know the packet length and transmit type:

	   broadcast or uni or multicast. So the relative statistics

	   must be collected in tx feedback info. */

	if (pstx_fb->tok) {

		priv->stats.txfeedbackok++;

		priv->stats.txoktotal++;

	priv->stats.txretrycount += pstx_fb->retry_cnt;

	priv->stats.txfeedbackretry += pstx_fb->retry_cnt;

}	/* cmpk_CountTxStatistic */

}

 *

 * Overview:	The function is responsible for extract the message inside TX

 *		feedbck message from firmware. It will contain dedicated info in

 *				ws-06-0063-rtl8190-command-packet-specification. Please

 *				refer to chapter "TX Feedback Element". We have to read 20 bytes

 *				in the command packet.

 *		ws-06-0063-rtl8190-command-packet-specification.

 *		Please refer to chapter "TX Feedback Element".

 *              We have to read 20 bytes in the command packet.

 *

 * Input:       struct net_device	*dev

 *              u8			*pmsg	- Msg Ptr of the command packet.

static void cmpk_handle_tx_feedback(struct net_device *dev, u8 *pmsg)

{

	struct r8192_priv *priv = ieee80211_priv(dev);

	cmpk_txfb_t		rx_tx_fb;	/* */

	cmpk_txfb_t		rx_tx_fb;

	priv->stats.txfeedback++;

	/* It seems that FW use big endian(MIPS) and DRV use little endian in

	   windows OS. So we have to read the content byte by byte or transfer

	   endian type before copy the message copy. */

	/* 2007/07/05 MH Use pointer to transfer structure memory. */

	/* Use pointer to transfer structure memory. */

	memcpy((u8 *)&rx_tx_fb, pmsg, sizeof(cmpk_txfb_t));

	/* 2. Use tx feedback info to count TX statistics. */

	cmpk_count_txstatistic(dev, &rx_tx_fb);

	/* 2007/01/17 MH Comment previous method for TX statistic function. */

	/* Comment previous method for TX statistic function. */

	/* Collect info TX feedback packet to fill TCB. */

	/* We can not know the packet length and transmit type: broadcast or uni

	   or multicast. */

}	/* cmpk_Handle_Tx_Feedback */

}

void cmdpkt_beacontimerinterrupt_819xusb(struct net_device *dev)

{

	struct r8192_priv *priv = ieee80211_priv(dev);

	u16 tx_rate;

		//

		// 070117, rcnjko: 87B have to S/W beacon for DTM encryption_cmn.

		//

		/* 87B have to S/W beacon for DTM encryption_cmn. */

		if (priv->ieee80211->current_network.mode == IEEE_A ||

			priv->ieee80211->current_network.mode == IEEE_N_5G ||

			(priv->ieee80211->current_network.mode == IEEE_N_24G && (!priv->ieee80211->pHTInfo->bCurSuppCCK))) {

			DMESG("send beacon frame  tx rate is 1Mbpm\n");

		}

		rtl819xusb_beacon_tx(dev, tx_rate); // HW Beacon

		rtl819xusb_beacon_tx(dev, tx_rate); /* HW Beacon */

}

 *		ws-07-0063-v06-rtl819x-command-packet-specification-070315.doc.

 *		Please refer to chapter "Interrupt Status Element".

 *

 * Input:       struct net_device *dev,

 * Input:       struct net_device *dev

 *              u8 *pmsg		- Message Pointer of the command packet.

 *

 * Output:      NONE

	}

	// Statistics of beacon for ad-hoc mode.

	/* Statistics of beacon for ad-hoc mode. */

	if (priv->ieee80211->iw_mode == IW_MODE_ADHOC) {

		//2 maybe need endian transform?

		/* 2 maybe need endian transform? */

		rx_intr_status.interrupt_status = *((u32 *)(pmsg + 4));

		DMESG("interrupt status = 0x%x\n", rx_intr_status.interrupt_status);

	}

	 // Other informations in interrupt status we need?

	/* Other informations in interrupt status we need? */

	DMESG("<---- cmpk_handle_interrupt_status()\n");

}	/* cmpk_handle_interrupt_status */

}

/*-----------------------------------------------------------------------------

 *---------------------------------------------------------------------------*/

static void cmpk_handle_query_config_rx(struct net_device *dev, u8 *pmsg)

{

	cmpk_query_cfg_t	rx_query_cfg;	/* */

	cmpk_query_cfg_t	rx_query_cfg;

	/* 1. Extract TX feedback info from RFD to temp structure buffer. */

	rx_query_cfg.mask		= (pmsg[12] << 24) | (pmsg[13] << 16) |

					  (pmsg[14] <<  8) | (pmsg[15] <<  0);

}	/* cmpk_Handle_Query_Config_Rx */

}

/*-----------------------------------------------------------------------------

	pAdapter->HalFunc.GetHwRegHandler(pAdapter, HW_VAR_RF_STATE, (pu1Byte)(&rtState));

	// When RF is off, we should not count the packet for hw/sw synchronize

	// reason, ie. there may be a duration while sw switch is changed and hw

	// switch is being changed. 2006.12.04, by shien chang.

	/* When RF is off, we should not count the packet for hw/sw synchronize

	   reason, ie. there may be a duration while sw switch is changed and

	   hw switch is being changed. */

	if (rtState == eRfOff)

		return;

#endif

	priv->stats.txbytesunicast	+= pstx_status->txuclength;

	priv->stats.last_packet_rate	= pstx_status->rate;

}	/* cmpk_CountTxStatus */

}

 *---------------------------------------------------------------------------*/

static void cmpk_handle_tx_status(struct net_device *dev, u8 *pmsg)

{

	cmpk_tx_status_t	rx_tx_sts;	/* */

	cmpk_tx_status_t	rx_tx_sts;

	memcpy((void *)&rx_tx_sts, (void *)pmsg, sizeof(cmpk_tx_status_t));

	/* 2. Use tx feedback info to count TX statistics. */

	cmpk_count_tx_status(dev, &rx_tx_sts);

}	/* cmpk_Handle_Tx_Status */

}

/*-----------------------------------------------------------------------------

#ifdef ENABLE_PS

	pAdapter->HalFunc.GetHwRegHandler(pAdapter, HW_VAR_RF_STATE, (pu1Byte)(&rtState));

	// When RF is off, we should not count the packet for hw/sw synchronize

	// reason, ie. there may be a duration while sw switch is changed and hw

	// switch is being changed. 2006.12.04, by shien chang.

	/* When RF is off, we should not count the packet for hw/sw synchronize

	   reason, ie. there may be a duration while sw switch is changed and

	   hw switch is being changed. */

	if (rtState == eRfOff)

		return;

#endif

	ptemp = (u32 *)pmsg;

	//

	// Do endian transfer to word alignment(16 bits) for windows system.

	// You must do different endian transfer for linux and MAC OS

	//

	/* Do endian transfer to word alignment(16 bits) for windows system.

	   You must do different endian transfer for linux and MAC OS */

	for (i = 0; i < (length/4); i++) {

		u16	 temp1, temp2;

		return;

	for (i = 0; i < 16; i++) {

		// Collect CCK rate packet num

		/* Collect CCK rate packet num */

		if (i < 4)

			priv->stats.txrate.cck[i] += ptxrate->cck[i];

		// Collect OFDM rate packet num

		/* Collect OFDM rate packet num */

		if (i < 8)

			priv->stats.txrate.ofdm[i] += ptxrate->ofdm[i];

			priv->stats.txrate.ht_mcs[j][i] += ptxrate->ht_mcs[j][i];

	}

}	/* cmpk_Handle_Tx_Rate_History */

}

/*-----------------------------------------------------------------------------

	u8			element_id;

	u8			*pcmd_buff;

	/* 0. Check inpt arguments. If is is a command queue message or pointer is

	      null. */

	/* 0. Check inpt arguments. If is is a command queue message or

	   pointer is null. */

	if (pstats == NULL)

		return 0;	/* This is not a command packet. */

	element_id = pcmd_buff[0];

	/* 4. Check every received command packet content according to different

	      element type. Because FW may aggregate RX command packet to minimize

	      transmit time between DRV and FW.*/

	// Add a counter to prevent the lock in the loop from being held too long

	      element type. Because FW may aggregate RX command packet to

	      minimize transmit time between DRV and FW.*/

	/* Add a counter to prevent the lock in the loop from being held too

	   long */

	while (total_length > 0 && exe_cnt++ < 100) {

		/* 2007/01/17 MH We support aggregation of different cmd in the same packet. */

		/* We support aggregation of different cmd in the same packet */

		element_id = pcmd_buff[0];

		switch (element_id) {

				break;

			case RX_TX_PER_PKT_FEEDBACK:

				// You must at lease add a switch case element here,

				// Otherwise, we will jump to default case.

				/* You must at lease add a switch case element here,

				   Otherwise, we will jump to default case. */

				cmd_length = CMPK_RX_TX_FB_SIZE;

				break;

	}

	return	1;	/* This is a command packet. */

}	/* CMPK_Message_Handle_Rx */

}