Staging: rt28x0: fix comments in chip/mac_pci.h

Signed-off-by: Bartlomiej Zolnierkiewicz <bzolnier@gmail.com>
Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
This commit is contained in:
Bartlomiej Zolnierkiewicz 2009-11-09 17:19:45 +01:00 committed by Greg Kroah-Hartman
parent ee1f1fa407
commit 956cd45d03

View File

@ -43,10 +43,10 @@
#include "../rtmp_iface.h" #include "../rtmp_iface.h"
#include "../rtmp_dot11.h" #include "../rtmp_dot11.h"
// /* */
// Device ID & Vendor ID related definitions, /* Device ID & Vendor ID related definitions, */
// NOTE: you should not add the new VendorID/DeviceID here unless you not sure it belongs to what chip. /* NOTE: you should not add the new VendorID/DeviceID here unless you not sure it belongs to what chip. */
// /* */
#define NIC_PCI_VENDOR_ID 0x1814 #define NIC_PCI_VENDOR_ID 0x1814
#define PCIBUS_INTEL_VENDOR 0x8086 #define PCIBUS_INTEL_VENDOR 0x8086
@ -66,22 +66,22 @@
#define AUX_CTRL 0x10c #define AUX_CTRL 0x10c
// /* */
// TX descriptor format, Tx ring, Mgmt Ring /* TX descriptor format, Tx ring, Mgmt Ring */
// /* */
struct PACKED rt_txd { struct PACKED rt_txd {
// Word 0 /* Word 0 */
u32 SDPtr0; u32 SDPtr0;
// Word 1 /* Word 1 */
u32 SDLen1:14; u32 SDLen1:14;
u32 LastSec1:1; u32 LastSec1:1;
u32 Burst:1; u32 Burst:1;
u32 SDLen0:14; u32 SDLen0:14;
u32 LastSec0:1; u32 LastSec0:1;
u32 DMADONE:1; u32 DMADONE:1;
//Word2 /*Word2 */
u32 SDPtr1; u32 SDPtr1;
//Word3 /*Word3 */
u32 rsv2:24; u32 rsv2:24;
u32 WIV:1; /* Wireless Info Valid. 1 if Driver already fill WI, o if DMA needs to copy WI to correctposition */ u32 WIV:1; /* Wireless Info Valid. 1 if Driver already fill WI, o if DMA needs to copy WI to correctposition */
u32 QSEL:2; /* select on-chip FIFO ID for 2nd-stage output scheduler.0:MGMT, 1:HCCA 2:EDCA */ u32 QSEL:2; /* select on-chip FIFO ID for 2nd-stage output scheduler.0:MGMT, 1:HCCA 2:EDCA */
@ -91,21 +91,21 @@ struct PACKED rt_txd {
u32 ICO:1; /* */ u32 ICO:1; /* */
}; };
// /* */
// Rx descriptor format, Rx Ring /* Rx descriptor format, Rx Ring */
// /* */
typedef struct PACKED rt_rxd { typedef struct PACKED rt_rxd {
// Word 0 /* Word 0 */
u32 SDP0; u32 SDP0;
// Word 1 /* Word 1 */
u32 SDL1:14; u32 SDL1:14;
u32 Rsv:2; u32 Rsv:2;
u32 SDL0:14; u32 SDL0:14;
u32 LS0:1; u32 LS0:1;
u32 DDONE:1; u32 DDONE:1;
// Word 2 /* Word 2 */
u32 SDP1; u32 SDP1;
// Word 3 /* Word 3 */
u32 BA:1; u32 BA:1;
u32 DATA:1; u32 DATA:1;
u32 NULLDATA:1; u32 NULLDATA:1;
@ -141,9 +141,9 @@ typedef union _TX_ATTENUATION_CTRL_STRUC {
/* ----------------- EEPROM Related MACRO ----------------- */ /* ----------------- EEPROM Related MACRO ----------------- */
// 8051 firmware image for RT2860 - base address = 0x4000 /* 8051 firmware image for RT2860 - base address = 0x4000 */
#define FIRMWARE_IMAGE_BASE 0x2000 #define FIRMWARE_IMAGE_BASE 0x2000
#define MAX_FIRMWARE_IMAGE_SIZE 0x2000 // 8kbyte #define MAX_FIRMWARE_IMAGE_SIZE 0x2000 /* 8kbyte */
/* ----------------- Frimware Related MACRO ----------------- */ /* ----------------- Frimware Related MACRO ----------------- */
#define RTMP_WRITE_FIRMWARE(_pAd, _pFwImage, _FwLen) \ #define RTMP_WRITE_FIRMWARE(_pAd, _pFwImage, _FwLen) \
@ -222,25 +222,25 @@ typedef union _TX_ATTENUATION_CTRL_STRUC {
/* ----------------- RX Related MACRO ----------------- */ /* ----------------- RX Related MACRO ----------------- */
/* ----------------- ASIC Related MACRO ----------------- */ /* ----------------- ASIC Related MACRO ----------------- */
// reset MAC of a station entry to 0x000000000000 /* reset MAC of a station entry to 0x000000000000 */
#define RTMP_STA_ENTRY_MAC_RESET(pAd, Wcid) \ #define RTMP_STA_ENTRY_MAC_RESET(pAd, Wcid) \
AsicDelWcidTab(pAd, Wcid); AsicDelWcidTab(pAd, Wcid);
// add this entry into ASIC RX WCID search table /* add this entry into ASIC RX WCID search table */
#define RTMP_STA_ENTRY_ADD(pAd, pEntry) \ #define RTMP_STA_ENTRY_ADD(pAd, pEntry) \
AsicUpdateRxWCIDTable(pAd, pEntry->Aid, pEntry->Addr); AsicUpdateRxWCIDTable(pAd, pEntry->Aid, pEntry->Addr);
// add by johnli, fix "in_interrupt" error when call "MacTableDeleteEntry" in Rx tasklet /* add by johnli, fix "in_interrupt" error when call "MacTableDeleteEntry" in Rx tasklet */
// Set MAC register value according operation mode /* Set MAC register value according operation mode */
#define RTMP_UPDATE_PROTECT(pAd) \ #define RTMP_UPDATE_PROTECT(pAd) \
AsicUpdateProtect(pAd, 0, (ALLN_SETPROTECT), TRUE, 0); AsicUpdateProtect(pAd, 0, (ALLN_SETPROTECT), TRUE, 0);
// end johnli /* end johnli */
// remove Pair-wise key material from ASIC /* remove Pair-wise key material from ASIC */
#define RTMP_STA_ENTRY_KEY_DEL(pAd, BssIdx, Wcid) \ #define RTMP_STA_ENTRY_KEY_DEL(pAd, BssIdx, Wcid) \
AsicRemovePairwiseKeyEntry(pAd, BssIdx, (u8)Wcid); AsicRemovePairwiseKeyEntry(pAd, BssIdx, (u8)Wcid);
// add Client security information into ASIC WCID table and IVEIV table /* add Client security information into ASIC WCID table and IVEIV table */
#define RTMP_STA_SECURITY_INFO_ADD(pAd, apidx, KeyID, pEntry) \ #define RTMP_STA_SECURITY_INFO_ADD(pAd, apidx, KeyID, pEntry) \
RTMPAddWcidAttributeEntry(pAd, apidx, KeyID, \ RTMPAddWcidAttributeEntry(pAd, apidx, KeyID, \
pAd->SharedKey[apidx][KeyID].CipherAlg, pEntry); pAd->SharedKey[apidx][KeyID].CipherAlg, pEntry);
@ -257,7 +257,7 @@ typedef union _TX_ATTENUATION_CTRL_STRUC {
pAd->SharedKey[apidx][KeyID].CipherAlg, \ pAd->SharedKey[apidx][KeyID].CipherAlg, \
pEntry); } pEntry); }
// Insert the BA bitmap to ASIC for the Wcid entry /* Insert the BA bitmap to ASIC for the Wcid entry */
#define RTMP_ADD_BA_SESSION_TO_ASIC(_pAd, _Aid, _TID) \ #define RTMP_ADD_BA_SESSION_TO_ASIC(_pAd, _Aid, _TID) \
do{ \ do{ \
u32 _Value = 0, _Offset; \ u32 _Value = 0, _Offset; \
@ -267,8 +267,8 @@ typedef union _TX_ATTENUATION_CTRL_STRUC {
RTMP_IO_WRITE32((_pAd), _Offset, _Value);\ RTMP_IO_WRITE32((_pAd), _Offset, _Value);\
}while(0) }while(0)
// Remove the BA bitmap from ASIC for the Wcid entry /* Remove the BA bitmap from ASIC for the Wcid entry */
// bitmap field starts at 0x10000 in ASIC WCID table /* bitmap field starts at 0x10000 in ASIC WCID table */
#define RTMP_DEL_BA_SESSION_FROM_ASIC(_pAd, _Wcid, _TID) \ #define RTMP_DEL_BA_SESSION_FROM_ASIC(_pAd, _Wcid, _TID) \
do{ \ do{ \
u32 _Value = 0, _Offset; \ u32 _Value = 0, _Offset; \
@ -280,10 +280,10 @@ typedef union _TX_ATTENUATION_CTRL_STRUC {
/* ----------------- Interface Related MACRO ----------------- */ /* ----------------- Interface Related MACRO ----------------- */
// /* */
// Enable & Disable NIC interrupt via writing interrupt mask register /* Enable & Disable NIC interrupt via writing interrupt mask register */
// Since it use ADAPTER structure, it have to be put after structure definition. /* Since it use ADAPTER structure, it have to be put after structure definition. */
// /* */
#define RTMP_ASIC_INTERRUPT_DISABLE(_pAd) \ #define RTMP_ASIC_INTERRUPT_DISABLE(_pAd) \
do{ \ do{ \
RTMP_IO_WRITE32((_pAd), INT_MASK_CSR, 0x0); /* 0: disable */ \ RTMP_IO_WRITE32((_pAd), INT_MASK_CSR, 0x0); /* 0: disable */ \
@ -324,7 +324,7 @@ typedef union _TX_ATTENUATION_CTRL_STRUC {
/* ----------------- Power Save Related MACRO ----------------- */ /* ----------------- Power Save Related MACRO ----------------- */
#define RTMP_PS_POLL_ENQUEUE(pAd) EnqueuePsPoll(pAd) #define RTMP_PS_POLL_ENQUEUE(pAd) EnqueuePsPoll(pAd)
// For RTMPPCIePowerLinkCtrlRestore () function /* For RTMPPCIePowerLinkCtrlRestore () function */
#define RESTORE_HALT 1 #define RESTORE_HALT 1
#define RESTORE_WAKEUP 2 #define RESTORE_WAKEUP 2
#define RESTORE_CLOSE 3 #define RESTORE_CLOSE 3
@ -352,4 +352,4 @@ typedef union _TX_ATTENUATION_CTRL_STRUC {
#define RTMP_MLME_RADIO_OFF(pAd) \ #define RTMP_MLME_RADIO_OFF(pAd) \
RT28xxPciMlmeRadioOFF(pAd); RT28xxPciMlmeRadioOFF(pAd);
#endif //__MAC_PCI_H__ // #endif /*__MAC_PCI_H__ // */