drivers/staging/rt2860/rt2860.h

   1 /*
   2  *************************************************************************
   3  * Ralink Tech Inc.
   4  * 5F., No.36, Taiyuan St., Jhubei City,
   5  * Hsinchu County 302,
   6  * Taiwan, R.O.C.
   7  *
   8  * (c) Copyright 2002-2007, Ralink Technology, Inc.
   9  *
  10  * This program is free software; you can redistribute it and/or modify  *
  11  * it under the terms of the GNU General Public License as published by  *
  12  * the Free Software Foundation; either version 2 of the License, or     *
  13  * (at your option) any later version.                                   *
  14  *                                                                       *
  15  * This program is distributed in the hope that it will be useful,       *
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of        *
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
  18  * GNU General Public License for more details.                          *
  19  *                                                                       *
  20  * You should have received a copy of the GNU General Public License     *
  21  * along with this program; if not, write to the                         *
  22  * Free Software Foundation, Inc.,                                       *
  23  * 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
  24  *                                                                       *
  25  *************************************************************************
  26  */
  27
  28 #ifndef __RT2860_H__
  29 #define __RT2860_H__
  30
  31 #define RT28xx_CHIP_NAME        "RT2860"
  32
  33 #define TXINFO_SIZE               0
  34 #define TXPADDING_SIZE            0
  35
  36 /* ----------------- EEPROM Related MACRO ----------------- */
  37 #define RT28xx_EEPROM_READ16(pAd, offset, var)          \
  38         var = RTMP_EEPROM_READ16(pAd, offset)
  39
  40 #define RT28xx_EEPROM_WRITE16(pAd, offset, var)         \
  41         RTMP_EEPROM_WRITE16(pAd, offset, var)
  42
  43 /* ----------------- TASK/THREAD Related MACRO ----------------- */
  44 #define RT28XX_TASK_THREAD_INIT(pAd, Status)            \
  45         init_thread_task(pAd); NICInitTxRxRingAndBacklogQueue(pAd);     \
  46         Status = NDIS_STATUS_SUCCESS;
  47
  48 /* function declarations */
  49 #define IRQ_HANDLE_TYPE  irqreturn_t
  50
  51 IRQ_HANDLE_TYPE
  52 rt2860_interrupt(int irq, void *dev_instance);
  53
  54 /* ----------------- Frimware Related MACRO ----------------- */
  55 #define RT28XX_WRITE_FIRMWARE(_pAd, _pFwImage, _FwLen)                          \
  56         do{                                                                                                                             \
  57                 ULONG   _i, _firm;                                                                                      \
  58                 RTMP_IO_WRITE32(_pAd, PBF_SYS_CTRL, 0x10000);                           \
  59                                                                                                                                         \
  60                 for(_i=0; _i<_FwLen; _i+=4)                                                                     \
  61                 {                                                                                                                       \
  62                         _firm = _pFwImage[_i] +                                                                 \
  63                            (_pFwImage[_i+3] << 24) +                                                    \
  64                            (_pFwImage[_i+2] << 16) +                                                    \
  65                            (_pFwImage[_i+1] << 8);                                                              \
  66                         RTMP_IO_WRITE32(_pAd, FIRMWARE_IMAGE_BASE + _i, _firm); \
  67                 }                                                                                                                       \
  68                 RTMP_IO_WRITE32(_pAd, PBF_SYS_CTRL, 0x00000);                           \
  69                 RTMP_IO_WRITE32(_pAd, PBF_SYS_CTRL, 0x00001);                           \
  70                                                                                                                                         \
  71                 /* initialize BBP R/W access agent */                                           \
  72                 RTMP_IO_WRITE32(_pAd, H2M_BBP_AGENT, 0);                                        \
  73                 RTMP_IO_WRITE32(_pAd, H2M_MAILBOX_CSR, 0);                                      \
  74         }while(0)
  75
  76 /* ----------------- TX Related MACRO ----------------- */
  77 #define RT28XX_START_DEQUEUE(pAd, QueIdx, irqFlags)             do{}while(0)
  78 #define RT28XX_STOP_DEQUEUE(pAd, QueIdx, irqFlags)              do{}while(0)
  79
  80
  81 #define RT28XX_HAS_ENOUGH_FREE_DESC(pAd, pTxBlk, freeNum, pPacket) \
  82                 ((freeNum) >= (ULONG)(pTxBlk->TotalFragNum + RTMP_GET_PACKET_FRAGMENTS(pPacket) + 3)) /* rough estimate we will use 3 more descriptor. */
  83 #define RT28XX_RELEASE_DESC_RESOURCE(pAd, QueIdx)                                       \
  84                 do{}while(0)
  85
  86 #define NEED_QUEUE_BACK_FOR_AGG(pAd, QueIdx, freeNum, _TxFrameType) \
  87                 (((freeNum != (TX_RING_SIZE-1)) && (pAd->TxSwQueue[QueIdx].Number == 0)) || (freeNum<3))
  88                 //(((freeNum) != (TX_RING_SIZE-1)) && (pAd->TxSwQueue[QueIdx].Number == 1 /*0*/))
  89
  90
  91 #define HAL_KickOutMgmtTx(_pAd, _QueIdx, _pPacket, _pSrcBufVA, _SrcBufLen)      \
  92                         RtmpPCIMgmtKickOut(_pAd, _QueIdx, _pPacket, _pSrcBufVA, _SrcBufLen)
  93
  94 #define RTMP_PKT_TAIL_PADDING 0
  95
  96 #define fRTMP_ADAPTER_NEED_STOP_TX      0
  97
  98 #define HAL_WriteSubTxResource(pAd, pTxBlk, bIsLast, pFreeNumber)       \
  99                 /* RtmpPCI_WriteSubTxResource(pAd, pTxBlk, bIsLast, pFreeNumber)*/
 100
 101 #define HAL_WriteTxResource(pAd, pTxBlk,bIsLast, pFreeNumber)   \
 102                         RtmpPCI_WriteSingleTxResource(pAd, pTxBlk, bIsLast, pFreeNumber)
 103
 104 #define HAL_WriteFragTxResource(pAd, pTxBlk, fragNum, pFreeNumber) \
 105                         RtmpPCI_WriteFragTxResource(pAd, pTxBlk, fragNum, pFreeNumber)
 106
 107 #define HAL_WriteMultiTxResource(pAd, pTxBlk,frameNum, pFreeNumber)     \
 108                         RtmpPCI_WriteMultiTxResource(pAd, pTxBlk, frameNum, pFreeNumber)
 109
 110 #define HAL_FinalWriteTxResource(_pAd, _pTxBlk, _TotalMPDUSize, _FirstTxIdx)    \
 111                         RtmpPCI_FinalWriteTxResource(_pAd, _pTxBlk, _TotalMPDUSize, _FirstTxIdx)
 112
 113 #define HAL_LastTxIdx(_pAd, _QueIdx,_LastTxIdx) \
 114                         /*RtmpPCIDataLastTxIdx(_pAd, _QueIdx,_LastTxIdx)*/
 115
 116 #define HAL_KickOutTx(_pAd, _pTxBlk, _QueIdx)   \
 117                         RTMP_IO_WRITE32((_pAd), TX_CTX_IDX0+((_QueIdx)*0x10), (_pAd)->TxRing[(_QueIdx)].TxCpuIdx)
 118 /*                      RtmpPCIDataKickOut(_pAd, _pTxBlk, _QueIdx)*/
 119
 120 #define HAL_KickOutNullFrameTx(_pAd, _QueIdx, _pNullFrame, _frameLen)   \
 121                         MiniportMMRequest(_pAd, _QueIdx, _pNullFrame, _frameLen)
 122
 123 #define GET_TXRING_FREENO(_pAd, _QueIdx) \
 124         (_pAd->TxRing[_QueIdx].TxSwFreeIdx > _pAd->TxRing[_QueIdx].TxCpuIdx)    ? \
 125                         (_pAd->TxRing[_QueIdx].TxSwFreeIdx - _pAd->TxRing[_QueIdx].TxCpuIdx - 1) \
 126                          :      \
 127                         (_pAd->TxRing[_QueIdx].TxSwFreeIdx + TX_RING_SIZE - _pAd->TxRing[_QueIdx].TxCpuIdx - 1);
 128
 129
 130 #define GET_MGMTRING_FREENO(_pAd) \
 131         (_pAd->MgmtRing.TxSwFreeIdx > _pAd->MgmtRing.TxCpuIdx)  ? \
 132                         (_pAd->MgmtRing.TxSwFreeIdx - _pAd->MgmtRing.TxCpuIdx - 1) \
 133                          :      \
 134                         (_pAd->MgmtRing.TxSwFreeIdx + MGMT_RING_SIZE - _pAd->MgmtRing.TxCpuIdx - 1);
 135
 136
 137 /* ----------------- RX Related MACRO ----------------- */
 138
 139 // no use
 140 #define RT28XX_RCV_PKT_GET_INIT(pAd)
 141 #define RT28XX_RV_A_BUF_END
 142 //#define RT28XX_RV_ALL_BUF_END
 143
 144
 145 /* ----------------- ASIC Related MACRO ----------------- */
 146 // no use
 147 #define RT28XX_DMA_POST_WRITE(pAd)
 148
 149 // reset MAC of a station entry to 0x000000000000
 150 #define RT28XX_STA_ENTRY_MAC_RESET(pAd, Wcid)                                           \
 151         AsicDelWcidTab(pAd, Wcid);
 152
 153 // add this entry into ASIC RX WCID search table
 154 #define RT28XX_STA_ENTRY_ADD(pAd, pEntry)                                                       \
 155         AsicUpdateRxWCIDTable(pAd, pEntry->Aid, pEntry->Addr);
 156
 157 // remove Pair-wise key material from ASIC
 158 #define RT28XX_STA_ENTRY_KEY_DEL(pAd, BssIdx, Wcid)                                     \
 159         AsicRemovePairwiseKeyEntry(pAd, BssIdx, (UCHAR)Wcid);
 160
 161 // add Client security information into ASIC WCID table and IVEIV table
 162 #define RT28XX_STA_SECURITY_INFO_ADD(pAd, apidx, KeyID, pEntry)         \
 163         RTMPAddWcidAttributeEntry(pAd, apidx, KeyID,                                    \
 164                                                         pAd->SharedKey[apidx][KeyID].CipherAlg, pEntry);
 165
 166 #define RT28XX_SECURITY_KEY_ADD(pAd, apidx, KeyID, pEntry)                              \
 167         {       /* update pairwise key information to ASIC Shared Key Table */  \
 168                 AsicAddSharedKeyEntry(pAd, apidx, KeyID,                                                \
 169                                                   pAd->SharedKey[apidx][KeyID].CipherAlg,               \
 170                                                   pAd->SharedKey[apidx][KeyID].Key,                             \
 171                                                   pAd->SharedKey[apidx][KeyID].TxMic,                   \
 172                                                   pAd->SharedKey[apidx][KeyID].RxMic);                  \
 173                 /* update ASIC WCID attribute table and IVEIV table */                  \
 174                 RTMPAddWcidAttributeEntry(pAd, apidx, KeyID,                                    \
 175                                                   pAd->SharedKey[apidx][KeyID].CipherAlg,               \
 176                                                   pEntry); }
 177
 178
 179 // Insert the BA bitmap to ASIC for the Wcid entry
 180 #define RT28XX_ADD_BA_SESSION_TO_ASIC(_pAd, _Aid, _TID)                                 \
 181                 do{                                                                                                                             \
 182                         UINT32  _Value = 0, _Offset;                                                                    \
 183                         _Offset = MAC_WCID_BASE + (_Aid) * HW_WCID_ENTRY_SIZE + 4;      \
 184                         RTMP_IO_READ32((_pAd), _Offset, &_Value);                                       \
 185                         _Value |= (0x10000<<(_TID));                                                            \
 186                         RTMP_IO_WRITE32((_pAd), _Offset, _Value);                                       \
 187                 }while(0)
 188
 189
 190 // Remove the BA bitmap from ASIC for the Wcid entry
 191 //              bitmap field starts at 0x10000 in ASIC WCID table
 192 #define RT28XX_DEL_BA_SESSION_FROM_ASIC(_pAd, _Wcid, _TID)                              \
 193                 do{                                                                                                                             \
 194                         UINT32  _Value = 0, _Offset;                                                                    \
 195                         _Offset = MAC_WCID_BASE + (_Wcid) * HW_WCID_ENTRY_SIZE + 4;     \
 196                         RTMP_IO_READ32((_pAd), _Offset, &_Value);                                       \
 197                         _Value &= (~(0x10000 << (_TID)));                                                       \
 198                         RTMP_IO_WRITE32((_pAd), _Offset, _Value);                       \
 199                 }while(0)
 200
 201
 202 /* ----------------- PCI/USB Related MACRO ----------------- */
 203
 204 #define RT28XX_HANDLE_DEV_ASSIGN(handle, dev_p)                         \
 205         ((POS_COOKIE)handle)->pci_dev = dev_p;
 206
 207 // set driver data
 208 #define RT28XX_DRVDATA_SET(_a)                  pci_set_drvdata(_a, net_dev);
 209
 210 #define RT28XX_UNMAP()                                                                          \
 211 {       if (net_dev->base_addr) {                                                               \
 212                 iounmap((void *)(net_dev->base_addr));                          \
 213                 release_mem_region(pci_resource_start(dev_p, 0),        \
 214                                                         pci_resource_len(dev_p, 0)); }  \
 215         if (net_dev->irq) pci_release_regions(dev_p); }
 216
 217 #ifdef PCI_MSI_SUPPORT
 218 #define RTMP_MSI_ENABLE(_pAd) \
 219 {       POS_COOKIE _pObj = (POS_COOKIE)(_pAd->OS_Cookie); \
 220         (_pAd)->HaveMsi =       pci_enable_msi(_pObj->pci_dev) == 0 ? TRUE : FALSE; }
 221
 222 #define RTMP_MSI_DISABLE(_pAd) \
 223 {       POS_COOKIE _pObj = (POS_COOKIE)(_pAd->OS_Cookie); \
 224         if (_pAd->HaveMsi == TRUE) \
 225                 pci_disable_msi(_pObj->pci_dev); \
 226         _pAd->HaveMsi = FALSE;  }
 227 #else
 228 #define RTMP_MSI_ENABLE(_pAd)
 229 #define RTMP_MSI_DISABLE(_pAd)
 230 #endif // PCI_MSI_SUPPORT //
 231
 232 #define SA_SHIRQ IRQF_SHARED
 233
 234 #define RT28XX_IRQ_REQUEST(net_dev)                                                     \
 235 {       PRTMP_ADAPTER _pAd = (PRTMP_ADAPTER)((net_dev)->ml_priv);       \
 236         POS_COOKIE _pObj = (POS_COOKIE)(_pAd->OS_Cookie);               \
 237         RTMP_MSI_ENABLE(_pAd);                                                                  \
 238         if ((retval = request_irq(_pObj->pci_dev->irq,          \
 239                                                         rt2860_interrupt, SA_SHIRQ,             \
 240                                                         (net_dev)->name, (net_dev)))) { \
 241                 printk("RT2860: request_irq  ERROR(%d)\n", retval);     \
 242         return retval; } }
 243
 244 #define RT28XX_IRQ_RELEASE(net_dev)                                                             \
 245 {       PRTMP_ADAPTER _pAd = (PRTMP_ADAPTER)((net_dev)->ml_priv);               \
 246         POS_COOKIE _pObj = (POS_COOKIE)(_pAd->OS_Cookie);                       \
 247         synchronize_irq(_pObj->pci_dev->irq);                                           \
 248         free_irq(_pObj->pci_dev->irq, (net_dev));                                       \
 249         RTMP_MSI_DISABLE(_pAd); }
 250
 251 #define RT28XX_IRQ_INIT(pAd)                                                                            \
 252         {       pAd->int_enable_reg = ((DELAYINTMASK) |                                         \
 253                                                         (RxINT|TxDataInt|TxMgmtInt)) & ~(0x03); \
 254                 pAd->int_disable_mask = 0;                                                                      \
 255                 pAd->int_pending = 0; }
 256
 257 #define RT28XX_IRQ_ENABLE(pAd)                                                                  \
 258         {       /* clear garbage ints */                                                                \
 259                 RTMP_IO_WRITE32(pAd, INT_SOURCE_CSR, 0xffffffff);               \
 260                 NICEnableInterrupt(pAd); }
 261
 262 #define RT28XX_PUT_DEVICE(dev_p)
 263
 264
 265 /* ----------------- MLME Related MACRO ----------------- */
 266 #define RT28XX_MLME_HANDLER(pAd)                        MlmeHandler(pAd)
 267
 268 #define RT28XX_MLME_PRE_SANITY_CHECK(pAd)
 269
 270 #define RT28XX_MLME_STA_QUICK_RSP_WAKE_UP(pAd)  \
 271         RTMPSetTimer(&pAd->StaCfg.StaQuickResponeForRateUpTimer, 100);
 272
 273 #define RT28XX_MLME_RESET_STATE_MACHINE(pAd)    \
 274                 MlmeRestartStateMachine(pAd)
 275
 276 #define RT28XX_HANDLE_COUNTER_MEASURE(_pAd, _pEntry)            \
 277                 HandleCounterMeasure(_pAd, _pEntry)
 278
 279 /* ----------------- Power Save Related MACRO ----------------- */
 280 #define RT28XX_PS_POLL_ENQUEUE(pAd)                             EnqueuePsPoll(pAd)
 281
 282 //
 283 // Device ID & Vendor ID, these values should match EEPROM value
 284 //
 285 #define NIC2860_PCI_DEVICE_ID   0x0601
 286 #define NIC2860_PCIe_DEVICE_ID  0x0681
 287 #define NIC2760_PCI_DEVICE_ID   0x0701          // 1T/2R Cardbus ???
 288 #define NIC2790_PCIe_DEVICE_ID  0x0781      // 1T/2R miniCard
 289
 290 #define NIC_PCI_VENDOR_ID       0x1814
 291
 292 #define VEN_AWT_PCIe_DEVICE_ID  0x1059
 293 #define VEN_AWT_PCI_VENDOR_ID   0x1A3B
 294
 295 // For RTMPPCIePowerLinkCtrlRestore () function
 296 #define RESTORE_HALT                1
 297 #define RESTORE_WAKEUP              2
 298 #define RESTORE_CLOSE           3
 299
 300 #define PowerSafeCID            1
 301 #define PowerRadioOffCID                2
 302 #define PowerWakeCID            3
 303 #define CID0MASK                0x000000ff
 304 #define CID1MASK                0x0000ff00
 305 #define CID2MASK                0x00ff0000
 306 #define CID3MASK                0xff000000
 307
 308 #define PCI_REG_READ_WORD(pci_dev, offset, Configuration)   \
 309     if (pci_read_config_word(pci_dev, offset, &reg16) == 0)     \
 310         Configuration = le2cpu16(reg16);                        \
 311     else                                                        \
 312         Configuration = 0;
 313
 314 #define PCI_REG_WIRTE_WORD(pci_dev, offset, Configuration)  \
 315     reg16 = cpu2le16(Configuration);                        \
 316     pci_write_config_word(pci_dev, offset, reg16);          \
 317
 318 #define RT28XX_STA_FORCE_WAKEUP(pAd, Level) \
 319     RT28xxPciStaAsicForceWakeup(pAd, Level);
 320
 321 #define RT28XX_STA_SLEEP_THEN_AUTO_WAKEUP(pAd, TbttNumToNextWakeUp) \
 322     RT28xxPciStaAsicSleepThenAutoWakeup(pAd, TbttNumToNextWakeUp);
 323
 324 #define RT28XX_MLME_RADIO_ON(pAd) \
 325     RT28xxPciMlmeRadioOn(pAd);
 326
 327 #define RT28XX_MLME_RADIO_OFF(pAd) \
 328     RT28xxPciMlmeRadioOFF(pAd);
 329
 330 #endif //__RT2860_H__
 331