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

Commit 159b023d authored by Alison Schofield's avatar Alison Schofield Committed by Greg Kroah-Hartman
Browse files

staging: r8723au: use kernel preferred style for commenting 



Reworked comments per kernel coding style to improve readability.

Corrects checkpatch.pl:
WARNING: Block comments use * on subsequent lines
WARNING: line over 80 characters

Signed-off-by: default avatarAlison Schofield <amsfield22@gmail.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent f79dc167

drivers/staging/rtl8723au/core/rtw_efuse.c

+60 −182
Original line number Diff line number Diff line
@@ -21,34 +21,17 @@ 
#include <rtl8723a_hal.h>

#include <usb_ops_linux.h>



/*------------------------Define local variable------------------------------*/



/*  */

#define REG_EFUSE_CTRL		0x0030

#define EFUSE_CTRL			REG_EFUSE_CTRL		/*  E-Fuse Control. */

/*  */

#define EFUSE_CTRL		REG_EFUSE_CTRL	/* E-Fuse Control */



#define VOLTAGE_V25		0x03

#define LDOE25_SHIFT		28



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

 * Function:	Efuse_PowerSwitch

 *

 * Overview:	When we want to enable write operation, we should change to

/*

 * When we want to enable write operation, we should change to

 * pwr on state. When we stop write, we should switch to 500k mode

 * and disable LDO 2.5V.

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 11/17/2008	MHC		Create Version 0.

 *

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

 */

static void Efuse_PowerSwitch(struct rtw_adapter *padapter,

			      u8 bWrite, u8 PwrState)

{
@@ -58,8 +41,10 @@ static void Efuse_PowerSwitch(struct rtw_adapter *padapter, 
	if (PwrState == true) {

		rtl8723au_write8(padapter, REG_EFUSE_ACCESS, EFUSE_ACCESS_ON);



		/*  1.2V Power: From VDDON with Power

		    Cut(0x0000h[15]), default valid */

		/*

		 * 1.2V Power: From VDDON with Power

		 * Cut(0x0000h[15]), default valid

		 */

		tmpV16 = rtl8723au_read16(padapter, REG_SYS_ISO_CTRL);

		if (!(tmpV16 & PWC_EV12V)) {

			tmpV16 |= PWC_EV12V;
@@ -72,8 +57,10 @@ static void Efuse_PowerSwitch(struct rtw_adapter *padapter, 
			rtl8723au_write16(padapter, REG_SYS_FUNC_EN, tmpV16);

		}



		/*  Clock: Gated(0x0008h[5]) 8M(0x0008h[1]) clock

		    from ANA, default valid */

		/*

		 * Clock: Gated(0x0008h[5]) 8M(0x0008h[1])

		 * clock from ANA, default valid

		 */

		tmpV16 = rtl8723au_read16(padapter, REG_SYS_CLKR);

		if ((!(tmpV16 & LOADER_CLK_EN)) || (!(tmpV16 & ANA8M))) {

			tmpV16 |= (LOADER_CLK_EN | ANA8M);
@@ -113,24 +100,19 @@ Efuse_GetCurrentSize23a(struct rtw_adapter *pAdapter, u8 efuseType) 
	return ret;

}



/*  11/16/2008 MH Add description. Get current efuse area enabled word!!. */

/* Get current efuse area enabled word */

u8

Efuse_CalculateWordCnts23a(u8 word_en)

{

	return hweight8((~word_en) & 0xf);

}



/*  */

/*	Description: */

/*		Execute E-Fuse read byte operation. */

/*		Referred from SD1 Richard. */

/*  */

/*	Assumption: */

/*		1. Boot from E-Fuse and successfully auto-load. */

/*		2. PASSIVE_LEVEL (USB interface) */

/*  */

/*	Created by Roger, 2008.10.21. */

/*  */

/*

 * Description: Execute E-Fuse read byte operation.

 *

 * Assumptions: 1. Boot from E-Fuse and successfully auto-load.

 *              2. PASSIVE_LEVEL (USB interface)

 */

void

ReadEFuseByte23a(struct rtw_adapter *Adapter, u16 _offset, u8 *pbuf)

{
@@ -156,10 +138,13 @@ ReadEFuseByte23a(struct rtw_adapter *Adapter, u16 _offset, u8 *pbuf) 
		retry++;

	}



	/*  20100205 Joseph: Add delay suggested by SD1 Victor. */

	/*  This fix the problem that Efuse read error in high temperature condition. */

	/*  Designer says that there shall be some delay after ready bit is set, or the */

	/*  result will always stay on last data we read. */

	/*

	 * Added suggested delay. This fixes the problem that

	 * Efuse read error in high temperature condition.

	 * Designer says that there shall be some delay after

	 * ready bit is set, or the result will always stay

	 * on last data we read.

	 */

	udelay(50);

	value32 = rtl8723au_read32(Adapter, EFUSE_CTRL);
@@ -249,22 +234,7 @@ EFUSE_GetEfuseDefinition23a(struct rtw_adapter *pAdapter, u8 efuseType, 
	}

}



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

 * Function:	EFUSE_Read1Byte23a

 *

 * Overview:	Copy from WMAC fot EFUSE read 1 byte.

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 09/23/2008	MHC		Copy from WMAC.

 *

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

/* Copy from WMAC for EFUSE read 1 byte. */

u8

EFUSE_Read1Byte23a(struct rtw_adapter *Adapter, u16 Address)

{
@@ -306,25 +276,9 @@ EFUSE_Read1Byte23a(struct rtw_adapter *Adapter, u16 Address) 
		return data;

	} else

		return 0xFF;

}/* EFUSE_Read1Byte23a */



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

 * Function:	EFUSE_Write1Byte

 *

 * Overview:	Copy from WMAC fot EFUSE write 1 byte.

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 09/23/2008	MHC		Copy from WMAC.

 *

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

}



/* Copy from WMAC fot EFUSE write 1 byte. */

void

EFUSE_Write1Byte(struct rtw_adapter *Adapter, u16 Address, u8 Value);

void
@@ -367,16 +321,16 @@ EFUSE_Write1Byte(struct rtw_adapter *Adapter, u16 Address, u8 Value) 
			}

		}

	}

}/* EFUSE_Write1Byte */

}



/*  11/16/2008 MH Read one byte from real Efuse. */

/* Read one byte from real Efuse. */

int

efuse_OneByteRead23a(struct rtw_adapter *pAdapter, u16 addr, u8 *data)

{

	u8	tmpidx = 0;

	int	bResult;



	/*  -----------------e-fuse reg ctrl --------------------------------- */

	/*  -----------------e-fuse reg ctrl ---------------------------- */

	/* address */

	rtl8723au_write8(pAdapter, EFUSE_CTRL+1, (u8)(addr&0xff));

	rtl8723au_write8(pAdapter, EFUSE_CTRL+2, ((u8)((addr>>8) &0x03)) |
@@ -396,7 +350,7 @@ efuse_OneByteRead23a(struct rtw_adapter *pAdapter, u16 addr, u8 *data) 
	return bResult;

}



/*  11/16/2008 MH Write one byte to reald Efuse. */

/* Write one byte to reald Efuse. */

int

efuse_OneByteWrite23a(struct rtw_adapter *pAdapter, u16 addr, u8 data)

{
@@ -405,7 +359,7 @@ efuse_OneByteWrite23a(struct rtw_adapter *pAdapter, u16 addr, u8 data) 


	/* return	0; */



	/*  -----------------e-fuse reg ctrl --------------------------------- */

	/*  -----------------e-fuse reg ctrl ------------------------- */

	/* address */

	rtl8723au_write8(pAdapter, EFUSE_CTRL+1, (u8)(addr&0xff));

	rtl8723au_write8(pAdapter, EFUSE_CTRL+2,
@@ -427,23 +381,7 @@ efuse_OneByteWrite23a(struct rtw_adapter *pAdapter, u16 addr, u8 data) 
	return bResult;

}



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

 * Function:	efuse_WordEnableDataRead23a

 *

 * Overview:	Read allowed word in current efuse section data.

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 11/16/2008	MHC		Create Version 0.

 * 11/21/2008	MHC		Fix Write bug when we only enable late word.

 *

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

/* Read allowed word in current efuse section data. */

void

efuse_WordEnableDataRead23a(u8	word_en,

			 u8	*sourdata,
@@ -477,9 +415,7 @@ static int efuse_write8(struct rtw_adapter *padapter, u16 address, u8 *value) 
	return efuse_OneByteWrite23a(padapter, address, *value);

}



/*

 * read/write raw efuse data

 */

/* read/write raw efuse data */

int rtw_efuse_access23a(struct rtw_adapter *padapter, u8 bWrite, u16 start_addr,

			u16 cnts, u8 *data)

{
@@ -523,7 +459,7 @@ int rtw_efuse_access23a(struct rtw_adapter *padapter, u8 bWrite, u16 start_addr, 


	return res;

}

/*  */



u16 efuse_GetMaxSize23a(struct rtw_adapter *padapter)

{

	u16 max_size;
@@ -532,7 +468,7 @@ u16 efuse_GetMaxSize23a(struct rtw_adapter *padapter) 
				 (void *)&max_size);

	return max_size;

}

/*  */



int rtw_efuse_map_read23a(struct rtw_adapter *padapter,

			  u16 addr, u16 cnts, u8 *data)

{
@@ -573,22 +509,7 @@ int rtw_BT_efuse_map_read23a(struct rtw_adapter *padapter, 
	return _SUCCESS;

}



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

 * Function:	Efuse_ReadAllMap

 *

 * Overview:	Read All Efuse content

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 11/11/2008	MHC		Create Version 0.

 *

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

/* Read All Efuse content */

void

Efuse_ReadAllMap(struct rtw_adapter *pAdapter, u8 efuseType, u8 *Efuse);

void
@@ -606,33 +527,21 @@ Efuse_ReadAllMap(struct rtw_adapter *pAdapter, u8 efuseType, u8 *Efuse) 
	Efuse_PowerSwitch(pAdapter, false, false);

}



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

 * Function:	efuse_ShadowRead1Byte

/*

 * Functions:	efuse_ShadowRead1Byte

 *		efuse_ShadowRead2Byte

 *		efuse_ShadowRead4Byte

 *

 * Overview:	Read from efuse init map by one/two/four bytes !!!!!

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 11/12/2008	MHC		Create Version 0.

 *

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

 * Read from efuse init map by one/two/four bytes

 */

static void

efuse_ShadowRead1Byte(struct rtw_adapter *pAdapter, u16 Offset, u8 *Value)

{

	struct eeprom_priv *pEEPROM = GET_EEPROM_EFUSE_PRIV(pAdapter);



	*Value = pEEPROM->efuse_eeprom_data[Offset];

}	/*  EFUSE_ShadowRead23a1Byte */

}



/* Read Two Bytes */

static void

efuse_ShadowRead2Byte(struct rtw_adapter *pAdapter, u16 Offset, u16 *Value)

{
@@ -640,9 +549,8 @@ efuse_ShadowRead2Byte(struct rtw_adapter *pAdapter, u16 Offset, u16 *Value) 


	*Value = pEEPROM->efuse_eeprom_data[Offset];

	*Value |= pEEPROM->efuse_eeprom_data[Offset+1]<<8;

}	/*  EFUSE_ShadowRead23a2Byte */

}



/* Read Four Bytes */

static void

efuse_ShadowRead4Byte(struct rtw_adapter *pAdapter, u16 Offset, u32 *Value)

{
@@ -652,24 +560,10 @@ efuse_ShadowRead4Byte(struct rtw_adapter *pAdapter, u16 Offset, u32 *Value) 
	*Value |= pEEPROM->efuse_eeprom_data[Offset+1]<<8;

	*Value |= pEEPROM->efuse_eeprom_data[Offset+2]<<16;

	*Value |= pEEPROM->efuse_eeprom_data[Offset+3]<<24;

}	/*  efuse_ShadowRead4Byte */

}



/* Transfer current EFUSE content to shadow init and modify map. */



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

 * Function:	EFUSE_ShadowMapUpdate23a

 *

 * Overview:	Transfer current EFUSE content to shadow init and modify map.

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 11/13/2008	MHC		Create Version 0.

 *

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

void EFUSE_ShadowMapUpdate23a(struct rtw_adapter *pAdapter, u8 efuseType)

{

	struct eeprom_priv *pEEPROM = GET_EEPROM_EFUSE_PRIV(pAdapter);
@@ -683,25 +577,9 @@ void EFUSE_ShadowMapUpdate23a(struct rtw_adapter *pAdapter, u8 efuseType) 
	else

		Efuse_ReadAllMap(pAdapter, efuseType,

				 pEEPROM->efuse_eeprom_data);

}



}/*  EFUSE_ShadowMapUpdate23a */



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

 * Function:	EFUSE_ShadowRead23a

 *

 * Overview:	Read from efuse init map !!!!!

 *

 * Input:       NONE

 *

 * Output:      NONE

 *

 * Return:      NONE

 *

 * Revised History:

 * When			Who		Remark

 * 11/12/2008	MHC		Create Version 0.

 *

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

/* Read from efuse init map */

void

EFUSE_ShadowRead23a(struct rtw_adapter *pAdapter,

		    u8 Type, u16 Offset, u32 *Value)
@@ -712,4 +590,4 @@ EFUSE_ShadowRead23a(struct rtw_adapter *pAdapter, 
		efuse_ShadowRead2Byte(pAdapter, Offset, (u16 *)Value);

	else if (Type == 4)

		efuse_ShadowRead4Byte(pAdapter, Offset, (u32 *)Value);

}	/*  EFUSE_ShadowRead23a */
 
}