[deliverable/linux.git] / drivers / staging / wlags49_h2 / hcf.h


//   vim:tw=110:ts=4:
#ifndef HCF_H
#define HCF_H 1

/************************************************************************************************************
*
* FILE	 : hcf.h
*
* DATE   : $Date: 2004/08/05 11:47:10 $   $Revision: 1.7 $
* Original: 2004/05/19 07:26:01    Revision: 1.56      Tag: hcf7_t20040602_01
* Original: 2004/05/12 08:47:23    Revision: 1.53      Tag: hcf7_t7_20040513_01
* Original: 2004/04/15 09:24:42    Revision: 1.46      Tag: hcf7_t7_20040415_01
* Original: 2004/04/08 15:18:16    Revision: 1.45      Tag: t7_20040413_01
* Original: 2004/04/01 15:32:55    Revision: 1.43      Tag: t7_20040401_01
* Original: 2004/03/10 15:39:28    Revision: 1.39      Tag: t20040310_01
* Original: 2004/03/04 11:03:38    Revision: 1.37      Tag: t20040304_01
* Original: 2004/03/02 14:51:21    Revision: 1.35      Tag: t20040302_03
* Original: 2004/02/24 13:00:28    Revision: 1.28      Tag: t20040224_01
* Original: 2004/02/09 14:50:14    Revision: 1.26      Tag: t20040219_01
*
* AUTHOR : Nico Valster
*
* SPECIFICATION: ..........
*
* DESC   : Definitions and Prototypes for MSF as well as HCF sources
*
*		   Customizable via HCFCFG.H
*
*
**************************************************************************************************************

**************************************************************************************************************
*
*
* SOFTWARE LICENSE
*
* This software is provided subject to the following terms and conditions,
* which you should read carefully before using the software.  Using this
* software indicates your acceptance of these terms and conditions.  If you do
* not agree with these terms and conditions, do not use the software.
*
* COPYRIGHT © 1994 - 1995	by AT&T.				All Rights Reserved
* COPYRIGHT © 1996 - 2000 by Lucent Technologies.	All Rights Reserved
* COPYRIGHT © 2001 - 2004	by Agere Systems Inc.	All Rights Reserved
* All rights reserved.
*
* Redistribution and use in source or binary forms, with or without
* modifications, are permitted provided that the following conditions are met:
*
* . Redistributions of source code must retain the above copyright notice, this
*    list of conditions and the following Disclaimer as comments in the code as
*    well as in the documentation and/or other materials provided with the
*    distribution.
*
* . Redistributions in binary form must reproduce the above copyright notice,
*    this list of conditions and the following Disclaimer in the documentation
*    and/or other materials provided with the distribution.
*
* . Neither the name of Agere Systems Inc. nor the names of the contributors
*    may be used to endorse or promote products derived from this software
*    without specific prior written permission.
*
* Disclaimer
*
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, INFRINGEMENT AND THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  ANY
* USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE IS SOLELY AT THE USERS OWN
* RISK. IN NO EVENT SHALL AGERE SYSTEMS INC. OR CONTRIBUTORS BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
* DAMAGE.
*
*
*************************************************************************************************************/


#include "hcfcfg.h"	// System Constants to be defined by the MSF-programmer to tailor the HCF
#include "mdd.h"	// Include file common for HCF, MSF


/************************************************************************************************/
/**************************************  MACROS  ************************************************/
/************************************************************************************************/

#define LOF(x) 			(sizeof(x)/sizeof(hcf_16)-1)

/*	Endianness
 *	Little Endian (a.k.a. Intel), least significant byte first
 *	Big Endian (a.k.a. Motorola), most significant byte first
 *
 * The following macros are supplied
 *  o CNV_LITTLE_TO_SHORT(w)			interprets the 16-bits input value as Little Endian, returns an hcf_16
 * 	o CNV_BIG_TO_SHORT(w)				interprets the 16-bits input value as Big Endian, returns an hcf_16
 *
 */

/* To increase portability, use unsigned char and unsigned char * when accessing parts of larger
 * types to convert their Endianness
 */

#define CNV_END_SHORT(w)  (hcf_16)( ((hcf_16)(w) & 0x00FF) << 8 | ((hcf_16)(w) & 0xFF00) >> 8 )
#define CNV_END_LONG(dw)  (hcf_32)( (dw >> 24) | ((dw >> 8) & 0xff00) | ((dw << 8) & 0xff0000) | (dw << 24) )

#if HCF_BIG_ENDIAN
//******************************************** B I G   E N D I A N *******************************************
#define CNV_LITTLE_TO_SHORT(w)	CNV_END_SHORT(w)	//    endianness conversion needed
#define CNV_BIG_TO_SHORT(w)		(w)				// no endianness conversion needed
#define CNV_LITTLE_TO_LONG(dw)	CNV_END_LONG(dw)
#define CNV_LONG_TO_LITTLE(dw)	CNV_END_LONG(dw)
#else
//****************************************** L I T T L E   E N D I A N ****************************************
#define CNV_LITTLE_TO_SHORT(w) 	(w)				// no endianness conversion needed
#define CNV_BIG_TO_SHORT(w)		CNV_END_SHORT(w)	//    endianness conversion needed
#define CNV_LITTLE_TO_LONG(dw)	(dw)
#define CNV_LONG_TO_LITTLE(dw)	(dw)

#if defined HCF_ALIGN && HCF_ALIGN > 1
#define CNV_SHORTP_TO_LITTLE(pw)	((hcf_16)(*(hcf_8 *)pw)) 			| ((hcf_16)(*((hcf_8 *)pw+1)) << 8)
#define CNV_LONGP_TO_LITTLE(pdw)	((hcf_32)(*(hcf_8 *)pdw)) 			| ((hcf_32)(*((hcf_8 *)pdw+1)) << 8) 	| \
									((hcf_32)(*((hcf_8 *)pdw+2)) << 16) | ((hcf_32)(*((hcf_8 *)pdw+3)) << 24)
#else
#define CNV_LONGP_TO_LITTLE(pdw)	(*(hcf_32 *)pdw)
#define CNV_SHORTP_TO_LITTLE(pw)	(*(hcf_16 *)pw)
#endif

#endif // HCF_BIG_ENDIAN

// conversion macros which can be expressed in other macros
#define CNV_SHORT_TO_LITTLE(w)	CNV_LITTLE_TO_SHORT(w)
#define CNV_SHORT_TO_BIG(w)		CNV_BIG_TO_SHORT(w)

/************************************************************************************************/
/**************************************  END OF MACROS  *****************************************/
/************************************************************************************************/

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

// offsets Transmit/Receive Frame Structure
#define HFS_STAT				0x0000
#define HFS_SWSUP				0x0006					//SW Support
#define HFS_Q_INFO				0x0006					//Signal/Silence level
#define HFS_RATE				0x0008					//RxFlow/Rate
#define 	HFS_STAT_ERR		RX_STAT_ERR				//link "natural" HCF name to "natural" MSF name
#define HFS_TX_CNTL				0x0036
														// H-I     H-II
#define HFS_DAT_LEN				(HFS_ADDR_DEST - 2)		// 0x002C  0x0038
#define HFS_ADDR_DEST			0x003A					// 0x002E  0x003A
#define HFS_ADDR_SRC			(HFS_ADDR_DEST + 6)		// 0x0034  0x0040
#define HFS_LEN					(HFS_ADDR_SRC  + 6)		// 0x003A  0x0046
#define HFS_DAT					(HFS_LEN       + 2)		// 0x003C  0x0048
#define HFS_TYPE				(HFS_DAT       + 6)		// 0x0042  0x004E


//=============================  D E S C R I P T O R   S T R U C T U R E  ==============================
//;?MDD.H stuff ;?

#if HCF_BIG_ENDIAN
#define DESC_STRCT_CNT		0
#define DESC_STRCT_SIZE		1
#else
#define DESC_STRCT_CNT		1
#define DESC_STRCT_SIZE		0
#endif // HCF_BIG_ENDIAN

#define	BUF_CNT				buf_dim[DESC_STRCT_CNT]
#define	BUF_SIZE			buf_dim[DESC_STRCT_SIZE]

typedef struct DESC_STRCT {
	hcf_16					buf_dim[2];
	hcf_32					buf_phys_addr;
	hcf_32					next_desc_phys_addr;	// physical address of next descriptor
	hcf_32					desc_phys_addr;			// physical address of this descriptor
	struct DESC_STRCT 		*next_desc_addr;
	hcf_8	FAR				*buf_addr;
#if (HCF_EXT) & HCF_EXT_DESC_STRCT
	void FAR			   *DESC_MSFSup;			// pointer for arbitrary use by the MSF
#endif // HCF_DESC_STRCT_EXT
} DESC_STRCT;

#define HCF_DASA_SIZE			12							//size in bytes for DA/SA

#define DESC_CNT_MASK 			0x0FFF

#define GET_BUF_SIZE(descp)       ((descp)->BUF_SIZE)
#define GET_BUF_CNT(descp)        ((descp)->BUF_CNT)
#define SET_BUF_SIZE(descp, size) (descp)->BUF_SIZE = size;
#define SET_BUF_CNT(descp, count) (descp)->BUF_CNT = count;

//=========================================  T A L L I E S  ===================================================

typedef struct  {  //Hermes Tallies (IFB substructure)
  hcf_32	TxUnicastFrames;
  hcf_32	TxMulticastFrames;
  hcf_32	TxFragments;
  hcf_32	TxUnicastOctets;
  hcf_32	TxMulticastOctets;
  hcf_32	TxDeferredTransmissions;
  hcf_32	TxSingleRetryFrames;
  hcf_32	TxMultipleRetryFrames;
  hcf_32	TxRetryLimitExceeded;
  hcf_32	TxDiscards;
  hcf_32	RxUnicastFrames;
  hcf_32	RxMulticastFrames;
  hcf_32	RxFragments;
  hcf_32	RxUnicastOctets;
  hcf_32	RxMulticastOctets;
  hcf_32	RxFCSErrors;
  hcf_32	RxDiscardsNoBuffer;
  hcf_32	TxDiscardsWrongSA;
  hcf_32	RxWEPUndecryptable;
  hcf_32	RxMsgInMsgFragments;
  hcf_32	RxMsgInBadMsgFragments;
  hcf_32	RxDiscardsWEPICVError;
  hcf_32	RxDiscardsWEPExcluded;
#if (HCF_EXT) & HCF_EXT_TALLIES_FW
  hcf_32	TalliesExtra[32];
#endif // HCF_EXT_TALLIES_FW
} CFG_HERMES_TALLIES_STRCT;

typedef struct  {  //HCF Tallies (IFB substructure)
  hcf_32	NoBufInfo;  				//No buffer available for unsolicited Notify frame
  hcf_32	NoBufMB;					//No space available in MailBox
  hcf_32	MiscErr;					/* Command errors
  										 *  - time out on completion synchronous part Hermes Command
  										 *  - completed Hermes Command doesn't match original command
  										 *  - status of completed Hermes Command contains error bits
  										 */
#if (HCF_EXT) & HCF_EXT_TALLIES_FW
  hcf_32	EngCnt[8];
#endif // HCF_EXT_TALLIES_FW
} CFG_HCF_TALLIES_STRCT;

//Note this way to define ..._TAL_CNT implies that all tallies must keep the same (hcf_32) size
#if (HCF_TALLIES) & ( HCF_TALLIES_NIC | HCF_TALLIES_HCF )
#if (HCF_TALLIES) & HCF_TALLIES_NIC	//Hermes tally support
#define		HCF_NIC_TAL_CNT	(sizeof(CFG_HERMES_TALLIES_STRCT)/ sizeof(hcf_32))
#else
#define		HCF_NIC_TAL_CNT	0
#endif // HCF_TALLIES
#if (HCF_TALLIES) & HCF_TALLIES_HCF	//HCF tally support
#define		HCF_HCF_TAL_CNT	(sizeof(CFG_HCF_TALLIES_STRCT)   / sizeof(hcf_32))
#else
#define		HCF_HCF_TAL_CNT	0
#endif // HCF_TALLIES
#define HCF_TOT_TAL_CNT ( HCF_NIC_TAL_CNT + HCF_NIC_TAL_CNT )
#endif // HCF_TALLIES_NIC / HCF_TALLIES_HCF


/***********************************************************************************************************/
/********************************** I N T E R F A C E   B L O C K ******************************************/
/***********************************************************************************************************/

#define IFB_VERSION 0x0E	 			// initially 0, to be incremented by every IFB layout change

typedef struct  {
  hcf_io		IFB_IOBase;				// I/O address of Hermes chip as passed by MSF at hcf_connect call
  hcf_16		IFB_IORange;			// I/O Range used by Hermes chip
  hcf_16		IFB_DLMode;				// Download Mode state
  hcf_16		IFB_Cmd;				// cmd in progress flag, to be ack-ed before next cmd can be issued
  hcf_16		IFB_RxFID;				// FID of "current" RxFS (non-DMA mode)
//;?#if tx_delay option
  hcf_16		IFB_TxFID;				// fid storage during "delayed" send
//;?#endif tx_delay option
  hcf_16		IFB_RxLen;				//
  hcf_16		IFB_DefunctStat;		// BAP initialization or Cmd Completion failed
  hcf_16		IFB_ErrCmd;				// contents Status reg when error bits and/or mismatch in cmd_wait
  hcf_16		IFB_ErrQualifier;		// contents Resp0  reg when error bits and/or mismatch in cmd_wait
  hcf_16		IFB_lal;				// LookAhead Length
  wci_bufp		IFB_lap;				// LookAhead Buffer pointer
  hcf_16		IFB_LinkStat;			// Link Status
  hcf_16		IFB_DSLinkStat;			// Link Status, new strategy introduced for DeepSleep
  hcf_16		IFB_CarryIn;			// carry and carry-flag to move 1 byte from one get_frag to the next
  hcf_16		IFB_CarryOut;			// carry and carry-flag to move 1 byte from one put_frag to the next
  hcf_16		IFB_Version;			// IFB_VERSION, incremented by every SIGNIFICANT IFB layout change
  hcf_16		IFB_CardStat;			// NIC error / F/W incompatibility status
  hcf_16  		IFB_RscInd;				// non-DMA: TxFID available, DMA: always 1
  hcf_16		IFB_CntlOpt;			// flags: 32 bits I/O, DMA available, DMA enabled
  hcf_16		IFB_BusType;			// BusType, derived via CFG_NIC_BUS_TYPE
  CFG_FW_IDENTITY_STRCT	 IFB_FWIdentity; /* keep FWIdentity/Sup and PRIIdentity/Sup in sequence
										  * because of the (dumb) copy in init() */
#if defined MSF_COMPONENT_ID
  CFG_SUP_RANGE_STRCT	 IFB_FWSup;
  CFG_PRI_IDENTITY_STRCT IFB_PRIIdentity;
  CFG_SUP_RANGE_STRCT	 IFB_PRISup;
  CFG_SUP_RANGE_STRCT	 IFB_HSISup;
#endif // MSF_COMPONENT_ID
#if (HCF_EXT) & HCF_EXT_INFO_LOG
  RID_LOGP		IFB_RIDLogp;			// pointer to RID_LOG structure
#endif // HCF_EXT_INFO_LOG
#if HCF_PROT_TIME
  hcf_32	 	IFB_TickIni;			// initialization of S/W counter based protection loop
#endif // HCF_PROT_TIME
#if (HCF_EXT) & HCF_EXT_INT_TICK
  int			IFB_TickCnt;			// Hermes Timer Tick Counter
#endif // HCF_EXT_INT_TICK
  hcf_16 	   *IFB_MBp;				// pointer to the MailBox
  hcf_16		IFB_MBSize;				// size of the MailBox
  hcf_16		IFB_MBWp;				// zero-based write index into the MailBox
  hcf_16		IFB_MBRp;				// zero-based read  index into the MailBox
  hcf_16		IFB_MBInfoLen;			// contents of L-field of the oldest available MailBoxInfoBlock
#if (HCF_TYPE) & HCF_TYPE_WPA
  hcf_16		IFB_MICTxCntl;			// MIC bit and Key index in TxControl field of TxFS
  hcf_32		IFB_MICTxKey[2];		// calculating key
  hcf_32		IFB_MICTx[2];   	  	// Tx MIC calculation Engine state
  hcf_16		IFB_MICTxCarry;			// temp length, carries over from one Tx fragment to another
  hcf_16		IFB_MICRxCarry;			// temp length, carries over from one Rx fragment to another
  hcf_32		IFB_MICRxKey[4*2];		// 4 checking keys
  hcf_32		IFB_MICRx[2]; 	 		// Rx MIC calculation Engine state
#endif // HCF_TYPE_WPA
#if HCF_ASSERT
#if (HCF_ASSERT) & HCF_ASSERT_MB
  CFG_MB_INFO_RANGE1_STRCT	IFB_AssertStrct; // Add some complication to the HCF as prize for the new MSF I/F
#endif // HCF_ASSERT_MB
  										// target of above IFB_AssertStrct
  hcf_16		IFB_AssertLine;			//  - line number ( + encoded module name )
  hcf_16		IFB_AssertTrace;		//  - bit based trace of all hcf_.... invocations
  hcf_32		IFB_AssertQualifier;	//  - qualifier
  hcf_16		IFB_AssertLvl;			// Assert Filtering, Not yet implemented
  hcf_16		IFB_AssertWhere;		// Where parameter of the Assert macro
#if (HCF_ASSERT) & ( HCF_ASSERT_LNK_MSF_RTN | HCF_ASSERT_RT_MSF_RTN )
  MSF_ASSERT_RTNP	IFB_AssertRtn;		// MSF Assert Call back routine (inspired by GEF, DrDobbs Nov 1998 )
#endif // HCF_ASSERT_LNK_MSF_RTN
#if (HCF_ASSERT) & HCF_ASSERT_PRINTF	// engineering facilty intended as F/W debugging aid
   hcf_16       IFB_DbgPrintF_Cnt;
   CFG_FW_PRINTF_BUFFER_LOCATION_STRCT IFB_FwPfBuff;
#endif // HCF_ASSERT_PRINTF
#endif // HCF_ASSERT
  hcf_16 volatile IFB_IntOffCnt;		// 0xFFFF based HCF_ACT_INT_OFF nesting counter, DeepSleep flag
#if (HCF_TALLIES) & ( HCF_TALLIES_NIC | HCF_TALLIES_HCF )	//Hermes and/or HCF tally support
  hcf_32		IFB_Silly_you_should_align;	//;?
  hcf_16		IFB_TallyLen;			// Tally length (to build an LTV)
  hcf_16		IFB_TallyTyp;			// Tally Type (to build an LTV)
#endif // HCF_TALLIES_NIC / HCF_TALLIES_HCF
#if (HCF_TALLIES) & HCF_TALLIES_NIC		//Hermes tally support
  CFG_HERMES_TALLIES_STRCT	IFB_NIC_Tallies;
#endif // HCF_TALLIES_NIC
#if (HCF_TALLIES) & HCF_TALLIES_HCF		//HCF tally support
  CFG_HCF_TALLIES_STRCT		IFB_HCF_Tallies;
#endif // HCF_TALLIES_HCF
#if HCF_DMA
  //used for a pool of destination_address descriptor/buffers, used during tx encapsulation points to the
  //first/last descriptor in the descriptor chain, so we can easily remove and append a packet.
  DESC_STRCT	*IFB_FirstDesc[2];
  DESC_STRCT	*IFB_LastDesc[2];
  DESC_STRCT	*IFB_ConfinedDesc[2];	// pointers to descriptor used for host reclaim purposes.
  hcf_16		IFB_DmaPackets;			// HREG_EV_[TX/RX]DMA_DONE flags, reports DMA Frame availability to MSF
#endif // HCF_DMA
#if (HCF_EXT) & HCF_EXT_INT_TX_EX
  hcf_16		IFB_TxFsStat;			// Tx message monitoring
  hcf_16		IFB_TxFsGap[2];			//;?make this robust
  hcf_16		IFB_TxFsSwSup;
#endif // HCF_EXT_INT_TX_EX
  hcf_16		IFB_Magic;				/* "Magic" signature, to help the debugger interpret a memory dump
										 * also the last field cleared at hcf_connect
										 */
#if (HCF_EXT) & HCF_EXT_IFB_STRCT		// for usage by the MSF
  void FAR	   *IFB_MSFSup;				// pointer for arbitrary use by the MSF
#endif // HCF_EXT_IFB_STRCT_EXT
} IFB_STRCT;

typedef IFB_STRCT*	IFBP;


/***********************************************************************************************************/
/**********************   W C I    F U N C T I O N S    P R O T O T Y P E S   ******************************/
/***********************************************************************************************************/

EXTERN_C int		 hcf_action			(IFBP ifbp, hcf_16 cmd );
EXTERN_C int		 hcf_connect		(IFBP ifbp, hcf_io io_base );
EXTERN_C int		 hcf_get_info		(IFBP ifbp, LTVP ltvp );
EXTERN_C int		 hcf_service_nic	(IFBP ifbp, wci_bufp bufp, unsigned int len );
EXTERN_C int		 hcf_cntl			(IFBP ifbp, hcf_16 cmd );
EXTERN_C int		 hcf_put_info		(IFBP ifbp, LTVP ltvp );
EXTERN_C int		 hcf_rcv_msg		(IFBP ifbp, DESC_STRCT *descp, unsigned int offset );
EXTERN_C int		 hcf_send_msg       (IFBP ifbp, DESC_STRCT *dp, hcf_16 tx_cntl );
#if HCF_DMA
EXTERN_C void		 hcf_dma_tx_put 	(IFBP ifbp, DESC_STRCT *d, hcf_16 tx_cntl );
EXTERN_C DESC_STRCT* hcf_dma_tx_get		(IFBP ifbp );
EXTERN_C DESC_STRCT* hcf_dma_rx_get		(IFBP ifbp );
EXTERN_C void		 hcf_dma_rx_put		(IFBP ifbp, DESC_STRCT *d );
#endif // HCF_DMA
#if (HCF_ASSERT) & HCF_ASSERT_LNK_MSF_RTN
EXTERN_C void		 msf_assert	 		(unsigned int line_number, hcf_16 trace, hcf_32 qual );
#endif // HCF_ASSERT_LNK_MSF_RTN

#endif  // HCF_H
Commit	Line	Data
68c0bdff HG	1
	2	// vim:tw=110:ts=4:
	3	#ifndef HCF_H
	4	#define HCF_H 1
	5
	6	/************************************************************************************************************
	7	*
	8	* FILE : hcf.h
	9	*
	10	* DATE : $Date: 2004/08/05 11:47:10 $ $Revision: 1.7 $
	11	* Original: 2004/05/19 07:26:01 Revision: 1.56 Tag: hcf7_t20040602_01
	12	* Original: 2004/05/12 08:47:23 Revision: 1.53 Tag: hcf7_t7_20040513_01
	13	* Original: 2004/04/15 09:24:42 Revision: 1.46 Tag: hcf7_t7_20040415_01
	14	* Original: 2004/04/08 15:18:16 Revision: 1.45 Tag: t7_20040413_01
	15	* Original: 2004/04/01 15:32:55 Revision: 1.43 Tag: t7_20040401_01
	16	* Original: 2004/03/10 15:39:28 Revision: 1.39 Tag: t20040310_01
	17	* Original: 2004/03/04 11:03:38 Revision: 1.37 Tag: t20040304_01
	18	* Original: 2004/03/02 14:51:21 Revision: 1.35 Tag: t20040302_03
	19	* Original: 2004/02/24 13:00:28 Revision: 1.28 Tag: t20040224_01
	20	* Original: 2004/02/09 14:50:14 Revision: 1.26 Tag: t20040219_01
	21	*
	22	* AUTHOR : Nico Valster
	23	*
	24	* SPECIFICATION: ..........
	25	*
	26	* DESC : Definitions and Prototypes for MSF as well as HCF sources
	27	*
	28	* Customizable via HCFCFG.H
	29	*
	30	*
	31	**************************************************************************************************************
	32
	33	**************************************************************************************************************
	34	*
	35	*
	36	* SOFTWARE LICENSE
	37	*
	38	* This software is provided subject to the following terms and conditions,
	39	* which you should read carefully before using the software. Using this
	40	* software indicates your acceptance of these terms and conditions. If you do
	41	* not agree with these terms and conditions, do not use the software.
	42	*
d36b6910 AV	43	* COPYRIGHT © 1994 - 1995 by AT&T. All Rights Reserved
	44	* COPYRIGHT © 1996 - 2000 by Lucent Technologies. All Rights Reserved
	45	* COPYRIGHT © 2001 - 2004 by Agere Systems Inc. All Rights Reserved
68c0bdff HG	46	* All rights reserved.
	47	*
	48	* Redistribution and use in source or binary forms, with or without
	49	* modifications, are permitted provided that the following conditions are met:
	50	*
	51	* . Redistributions of source code must retain the above copyright notice, this
	52	* list of conditions and the following Disclaimer as comments in the code as
	53	* well as in the documentation and/or other materials provided with the
	54	* distribution.
	55	*
	56	* . Redistributions in binary form must reproduce the above copyright notice,
	57	* this list of conditions and the following Disclaimer in the documentation
	58	* and/or other materials provided with the distribution.
	59	*
	60	* . Neither the name of Agere Systems Inc. nor the names of the contributors
	61	* may be used to endorse or promote products derived from this software
	62	* without specific prior written permission.
	63	*
	64	* Disclaimer
	65	*
	66	* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
	67	* INCLUDING, BUT NOT LIMITED TO, INFRINGEMENT AND THE IMPLIED WARRANTIES OF
	68	* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. ANY
	69	* USE, MODIFICATION OR DISTRIBUTION OF THIS SOFTWARE IS SOLELY AT THE USERS OWN
	70	* RISK. IN NO EVENT SHALL AGERE SYSTEMS INC. OR CONTRIBUTORS BE LIABLE FOR ANY
	71	* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
	72	* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
	73	* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
	74	* ON ANY THEORY OF LIABILITY, INCLUDING, BUT NOT LIMITED TO, CONTRACT, STRICT
	75	* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
	76	* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
	77	* DAMAGE.
	78	*
	79	*
	80	*************************************************************************************************************/
	81
	82
	83	#include "hcfcfg.h" // System Constants to be defined by the MSF-programmer to tailor the HCF
	84	#include "mdd.h" // Include file common for HCF, MSF
	85
	86
	87	/************************************************************************************************/
	88	/************************************ MACROS **********************************************/
	89	/************************************************************************************************/
	90
	91	#define LOF(x) (sizeof(x)/sizeof(hcf_16)-1)
	92
a26c43a9	93	/* Endianness
68c0bdff HG	94	* Little Endian (a.k.a. Intel), least significant byte first
	95	* Big Endian (a.k.a. Motorola), most significant byte first
	96	*
	97	* The following macros are supplied
	98	* o CNV_LITTLE_TO_SHORT(w) interprets the 16-bits input value as Little Endian, returns an hcf_16
	99	* o CNV_BIG_TO_SHORT(w) interprets the 16-bits input value as Big Endian, returns an hcf_16
	100	*
	101	*/
	102
	103	/* To increase portability, use unsigned char and unsigned char * when accessing parts of larger
a26c43a9	104	* types to convert their Endianness
68c0bdff HG	105	*/
	106
	107	#define CNV_END_SHORT(w) (hcf_16)( ((hcf_16)(w) & 0x00FF) << 8 \| ((hcf_16)(w) & 0xFF00) >> 8 )
	108	#define CNV_END_LONG(dw) (hcf_32)( (dw >> 24) \| ((dw >> 8) & 0xff00) \| ((dw << 8) & 0xff0000) \| (dw << 24) )
	109
	110	#if HCF_BIG_ENDIAN
	111	//****************************************** B I G E N D I A N *****************************************
a26c43a9 MI	112	#define CNV_LITTLE_TO_SHORT(w) CNV_END_SHORT(w) // endianness conversion needed
a26c43a9 MI	113	#define CNV_BIG_TO_SHORT(w) (w) // no endianness conversion needed
68c0bdff HG	114	#define CNV_LITTLE_TO_LONG(dw) CNV_END_LONG(dw)
	115	#define CNV_LONG_TO_LITTLE(dw) CNV_END_LONG(dw)
	116	#else
	117	//**************************************** L I T T L E E N D I A N **************************************
a26c43a9 MI	118	#define CNV_LITTLE_TO_SHORT(w) (w) // no endianness conversion needed
a26c43a9 MI	119	#define CNV_BIG_TO_SHORT(w) CNV_END_SHORT(w) // endianness conversion needed
68c0bdff HG	120	#define CNV_LITTLE_TO_LONG(dw) (dw)
	121	#define CNV_LONG_TO_LITTLE(dw) (dw)
	122
	123	#if defined HCF_ALIGN && HCF_ALIGN > 1
	124	#define CNV_SHORTP_TO_LITTLE(pw) ((hcf_16)((hcf_8 )pw)) \| ((hcf_16)(((hcf_8 )pw+1)) << 8)
	125	#define CNV_LONGP_TO_LITTLE(pdw) ((hcf_32)((hcf_8 )pdw)) \| ((hcf_32)(((hcf_8 )pdw+1)) << 8) \| \
	126	((hcf_32)(((hcf_8 )pdw+2)) << 16) \| ((hcf_32)(((hcf_8 )pdw+3)) << 24)
	127	#else
	128	#define CNV_LONGP_TO_LITTLE(pdw) ((hcf_32 )pdw)
	129	#define CNV_SHORTP_TO_LITTLE(pw) ((hcf_16 )pw)
	130	#endif
	131
	132	#endif // HCF_BIG_ENDIAN
	133
	134	// conversion macros which can be expressed in other macros
	135	#define CNV_SHORT_TO_LITTLE(w) CNV_LITTLE_TO_SHORT(w)
	136	#define CNV_SHORT_TO_BIG(w) CNV_BIG_TO_SHORT(w)
	137
	138	/************************************************************************************************/
	139	/************************************ END OF MACROS ***************************************/
	140	/************************************************************************************************/
	141
	142	/***********************************************************************************************************/
	143	/*************** **************************************/
	144	/***********************************************************************************************************/
	145
	146	// offsets Transmit/Receive Frame Structure
	147	#define HFS_STAT 0x0000
	148	#define HFS_SWSUP 0x0006 //SW Support
	149	#define HFS_Q_INFO 0x0006 //Signal/Silence level
	150	#define HFS_RATE 0x0008 //RxFlow/Rate
	151	#define HFS_STAT_ERR RX_STAT_ERR //link "natural" HCF name to "natural" MSF name
	152	#define HFS_TX_CNTL 0x0036
	153	// H-I H-II
	154	#define HFS_DAT_LEN (HFS_ADDR_DEST - 2) // 0x002C 0x0038
	155	#define HFS_ADDR_DEST 0x003A // 0x002E 0x003A
	156	#define HFS_ADDR_SRC (HFS_ADDR_DEST + 6) // 0x0034 0x0040
	157	#define HFS_LEN (HFS_ADDR_SRC + 6) // 0x003A 0x0046
	158	#define HFS_DAT (HFS_LEN + 2) // 0x003C 0x0048
	159	#define HFS_TYPE (HFS_DAT + 6) // 0x0042 0x004E
	160
	161
	162	//============================= D E S C R I P T O R S T R U C T U R E ==============================
	163	//;?MDD.H stuff ;?
	164
	165	#if HCF_BIG_ENDIAN
	166	#define DESC_STRCT_CNT 0
	167	#define DESC_STRCT_SIZE 1
	168	#else
	169	#define DESC_STRCT_CNT 1
	170	#define DESC_STRCT_SIZE 0
	171	#endif // HCF_BIG_ENDIAN
	172
	173	#define BUF_CNT buf_dim[DESC_STRCT_CNT]
	174	#define BUF_SIZE buf_dim[DESC_STRCT_SIZE]
	175
	176	typedef struct DESC_STRCT {
	177	hcf_16 buf_dim[2];
	178	hcf_32 buf_phys_addr;
	179	hcf_32 next_desc_phys_addr; // physical address of next descriptor
	180	hcf_32 desc_phys_addr; // physical address of this descriptor
	181	struct DESC_STRCT *next_desc_addr;
	182	hcf_8 FAR *buf_addr;
	183	#if (HCF_EXT) & HCF_EXT_DESC_STRCT
184	void FAR *DESC_MSFSup; // pointer for arbitrary use by the MSF
185	#endif // HCF_DESC_STRCT_EXT
186	} DESC_STRCT;
187
188	#define HCF_DASA_SIZE 12 //size in bytes for DA/SA
189
190	#define DESC_CNT_MASK 0x0FFF
191
192	#define GET_BUF_SIZE(descp) ((descp)->BUF_SIZE)
193	#define GET_BUF_CNT(descp) ((descp)->BUF_CNT)
194	#define SET_BUF_SIZE(descp, size) (descp)->BUF_SIZE = size;
195	#define SET_BUF_CNT(descp, count) (descp)->BUF_CNT = count;
196
197	//========================================= T A L L I E S ===================================================
198
199	typedef struct { //Hermes Tallies (IFB substructure)
200	hcf_32 TxUnicastFrames;
201	hcf_32 TxMulticastFrames;
202	hcf_32 TxFragments;
203	hcf_32 TxUnicastOctets;
204	hcf_32 TxMulticastOctets;
205	hcf_32 TxDeferredTransmissions;
206	hcf_32 TxSingleRetryFrames;
207	hcf_32 TxMultipleRetryFrames;
208	hcf_32 TxRetryLimitExceeded;
209	hcf_32 TxDiscards;
210	hcf_32 RxUnicastFrames;
211	hcf_32 RxMulticastFrames;
212	hcf_32 RxFragments;
213	hcf_32 RxUnicastOctets;
214	hcf_32 RxMulticastOctets;
215	hcf_32 RxFCSErrors;
216	hcf_32 RxDiscardsNoBuffer;
217	hcf_32 TxDiscardsWrongSA;
218	hcf_32 RxWEPUndecryptable;
219	hcf_32 RxMsgInMsgFragments;
220	hcf_32 RxMsgInBadMsgFragments;
221	hcf_32 RxDiscardsWEPICVError;
222	hcf_32 RxDiscardsWEPExcluded;
223	#if (HCF_EXT) & HCF_EXT_TALLIES_FW
224	hcf_32 TalliesExtra[32];
225	#endif // HCF_EXT_TALLIES_FW
226	} CFG_HERMES_TALLIES_STRCT;
227
228	typedef struct { //HCF Tallies (IFB substructure)
229	hcf_32 NoBufInfo; //No buffer available for unsolicited Notify frame
230	hcf_32 NoBufMB; //No space available in MailBox
231	hcf_32 MiscErr; /* Command errors
232	* - time out on completion synchronous part Hermes Command
233	* - completed Hermes Command doesn't match original command
234	* - status of completed Hermes Command contains error bits
235	*/
236	#if (HCF_EXT) & HCF_EXT_TALLIES_FW
237	hcf_32 EngCnt[8];
238	#endif // HCF_EXT_TALLIES_FW
239	} CFG_HCF_TALLIES_STRCT;
240
241	//Note this way to define ..._TAL_CNT implies that all tallies must keep the same (hcf_32) size
242	#if (HCF_TALLIES) & ( HCF_TALLIES_NIC \| HCF_TALLIES_HCF )
243	#if (HCF_TALLIES) & HCF_TALLIES_NIC //Hermes tally support
244	#define HCF_NIC_TAL_CNT (sizeof(CFG_HERMES_TALLIES_STRCT)/ sizeof(hcf_32))
245	#else
246	#define HCF_NIC_TAL_CNT 0
247	#endif // HCF_TALLIES
248	#if (HCF_TALLIES) & HCF_TALLIES_HCF //HCF tally support
249	#define HCF_HCF_TAL_CNT (sizeof(CFG_HCF_TALLIES_STRCT) / sizeof(hcf_32))
250	#else
251	#define HCF_HCF_TAL_CNT 0
252	#endif // HCF_TALLIES
253	#define HCF_TOT_TAL_CNT ( HCF_NIC_TAL_CNT + HCF_NIC_TAL_CNT )
254	#endif // HCF_TALLIES_NIC / HCF_TALLIES_HCF
255
256
257	/***********************************************************************************************************/
258	/******************************** I N T E R F A C E B L O C K ****************************************/
259	/***********************************************************************************************************/
260
261	#define IFB_VERSION 0x0E // initially 0, to be incremented by every IFB layout change
262
263	typedef struct {
264	hcf_io IFB_IOBase; // I/O address of Hermes chip as passed by MSF at hcf_connect call
265	hcf_16 IFB_IORange; // I/O Range used by Hermes chip
266	hcf_16 IFB_DLMode; // Download Mode state
267	hcf_16 IFB_Cmd; // cmd in progress flag, to be ack-ed before next cmd can be issued
268	hcf_16 IFB_RxFID; // FID of "current" RxFS (non-DMA mode)
269	//;?#if tx_delay option
270	hcf_16 IFB_TxFID; // fid storage during "delayed" send
271	//;?#endif tx_delay option
272	hcf_16 IFB_RxLen; //
273	hcf_16 IFB_DefunctStat; // BAP initialization or Cmd Completion failed
274	hcf_16 IFB_ErrCmd; // contents Status reg when error bits and/or mismatch in cmd_wait
275	hcf_16 IFB_ErrQualifier; // contents Resp0 reg when error bits and/or mismatch in cmd_wait
276	hcf_16 IFB_lal; // LookAhead Length
277	wci_bufp IFB_lap; // LookAhead Buffer pointer
278	hcf_16 IFB_LinkStat; // Link Status
279	hcf_16 IFB_DSLinkStat; // Link Status, new strategy introduced for DeepSleep
280	hcf_16 IFB_CarryIn; // carry and carry-flag to move 1 byte from one get_frag to the next
281	hcf_16 IFB_CarryOut; // carry and carry-flag to move 1 byte from one put_frag to the next
282	hcf_16 IFB_Version; // IFB_VERSION, incremented by every SIGNIFICANT IFB layout change
283	hcf_16 IFB_CardStat; // NIC error / F/W incompatibility status
284	hcf_16 IFB_RscInd; // non-DMA: TxFID available, DMA: always 1
285	hcf_16 IFB_CntlOpt; // flags: 32 bits I/O, DMA available, DMA enabled
286	hcf_16 IFB_BusType; // BusType, derived via CFG_NIC_BUS_TYPE
287	CFG_FW_IDENTITY_STRCT IFB_FWIdentity; /* keep FWIdentity/Sup and PRIIdentity/Sup in sequence
288	* because of the (dumb) copy in init() */
289	#if defined MSF_COMPONENT_ID
290	CFG_SUP_RANGE_STRCT IFB_FWSup;
291	CFG_PRI_IDENTITY_STRCT IFB_PRIIdentity;
292	CFG_SUP_RANGE_STRCT IFB_PRISup;
293	CFG_SUP_RANGE_STRCT IFB_HSISup;
294	#endif // MSF_COMPONENT_ID
295	#if (HCF_EXT) & HCF_EXT_INFO_LOG
296	RID_LOGP IFB_RIDLogp; // pointer to RID_LOG structure
297	#endif // HCF_EXT_INFO_LOG
298	#if HCF_PROT_TIME
299	hcf_32 IFB_TickIni; // initialization of S/W counter based protection loop
300	#endif // HCF_PROT_TIME
301	#if (HCF_EXT) & HCF_EXT_INT_TICK
302	int IFB_TickCnt; // Hermes Timer Tick Counter
303	#endif // HCF_EXT_INT_TICK
68c0bdff HG	304	hcf_16 *IFB_MBp; // pointer to the MailBox
	305	hcf_16 IFB_MBSize; // size of the MailBox
	306	hcf_16 IFB_MBWp; // zero-based write index into the MailBox
	307	hcf_16 IFB_MBRp; // zero-based read index into the MailBox
	308	hcf_16 IFB_MBInfoLen; // contents of L-field of the oldest available MailBoxInfoBlock
68c0bdff HG	309	#if (HCF_TYPE) & HCF_TYPE_WPA
	310	hcf_16 IFB_MICTxCntl; // MIC bit and Key index in TxControl field of TxFS
	311	hcf_32 IFB_MICTxKey[2]; // calculating key
	312	hcf_32 IFB_MICTx[2]; // Tx MIC calculation Engine state
	313	hcf_16 IFB_MICTxCarry; // temp length, carries over from one Tx fragment to another
	314	hcf_16 IFB_MICRxCarry; // temp length, carries over from one Rx fragment to another
	315	hcf_32 IFB_MICRxKey[4*2]; // 4 checking keys
	316	hcf_32 IFB_MICRx[2]; // Rx MIC calculation Engine state
	317	#endif // HCF_TYPE_WPA
	318	#if HCF_ASSERT
	319	#if (HCF_ASSERT) & HCF_ASSERT_MB
	320	CFG_MB_INFO_RANGE1_STRCT IFB_AssertStrct; // Add some complication to the HCF as prize for the new MSF I/F
	321	#endif // HCF_ASSERT_MB
	322	// target of above IFB_AssertStrct
	323	hcf_16 IFB_AssertLine; // - line number ( + encoded module name )
	324	hcf_16 IFB_AssertTrace; // - bit based trace of all hcf_.... invocations
	325	hcf_32 IFB_AssertQualifier; // - qualifier
	326	hcf_16 IFB_AssertLvl; // Assert Filtering, Not yet implemented
	327	hcf_16 IFB_AssertWhere; // Where parameter of the Assert macro
	328	#if (HCF_ASSERT) & ( HCF_ASSERT_LNK_MSF_RTN \| HCF_ASSERT_RT_MSF_RTN )
	329	MSF_ASSERT_RTNP IFB_AssertRtn; // MSF Assert Call back routine (inspired by GEF, DrDobbs Nov 1998 )
	330	#endif // HCF_ASSERT_LNK_MSF_RTN
	331	#if (HCF_ASSERT) & HCF_ASSERT_PRINTF // engineering facilty intended as F/W debugging aid
	332	hcf_16 IFB_DbgPrintF_Cnt;
	333	CFG_FW_PRINTF_BUFFER_LOCATION_STRCT IFB_FwPfBuff;
	334	#endif // HCF_ASSERT_PRINTF
	335	#endif // HCF_ASSERT
68c0bdff	336	hcf_16 volatile IFB_IntOffCnt; // 0xFFFF based HCF_ACT_INT_OFF nesting counter, DeepSleep flag
68c0bdff HG	337	#if (HCF_TALLIES) & ( HCF_TALLIES_NIC \| HCF_TALLIES_HCF ) //Hermes and/or HCF tally support
	338	hcf_32 IFB_Silly_you_should_align; //;?
	339	hcf_16 IFB_TallyLen; // Tally length (to build an LTV)
	340	hcf_16 IFB_TallyTyp; // Tally Type (to build an LTV)
	341	#endif // HCF_TALLIES_NIC / HCF_TALLIES_HCF
	342	#if (HCF_TALLIES) & HCF_TALLIES_NIC //Hermes tally support
	343	CFG_HERMES_TALLIES_STRCT IFB_NIC_Tallies;
	344	#endif // HCF_TALLIES_NIC
	345	#if (HCF_TALLIES) & HCF_TALLIES_HCF //HCF tally support
	346	CFG_HCF_TALLIES_STRCT IFB_HCF_Tallies;
	347	#endif // HCF_TALLIES_HCF
	348	#if HCF_DMA
	349	//used for a pool of destination_address descriptor/buffers, used during tx encapsulation points to the
	350	//first/last descriptor in the descriptor chain, so we can easily remove and append a packet.
	351	DESC_STRCT *IFB_FirstDesc[2];
	352	DESC_STRCT *IFB_LastDesc[2];
	353	DESC_STRCT *IFB_ConfinedDesc[2]; // pointers to descriptor used for host reclaim purposes.
	354	hcf_16 IFB_DmaPackets; // HREG_EV_[TX/RX]DMA_DONE flags, reports DMA Frame availability to MSF
	355	#endif // HCF_DMA
	356	#if (HCF_EXT) & HCF_EXT_INT_TX_EX
	357	hcf_16 IFB_TxFsStat; // Tx message monitoring
	358	hcf_16 IFB_TxFsGap[2]; //;?make this robust
	359	hcf_16 IFB_TxFsSwSup;
	360	#endif // HCF_EXT_INT_TX_EX
	361	hcf_16 IFB_Magic; /* "Magic" signature, to help the debugger interpret a memory dump
	362	* also the last field cleared at hcf_connect
	363	*/
	364	#if (HCF_EXT) & HCF_EXT_IFB_STRCT // for usage by the MSF
	365	void FAR *IFB_MSFSup; // pointer for arbitrary use by the MSF
	366	#endif // HCF_EXT_IFB_STRCT_EXT
	367	} IFB_STRCT;
	368
	369	typedef IFB_STRCT* IFBP;
	370
	371
	372	/***********************************************************************************************************/
	373	/******************** W C I F U N C T I O N S P R O T O T Y P E S ****************************/
	374	/***********************************************************************************************************/
	375
	376	EXTERN_C int hcf_action (IFBP ifbp, hcf_16 cmd );
	377	EXTERN_C int hcf_connect (IFBP ifbp, hcf_io io_base );
68c0bdff HG	378	EXTERN_C int hcf_get_info (IFBP ifbp, LTVP ltvp );
	379	EXTERN_C int hcf_service_nic (IFBP ifbp, wci_bufp bufp, unsigned int len );
	380	EXTERN_C int hcf_cntl (IFBP ifbp, hcf_16 cmd );
	381	EXTERN_C int hcf_put_info (IFBP ifbp, LTVP ltvp );
	382	EXTERN_C int hcf_rcv_msg (IFBP ifbp, DESC_STRCT *descp, unsigned int offset );
	383	EXTERN_C int hcf_send_msg (IFBP ifbp, DESC_STRCT *dp, hcf_16 tx_cntl );
	384	#if HCF_DMA
	385	EXTERN_C void hcf_dma_tx_put (IFBP ifbp, DESC_STRCT *d, hcf_16 tx_cntl );
	386	EXTERN_C DESC_STRCT* hcf_dma_tx_get (IFBP ifbp );
	387	EXTERN_C DESC_STRCT* hcf_dma_rx_get (IFBP ifbp );
	388	EXTERN_C void hcf_dma_rx_put (IFBP ifbp, DESC_STRCT *d );
	389	#endif // HCF_DMA
	390	#if (HCF_ASSERT) & HCF_ASSERT_LNK_MSF_RTN
	391	EXTERN_C void msf_assert (unsigned int line_number, hcf_16 trace, hcf_32 qual );
	392	#endif // HCF_ASSERT_LNK_MSF_RTN
	393
	394	#endif // HCF_H
	395