stdinclude.h

Atmel公司的USB无线局域网卡11 mbps Linux设备驱动

/**************************************************************************/
/*                                                                        */ 
/*            Copyright (c) 1999-2000 by Atmel Corporation		          */ 
/*                                                                        */ 
/*  This software is copyrighted by and is the sole property of Atmel	  */ 
/*  Corporation.  All rights, title, ownership, or other interests		  */ 
/*  in the software remain the property of Atmel Corporation.  This       */ 
/*  software may only be used in accordance with the corresponding        */ 
/*  license agreement.  Any un-authorized use, duplication, transmission, */ 
/*  distribution, or disclosure of this software is expressly forbidden.  */ 
/*                                                                        */
/*  This Copyright notice may not be removed or modified without prior    */ 
/*  written consent of Atmel Corporation.                                 */ 
/*                                                                        */ 
/*  Atmel Corporation, Inc. reserves the right to modify this software    */ 
/*  without notice.                                                       */ 
/*                                                                        */ 
/*  Atmel Corporation.                                                    */
/*  2325 Orchard Parkway               [e-mail]               */
/*  San Jose, CA 95131                 http://www.atmel.com               */
/*                                                                        */
/**************************************************************************/


/**************************************************************************/
/**************************************************************************/
/**                                                                       */ 
/** FastVNET (PCMCIA) NDIS Miniport Driver                                */ 
/**                                                                       */
/**   Standard Include File						                          */
/**                                                                       */
/**************************************************************************/
/**************************************************************************/



#ifndef __stdinclude_h_OK__
#define __stdinclude_h_OK__

#ifndef VNet_502_API
#define VNet_502_API
#endif

#define OUT_OF_RANGE_TIME_OUT				2000
#define	ASSOCIATION_RESPONSE_TIME_OUT		1000
#define	JOIN_TIME_OUT						1000

#define	MAX_AUTHENTICATION_RETRIES			3
#define	MAX_ASSOCIATION_RETRIES				3

//
// Offsets of some fields in frames
//
#define MGMT_FRAME_SA_OFFSET						10
#define DATA_FRAME_ADHOC_SA_OFFSET					10
#define DATA_FRAME_INFR_SA_OFFSET					16
#define DATA_FRAME_ADHOC_ADR3_OFFSET				16

#define BEACON_INTERVAL_OFFSET						8			//12+2
#define SSID_ELLEMENT_OFFSET						14			//12+2
#define SSID_ELLEMENT_LENGTH_OFFSET					13			//12+1
#define SUP_RATES_ELLEMENT_LENGTH_REL_OFFSET		15			//12+2+1
#define DS_PARAM_SET_ELLEMENT_REL_OFFSET			18			//12+2+2+2
#define BSSID_HEADER_OFFSET							16
#define MGMT_FRAME_BODY_OFFSET						24

#define WIRELESS_HEADER_ADDRESS3_OFFSET				16
#define CAPABILITY_INFO_IN_BEACON_OFFSET			10			
#define STATUS_IN_AUTHENTICATION_OFFSET				4			
#define TRANS_SEQ_NO_IN_AUTHENTICATION_OFFSET		2			
#define CHALL_TEXT_EL_ID_IN_AUTHENTICATION_OFFSET	6			
#define CHALL_TEXT_LENGTH_IN_AUTHENTICATION_OFFSET	7			
#define CHALL_TEXT_IN_AUTHENTICATION_OFFSET			8

#define STATUS_IN_ASSOCIATION_RESP_OFFSET			2			
#define ASS_ID_IN_ASSOCIATION_RESP_OFFSET			4
#define SUP_RATES_LENGTH_IN_ASSOCIATION_RESP_OFFSET	7
#define SUP_RATES_IN_ASSOCIATION_RESP_OFFSET		8

//////////////////////////////////
//	Functions in card.c
//////////////////////////////////

BOOLEAN
CardReset(PVNet_ADAPTER Adapter);

BOOLEAN 
CardGetHostInfo(PVNet_ADAPTER Adapter);

BOOLEAN 
CardStartUp(PVNet_ADAPTER Adapter);

VOID
CardStop(PVNet_ADAPTER Adapter);


//////////////////////////////////
//	Functions in command.c
//////////////////////////////////

UCHAR 
SendCommand(	PVNet_ADAPTER Adapter, 
				UCHAR CmdId, 
				PUCHAR pParameters);		    

BOOLEAN
SetChannel(PVNet_ADAPTER Adapter, UCHAR Channel);

BOOLEAN
SetDataFramesTxRate(PVNet_ADAPTER Adapter, UCHAR RateIndex);

BOOLEAN
SetRtsThreshold(PVNet_ADAPTER Adapter, USHORT Threshold);

BOOLEAN
SetFragmentationThreshold(PVNet_ADAPTER Adapter, USHORT Threshold);

BOOLEAN
SetPreambleType(PVNet_ADAPTER Adapter, UCHAR PreambleType);

BOOLEAN
SetCtrlFramesTxRate(PVNet_ADAPTER Adapter);

BOOLEAN
SetMgmtFramesTxRate(PVNet_ADAPTER Adapter);

BOOLEAN
SetSSIDsize(PVNet_ADAPTER Adapter, UCHAR size);

BOOLEAN 
GetStatistics(PVNet_ADAPTER Adapter, PUCHAR Statistics);

BOOLEAN
SetPowerMgmtMode(PVNet_ADAPTER Adapter, UCHAR PSmode);

BOOLEAN
SetAssociationID(PVNet_ADAPTER Adapter, USHORT AssocID);

BOOLEAN
SetSupportedRates(PVNet_ADAPTER Adapter, PUCHAR SupportedRates, UCHAR SupRatesLength);

UCHAR
Join(PVNet_ADAPTER Adapter, UCHAR Type);

UCHAR
Start(PVNet_ADAPTER Adapter, UCHAR Type);

BOOLEAN
Scan(PVNet_ADAPTER Adapter);

VOID
CommandCompleteDPC(PVNet_ADAPTER Adapter);

BOOLEAN
SetPromiscuousMode(PVNet_ADAPTER Adapter, UCHAR Mode);

BOOLEAN
SetMACaddress(PVNet_ADAPTER Adapter, PUCHAR MACaddress);


BOOLEAN
SetMibValues(PVNet_ADAPTER Adapter);

BOOLEAN 
GetBSSID(PVNet_ADAPTER Adapter, PUCHAR bssid);

//////////////////////////////////
//	Functions in flash.c
//////////////////////////////////

VOID 
WriteFlash8(PVNet_ADAPTER Adapter, ULONG Address, UCHAR Data);

VOID 
ReadFlash8(PVNet_ADAPTER Adapter, ULONG Address, PUCHAR pData);


BOOLEAN 
GetFlashSize(PVNet_ADAPTER Adapter);

VOID
GetFlashID(PVNet_ADAPTER Adapter, PUCHAR ManID, PUCHAR DevID);

VOID
EraseFlash(PVNet_ADAPTER Adapter);

BOOLEAN
BlankCheck(PVNet_ADAPTER Adapter);

BOOLEAN
DownloadBufferToFlash(PVNet_ADAPTER Adapter, ULONG bytes, PUCHAR data, ULONG sect_offset);

BOOLEAN
ProgramFlash(PVNet_ADAPTER Adapter);

VOID
GetCurrentCardInfo(PVNet_ADAPTER Adapter);

VOID 
EnterFlashIDMode(PVNet_ADAPTER Adapter); 


/////////////////////////////////////////////
// Functions in vnetwin.c, oidsman.c (Windows specific)
/////////////////////////////////////////////
#ifdef WINDOWS_OS
VNet_502_API NTSTATUS
DriverEntry(
    IN PDRIVER_OBJECT DriverObject,
    IN PUNICODE_STRING RegistryPath
    );


VNet_502_API NDIS_STATUS
VNetInitialize(
	OUT PNDIS_STATUS OpenErrorStatus,
    OUT PUINT SelectedMediumIndex,
    IN PNDIS_MEDIUM MediumArray,
    IN UINT MediumArraySize,
    IN NDIS_HANDLE MiniportAdapterHandle,
    IN NDIS_HANDLE ConfigurationHandle
    );

VNet_502_API VOID
VNetIsr(
			OUT PBOOLEAN InterruptRecognized,	
			OUT PBOOLEAN QueueDpc,				
			IN PVOID Context);
VNet_502_API VOID
VNetHandleInterrupt(
    IN NDIS_HANDLE MiniportAdapterContext);

VNet_502_API NDIS_STATUS
VNetTransferData(
    OUT PNDIS_PACKET Packet,
    OUT PUINT BytesTransferred,
    IN NDIS_HANDLE MiniportAdapterContext,
    IN NDIS_HANDLE MiniportReceiveContext,	
    IN UINT ByteOffset,						
    IN UINT BytesToTransfer					
    );

NDIS_STATUS
RegisterAdapter(
    IN PVNet_ADAPTER Adapter,			
    IN NDIS_HANDLE ConfigurationHandle	
    );


VNet_502_API NDIS_STATUS
VNetSend(
    IN NDIS_HANDLE MiniportAdapterContext,
    IN PNDIS_PACKET Packet,
    IN UINT Flags
    );
#ifndef UNDER_CE
NDIS_STATUS 
GetPCMCIAresources(
		IN NDIS_HANDLE WrapperConfigurationContext, 
		IN PVNet_ADAPTER Adapter);
#endif
NDIS_STATUS 
ParseRegistryParameters(	PVNet_ADAPTER Adapter, 
							NDIS_HANDLE ConfigurationHandle);

NDIS_STATUS
VNetReset(
    OUT PBOOLEAN AddressingReset,			
    IN NDIS_HANDLE MiniportAdapterContext	
    );

VOID
MgmtTimeOutHandler(	PVOID SysSpec1,
				NDIS_HANDLE MiniportAdapterContext,
				PVOID SysSpec2, 
				PVOID SysSpec3);

VNet_502_API VOID
VNetHalt(
    IN NDIS_HANDLE MiniportAdapterContext);



//	Functions in oidsman.c


NDIS_STATUS
VNetQueryInformation(
    IN NDIS_HANDLE MiniportAdapterContext,	
    IN NDIS_OID Oid,						
    IN PVOID InformationBuffer,				
    IN ULONG InformationBufferLength,		
    OUT PULONG BytesWritten,				
    OUT PULONG BytesNeeded					
											
);


NDIS_STATUS
VNetSetInformation(
    IN NDIS_HANDLE MiniportAdapterContext,	
    IN NDIS_OID Oid,						
    IN PVOID InformationBuffer,				
    IN ULONG InformationBufferLength,		
    OUT PULONG BytesRead,					
    OUT PULONG BytesNeeded					
	);										


VOID 
ReleaseResources( IN PVNet_ADAPTER Adapter );


VOID
RejectPendingTxPackets(Adapter);

VOID
PeriodicTimerHandler(	PVOID SysSpec1,
				NDIS_HANDLE MiniportAdapterContext,
				PVOID SysSpec2, 
				PVOID SysSpec3);

#ifdef WINXP

VOID VNetPnPEventNotify(
    IN  NDIS_HANDLE             MiniportAdapterContext,
    IN  NDIS_DEVICE_PNP_EVENT   PnPEvent,
    IN  PVOID                   InformationBuffer,
    IN  ULONG                   InformationBufferLength);

VOID VNetShutdown(
    IN  NDIS_HANDLE MiniportAdapterContext);

#endif //WINXP