Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e62b4e21 authored by John Whitmore's avatar John Whitmore Committed by Greg Kroah-Hartman
Browse files

staging: rtl8192u: Truncate block comments to 80 character length - Style 



Where possible truncation of block comments to the 80 character length
preferred by the coding style.

In a previous version of this commit some of the comments were contentious so
those have not been touched in this version.

Signed-off-by: default avatarJohn Whitmore <johnfwhitmore@gmail.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent 5d9f4b53

drivers/staging/rtl8192u/ieee80211/rtl819x_HTProc.c

+63 −43
Original line number Diff line number Diff line 
// SPDX-License-Identifier: GPL-2.0



//As this function is mainly ported from Windows driver, so leave the name little changed. If any confusion caused, tell me. Created by WB. 2008.05.08

/*

 * As this function is mainly ported from Windows driver, so leave the name

 * little changed. If any confusion caused, tell me. Created by WB. 2008.05.08

 */

#include "ieee80211.h"

#include "rtl819x_HT.h"

u8 MCS_FILTER_ALL[16] = {0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0xff, 0x1f, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
@@ -42,8 +45,8 @@ static u8 AIRLINK_RALINK[3] = {0x00, 0x18, 0x02}; 
//static u8 DLINK_ATHEROS[3] = {0x00, 0x1c, 0xf0};

static u8 CISCO_BROADCOM[3] = {0x00, 0x17, 0x94};

/*

 * 2008/04/01 MH For Cisco G mode RX TP We need to change FW duration. Should we put the

 * code in other place??

 * 2008/04/01 MH For Cisco G mode RX TP We need to change FW duration. Should we

 * put the code in other place??

 * static u8 WIFI_CISCO_G_AP[3] = {0x00, 0x40, 0x96};

 */

/*
@@ -117,7 +120,8 @@ void HTUpdateDefaultSetting(struct ieee80211_device *ieee) 
}



/*

 *function:  This function print out each field on HT capability IE mainly from (Beacon/ProbeRsp/AssocReq)

 *function:  This function print out each field on HT capability

 *           IE mainly from (Beacon/ProbeRsp/AssocReq)

 *   input:  u8*	CapIE       //Capability IE to be printed out

 *	     u8*	TitleString //mainly print out caller function

 *  output:  none
@@ -151,7 +155,8 @@ void HTDebugHTCapability(u8 *CapIE, u8 *TitleString) 
}



/*

 *function:  This function print out each field on HT Information IE mainly from (Beacon/ProbeRsp)

 *function:  This function print out each field on HT Information

 *           IE mainly from (Beacon/ProbeRsp)

 *   input:  u8*	InfoIE       //Capability IE to be printed out

 *	     u8*	TitleString //mainly print out caller function

 *  output:  none
@@ -387,8 +392,9 @@ static void HTIOTPeerDetermine(struct ieee80211_device *ieee) 
}



/*

 *function:  Check whether driver should declare received rate up to MCS13 only since some chipset is not good

 *	     at receiving MCS14~15 frame from some AP.

 *function:  Check whether driver should declare received rate up to MCS13

 *           only since some chipset is not good at receiving MCS14~15 frame

 *           from some AP.

 *   input:  struct ieee80211_device*	ieee

 *	     u8 *			PeerMacAddr

 *  output:  none
@@ -402,7 +408,8 @@ static u8 HTIOTActIsDisableMCS14(struct ieee80211_device *ieee, u8 *PeerMacAddr) 
/*

 * Function:	HTIOTActIsDisableMCS15

 *

 * Overview:	Check whether driver should declare capability of receiving MCS15

 * Overview:	Check whether driver should declare capability of receiving

 *              MCS15

 *

 * Input:

 *			PADAPTER		Adapter,
@@ -439,7 +446,8 @@ static bool HTIOTActIsDisableMCS15(struct ieee80211_device *ieee) 
/*

 * Function:	HTIOTActIsDisableMCSTwoSpatialStream

 *

 * Overview:	Check whether driver should declare capability of receiving All 2 ss packets

 * Overview:	Check whether driver should declare capability of receiving

 *              All 2 ss packets

 *

 * Input:

 *			PADAPTER		Adapter,
@@ -462,7 +470,8 @@ static bool HTIOTActIsDisableMCSTwoSpatialStream(struct ieee80211_device *ieee, 
 *   input:  struct ieee80211_device*	ieee

 *	     u8*			PeerMacAddr

 *  output:  none

 *  return:  return 1 if driver should disable EDCA turbo mode(otherwise return 0)

 *  return:  return 1 if driver should disable EDCA turbo mode

 *           (otherwise return 0)

 */

static u8 HTIOTActIsDisableEDCATurbo(struct ieee80211_device *ieee,

				     u8 *PeerMacAddr)
@@ -471,7 +480,8 @@ static u8 HTIOTActIsDisableEDCATurbo(struct ieee80211_device *ieee, 
}



/*

 *function:  Check whether we need to use OFDM to sned MGNT frame for broadcom AP

 *function:  Check whether we need to use OFDM to sned MGNT frame for

 *           broadcom AP

 *   input:  struct ieee80211_network *network   //current network we live

 *  output:  none

 *  return:  return 1 if true
@@ -612,7 +622,10 @@ void HTConstructCapabilityElement(struct ieee80211_device *ieee, u8 *posHTCap, u 


//	IEEE80211_DEBUG_DATA(IEEE80211_DL_DATA | IEEE80211_DL_HT, posHTCap, *len -2);



	//Print each field in detail. Driver should not print out this message by default

	/*

	 * Print each field in detail. Driver should not print out this message

	 * by default

	 */

//	HTDebugHTCapability(posHTCap, (u8*)"HTConstructCapability()");

}
@@ -624,7 +637,8 @@ void HTConstructCapabilityElement(struct ieee80211_device *ieee, u8 *posHTCap, u 
 *	     u8			     IsEncrypt //whether encrypt, needed further

 *  output:  none

 *  return:  none

 *  notice:  posHTCap can't be null and be initialized before. only AP and IBSS sta should do this

 *  notice:  posHTCap can't be null and be initialized before.

 *           Only AP and IBSS sta should do this

 */

void HTConstructInfoElement(struct ieee80211_device *ieee, u8 *posHTInfo, u8 *len, u8 IsEncrypt)

{
@@ -666,12 +680,13 @@ void HTConstructInfoElement(struct ieee80211_device *ieee, u8 *posHTInfo, u8 *le 
}



/*

 *  According to experiment, Realtek AP to STA (based on rtl8190) may achieve best performance

 *  if both STA and AP set limitation of aggregation size to 32K, that is, set AMPDU density to 2

 *  (Ref: IEEE 11n specification). However, if Realtek STA associates to other AP, STA should set

 *  limitation of aggregation size to 8K, otherwise, performance of traffic stream from STA to AP

 *  will be much less than the traffic stream from AP to STA if both of the stream runs concurrently

 *  at the same time.

 * According to experiment, Realtek AP to STA (based on rtl8190) may achieve

 * best performance if both STA and AP set limitation of aggregation size to

 * 32K, that is, set AMPDU density to 2 (Ref: IEEE 11n specification).

 * However, if Realtek STA associates to other AP, STA should set limitation of

 * aggregation size to 8K, otherwise, performance of traffic stream from STA to

 * AP will be much less than the traffic stream from AP to STA if both of the

 * stream runs concurrently at the same time.

 *

 *  Frame Format

 *  Element ID		Length		OUI		Type1		Reserved
@@ -856,8 +871,9 @@ static u8 HTFilterMCSRate(struct ieee80211_device *ieee, u8 *pSupportMCS, 
	// TODO: adjust our operational rate set  according to our channel bandwidth, STBC and Antenna number



	/*

	 * TODO: fill suggested rate adaptive rate index and give firmware info using Tx command packet

	 * we also shall suggested the first start rate set according to our singal strength

	 * TODO: fill suggested rate adaptive rate index and give firmware info

	 * using Tx command packet we also shall suggested the first start rate

	 * set according to our singal strength

	 */

	HT_PickMCSRate(ieee, pOperateMCS);
@@ -1016,7 +1032,8 @@ void HTOnAssocRsp(struct ieee80211_device *ieee) 
	/*

	 * Filter out unsupported HT rate for this AP

	 * Update RATR table

	 * This is only for 8190 ,8192 or later product which using firmware to handle rate adaptive mechanism.

	 * This is only for 8190 ,8192 or later product which using firmware to

	 * handle rate adaptive mechanism.

	 */



	/*
@@ -1053,7 +1070,9 @@ void HTSetConnectBwModeCallback(struct ieee80211_device *ieee); 
 *   input:  struct ieee80211_device*	ieee

 *  output:  none

 *  return:  none

 *  notice: This function is called when *  (1) MPInitialization Phase *  (2) Receiving of Deauthentication from AP

 *  notice: This function is called when

 *                                  *  (1) MPInitialization Phase

 *                                  *  (2) Receiving of Deauthentication from AP

 */

// TODO: Should this funciton be called when receiving of Disassociation?

void HTInitializeHTInfo(struct ieee80211_device *ieee)
@@ -1078,8 +1097,8 @@ void HTInitializeHTInfo(struct ieee80211_device *ieee) 
	/*

	 * CCK rate support

	 * This flag is set to true to support CCK rate by default.

	 * It will be affected by "pHTInfo->bRegSuppCCK" and AP capabilities only when associate to

	 * 11N BSS.

	 * It will be affected by "pHTInfo->bRegSuppCCK" and AP capabilities

	 * only when associate to 11N BSS.

	 */

	pHTInfo->bCurSuppCCK = true;
@@ -1143,7 +1162,8 @@ void HTInitializeBssDesc(PBSS_HT pBssHT) 
/*

 *function:  initialize Bss HT structure(struct PBSS_HT)

 *   input:  struct ieee80211_device	*ieee

 *	     struct ieee80211_network	*pNetwork //usually current network we are live in

 *	     struct ieee80211_network	*pNetwork //usually current network

 *                                                  we are live in

 *  output:  none

 *  return:  none

 *  notice: This function should ONLY be called before association
@@ -1303,10 +1323,10 @@ void HTSetConnectBwMode(struct ieee80211_device *ieee, HT_CHANNEL_WIDTH Bandwidt 
	pHTInfo->bSwBwInProgress = true;



	/*

	 * TODO: 2007.7.13 by Emily Wait 2000ms  in order to guarantee that switching

	 *   bandwidth is executed after scan is finished. It is a temporal solution

	 *   because software should ganrantee the last operation of switching bandwidth

	 *   is executed properlly.

	 * TODO: 2007.7.13 by Emily Wait 2000ms  in order to guarantee that

	 * switching bandwidth is executed after scan is finished. It is a

	 * temporal solution because software should ganrantee the last

	 * operation of switching bandwidth is executed properlly.

	 */

	HTSetConnectBwModeCallback(ieee);