2 *************************************************************************
4 * 5F., No.36, Taiyuan St., Jhubei City,
8 * (c) Copyright 2002-2007, Ralink Technology, Inc.
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. *
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. *
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. *
25 *************************************************************************
34 -------- ---------- ----------------------------------------------
35 John Chang 2003-08-28 Created
36 John Chang 2004-09-06 modified for RT2600
42 //extern UCHAR BROADCAST_ADDR[];
44 // maximum supported capability information -
45 // ESS, IBSS, Privacy, Short Preamble, Spectrum mgmt, Short Slot
46 #define SUPPORTED_CAPABILITY_INFO 0x0533
48 #define END_OF_ARGS -1
49 #define LFSR_MASK 0x80000057
50 #define MLME_TASK_EXEC_INTV 100/*200*/ //
52 #define MLME_TASK_EXEC_MULTIPLE 10 /*5*/ // MLME_TASK_EXEC_MULTIPLE * MLME_TASK_EXEC_INTV = 1 sec
53 #define REORDER_EXEC_INTV 100 // 0.1 sec
54 //#define TBTT_PRELOAD_TIME 384 // usec. LomgPreamble + 24-byte at 1Mbps
56 // The definition of Radar detection duration region
62 #define MAX_RD_REGION 5
64 #ifdef NDIS51_MINIPORT
65 #define BEACON_LOST_TIME 4000 // 2048 msec = 2 sec
67 #define BEACON_LOST_TIME 4 * OS_HZ // 2048 msec = 2 sec
70 #define DLS_TIMEOUT 1200 // unit: msec
71 #define AUTH_TIMEOUT 300 // unit: msec
72 #define ASSOC_TIMEOUT 300 // unit: msec
73 #define JOIN_TIMEOUT 2 * OS_HZ // unit: msec
74 #define SHORT_CHANNEL_TIME 90 // unit: msec
75 #define MIN_CHANNEL_TIME 110 // unit: msec, for dual band scan
76 #define MAX_CHANNEL_TIME 140 // unit: msec, for single band scan
77 #define FAST_ACTIVE_SCAN_TIME 30 // Active scan waiting for probe response time
78 #define CW_MIN_IN_BITS 4 // actual CwMin = 2^CW_MIN_IN_BITS - 1
81 #ifdef CONFIG_STA_SUPPORT
82 #ifndef CONFIG_AP_SUPPORT
83 #define CW_MAX_IN_BITS 10 // actual CwMax = 2^CW_MAX_IN_BITS - 1
85 #endif // CONFIG_STA_SUPPORT //
87 // Note: RSSI_TO_DBM_OFFSET has been changed to variable for new RF (2004-0720).
88 // SHould not refer to this constant anymore
89 //#define RSSI_TO_DBM_OFFSET 120 // for RT2530 RSSI-115 = dBm
90 #define RSSI_FOR_MID_TX_POWER -55 // -55 db is considered mid-distance
91 #define RSSI_FOR_LOW_TX_POWER -45 // -45 db is considered very short distance and
92 // eligible to use a lower TX power
93 #define RSSI_FOR_LOWEST_TX_POWER -30
94 //#define MID_TX_POWER_DELTA 0 // 0 db from full TX power upon mid-distance to AP
95 #define LOW_TX_POWER_DELTA 6 // -3 db from full TX power upon very short distance. 1 grade is 0.5 db
96 #define LOWEST_TX_POWER_DELTA 16 // -8 db from full TX power upon shortest distance. 1 grade is 0.5 db
98 #define RSSI_TRIGGERED_UPON_BELOW_THRESHOLD 0
99 #define RSSI_TRIGGERED_UPON_EXCCEED_THRESHOLD 1
100 #define RSSI_THRESHOLD_FOR_ROAMING 25
103 // Channel Quality Indication
104 #define CQI_IS_GOOD(cqi) ((cqi) >= 50)
105 //#define CQI_IS_FAIR(cqi) (((cqi) >= 20) && ((cqi) < 50))
106 #define CQI_IS_POOR(cqi) (cqi < 50) //(((cqi) >= 5) && ((cqi) < 20))
107 #define CQI_IS_BAD(cqi) (cqi < 5)
108 #define CQI_IS_DEAD(cqi) (cqi == 0)
110 // weighting factor to calculate Channel quality, total should be 100%
111 #define RSSI_WEIGHTING 50
112 #define TX_WEIGHTING 30
113 #define RX_WEIGHTING 20
115 //#define PEER_KEY_NOT_USED 0
116 //#define PEER_KEY_64_BIT 64
117 //#define PEER_KEY_128_BIT 128
119 //#define PEER_KEY_64BIT_LEN 8
120 //#define PEER_KEY_128BIT_LEN 16
122 #define BSS_NOT_FOUND 0xFFFFFFFF
125 #ifdef CONFIG_STA_SUPPORT
126 #define MAX_LEN_OF_MLME_QUEUE 40 //10
127 #endif // CONFIG_STA_SUPPORT //
129 #define SCAN_PASSIVE 18 // scan with no probe request, only wait beacon and probe response
130 #define SCAN_ACTIVE 19 // scan with probe request, and wait beacon and probe response
131 #define SCAN_CISCO_PASSIVE 20 // Single channel passive scan
132 #define SCAN_CISCO_ACTIVE 21 // Single channel active scan
133 #define SCAN_CISCO_NOISE 22 // Single channel passive scan for noise histogram collection
134 #define SCAN_CISCO_CHANNEL_LOAD 23 // Single channel passive scan for channel load collection
135 #define FAST_SCAN_ACTIVE 24 // scan with probe request, and wait beacon and probe response
137 //#define BSS_TABLE_EMPTY(x) ((x).BssNr == 0)
138 #define MAC_ADDR_IS_GROUP(Addr) (((Addr[0]) & 0x01))
139 #define MAC_ADDR_HASH(Addr) (Addr[0] ^ Addr[1] ^ Addr[2] ^ Addr[3] ^ Addr[4] ^ Addr[5])
140 #define MAC_ADDR_HASH_INDEX(Addr) (MAC_ADDR_HASH(Addr) % HASH_TABLE_SIZE)
141 #define TID_MAC_HASH(Addr,TID) (TID^Addr[0] ^ Addr[1] ^ Addr[2] ^ Addr[3] ^ Addr[4] ^ Addr[5])
142 #define TID_MAC_HASH_INDEX(Addr,TID) (TID_MAC_HASH(Addr,TID) % HASH_TABLE_SIZE)
145 // assoiation ON. one LED ON. another blinking when TX, OFF when idle
146 // no association, both LED off
147 #define ASIC_LED_ACT_ON(pAd) RTMP_IO_WRITE32(pAd, MAC_CSR14, 0x00031e46)
148 #define ASIC_LED_ACT_OFF(pAd) RTMP_IO_WRITE32(pAd, MAC_CSR14, 0x00001e46)
150 // bit definition of the 2-byte pBEACON->Capability field
151 #define CAP_IS_ESS_ON(x) (((x) & 0x0001) != 0)
152 #define CAP_IS_IBSS_ON(x) (((x) & 0x0002) != 0)
153 #define CAP_IS_CF_POLLABLE_ON(x) (((x) & 0x0004) != 0)
154 #define CAP_IS_CF_POLL_REQ_ON(x) (((x) & 0x0008) != 0)
155 #define CAP_IS_PRIVACY_ON(x) (((x) & 0x0010) != 0)
156 #define CAP_IS_SHORT_PREAMBLE_ON(x) (((x) & 0x0020) != 0)
157 #define CAP_IS_PBCC_ON(x) (((x) & 0x0040) != 0)
158 #define CAP_IS_AGILITY_ON(x) (((x) & 0x0080) != 0)
159 #define CAP_IS_SPECTRUM_MGMT(x) (((x) & 0x0100) != 0) // 802.11e d9
160 #define CAP_IS_QOS(x) (((x) & 0x0200) != 0) // 802.11e d9
161 #define CAP_IS_SHORT_SLOT(x) (((x) & 0x0400) != 0)
162 #define CAP_IS_APSD(x) (((x) & 0x0800) != 0) // 802.11e d9
163 #define CAP_IS_IMMED_BA(x) (((x) & 0x1000) != 0) // 802.11e d9
164 #define CAP_IS_DSSS_OFDM(x) (((x) & 0x2000) != 0)
165 #define CAP_IS_DELAY_BA(x) (((x) & 0x4000) != 0) // 802.11e d9
167 #define CAP_GENERATE(ess,ibss,priv,s_pre,s_slot,spectrum) (((ess) ? 0x0001 : 0x0000) | ((ibss) ? 0x0002 : 0x0000) | ((priv) ? 0x0010 : 0x0000) | ((s_pre) ? 0x0020 : 0x0000) | ((s_slot) ? 0x0400 : 0x0000) | ((spectrum) ? 0x0100 : 0x0000))
169 //#define STA_QOS_CAPABILITY 0 // 1-byte. see 802.11e d9.0 for bit definition
171 #define ERP_IS_NON_ERP_PRESENT(x) (((x) & 0x01) != 0) // 802.11g
172 #define ERP_IS_USE_PROTECTION(x) (((x) & 0x02) != 0) // 802.11g
173 #define ERP_IS_USE_BARKER_PREAMBLE(x) (((x) & 0x04) != 0) // 802.11g
175 #define DRS_TX_QUALITY_WORST_BOUND 8// 3 // just test by gary
176 #define DRS_PENALTY 8
179 //BA Policy subfiled value in ADDBA frame
183 // BA Initiator subfield in DELBA frame
188 #define ADDBA_RESULTCODE_SUCCESS 0
189 #define ADDBA_RESULTCODE_REFUSED 37
190 #define ADDBA_RESULTCODE_INVALID_PARAMETERS 38
193 #define DELBA_REASONCODE_QSTA_LEAVING 36
194 #define DELBA_REASONCODE_END_BA 37
195 #define DELBA_REASONCODE_UNKNOWN_BA 38
196 #define DELBA_REASONCODE_TIMEOUT 39
198 // reset all OneSecTx counters
199 #define RESET_ONE_SEC_TX_CNT(__pEntry) \
200 if (((__pEntry)) != NULL) \
202 (__pEntry)->OneSecTxRetryOkCount = 0; \
203 (__pEntry)->OneSecTxFailCount = 0; \
204 (__pEntry)->OneSecTxNoRetryOkCount = 0; \
208 // 802.11 frame formats
210 // HT Capability INFO field in HT Cap IE .
211 typedef struct PACKED {
213 USHORT ChannelWidth:1;
214 USHORT MimoPs:2;//momi power safe
215 USHORT GF:1; //green field
216 USHORT ShortGIfor20:1;
217 USHORT ShortGIfor40:1; //for40MHz
220 USHORT DelayedBA:1; //rt2860c not support
221 USHORT AMsduSize:1; // only support as zero
222 USHORT CCKmodein40:1;
224 USHORT Forty_Mhz_Intolerant:1;
225 USHORT LSIGTxopProSup:1;
226 } HT_CAP_INFO, *PHT_CAP_INFO;
228 // HT Capability INFO field in HT Cap IE .
229 typedef struct PACKED {
230 UCHAR MaxRAmpduFactor:2;
232 UCHAR rsv:3;//momi power safe
233 } HT_CAP_PARM, *PHT_CAP_PARM;
235 // HT Capability INFO field in HT Cap IE .
236 typedef struct PACKED {
238 UCHAR SupRate[2]; // unit : 1Mbps
239 UCHAR TxMCSSetDefined:1;
240 UCHAR TxRxNotEqual:1;
245 } HT_MCS_SET, *PHT_MCS_SET;
247 // HT Capability INFO field in HT Cap IE .
248 typedef struct PACKED {
251 USHORT rsv:5;//momi power safe
252 USHORT MCSFeedback:2; //0:no MCS feedback, 2:unsolicited MCS feedback, 3:Full MCS feedback, 1:rsv.
253 USHORT PlusHTC:1; //+HTC control field support
254 USHORT RDGSupport:1; //reverse Direction Grant support
256 } EXT_HT_CAP_INFO, *PEXT_HT_CAP_INFO;
258 // HT Beamforming field in HT Cap IE .
259 typedef struct PACKED _HT_BF_CAP{
260 ULONG TxBFRecCapable:1;
261 ULONG RxSoundCapable:1;
262 ULONG TxSoundCapable:1;
263 ULONG RxNDPCapable:1;
264 ULONG TxNDPCapable:1;
265 ULONG ImpTxBFCapable:1;
267 ULONG ExpCSICapable:1;
268 ULONG ExpNoComSteerCapable:1;
269 ULONG ExpComSteerCapable:1;
275 ULONG NoComSteerBFAntSup:2;
276 ULONG ComSteerBFAntSup:2;
278 ULONG ChanEstimation:2;
280 } HT_BF_CAP, *PHT_BF_CAP;
282 // HT antenna selection field in HT Cap IE .
283 typedef struct PACKED _HT_AS_CAP{
285 UCHAR ExpCSIFbkTxASEL:1;
286 UCHAR AntIndFbkTxASEL:1;
292 } HT_AS_CAP, *PHT_AS_CAP;
294 // Draft 1.0 set IE length 26, but is extensible..
295 #define SIZE_HT_CAP_IE 26
296 // The structure for HT Capability IE.
297 typedef struct PACKED _HT_CAPABILITY_IE{
298 HT_CAP_INFO HtCapInfo;
299 HT_CAP_PARM HtCapParm;
300 // HT_MCS_SET HtMCSSet;
302 EXT_HT_CAP_INFO ExtHtCapInfo;
303 HT_BF_CAP TxBFCap; // beamforming cap. rt2860c not support beamforming.
304 HT_AS_CAP ASCap; //antenna selection.
305 } HT_CAPABILITY_IE, *PHT_CAPABILITY_IE;
308 // 802.11n draft3 related structure definitions.
310 #define dot11OBSSScanPassiveDwell 20 // in TU. min amount of time that the STA continously scans each channel when performing an active OBSS scan.
311 #define dot11OBSSScanActiveDwell 10 // in TU.min amount of time that the STA continously scans each channel when performing an passive OBSS scan.
312 #define dot11BSSWidthTriggerScanInterval 300 // in sec. max interval between scan operations to be performed to detect BSS channel width trigger events.
313 #define dot11OBSSScanPassiveTotalPerChannel 200 // in TU. min total amount of time that the STA scans each channel when performing a passive OBSS scan.
314 #define dot11OBSSScanActiveTotalPerChannel 20 //in TU. min total amount of time that the STA scans each channel when performing a active OBSS scan
315 #define dot11BSSWidthChannelTransactionDelayFactor 5 // min ratio between the delay time in performing a switch from 20MHz BSS to 20/40 BSS operation and the maxima
316 // interval between overlapping BSS scan operations.
317 #define dot11BSSScanActivityThreshold 25 // in %%, max total time that a STA may be active on the medium during a period of
318 // (dot11BSSWidthChannelTransactionDelayFactor * dot11BSSWidthTriggerScanInterval) seconds without
319 // being obligated to perform OBSS Scan operations. default is 25(== 0.25%)
321 typedef struct PACKED _OVERLAP_BSS_SCAN_IE{
322 USHORT ScanPassiveDwell;
323 USHORT ScanActiveDwell;
324 USHORT TriggerScanInt; // Trigger scan interval
325 USHORT PassiveTalPerChannel; // passive total per channel
326 USHORT ActiveTalPerChannel; // active total per channel
327 USHORT DelayFactor; // BSS width channel transition delay factor
328 USHORT ScanActThre; // Scan Activity threshold
329 }OVERLAP_BSS_SCAN_IE, *POVERLAP_BSS_SCAN_IE;
332 // 7.3.2.56. 20/40 Coexistence element used in Element ID = 72 = IE_2040_BSS_COEXIST
333 typedef union PACKED _BSS_2040_COEXIST_IE{
336 UCHAR Intolerant40:1; // Inter-BSS. set 1 when prohibits a receiving BSS from operating as a 20/40 Mhz BSS.
337 UCHAR BSS20WidthReq:1; // Intra-BSS set 1 when prohibits a receiving AP from operating its BSS as a 20/40MHz BSS.
341 } BSS_2040_COEXIST_IE, *PBSS_2040_COEXIST_IE;
344 typedef struct _TRIGGER_EVENTA{
347 UCHAR RegClass; // Regulatory Class
349 ULONG CDCounter; // Maintain a seperate count down counter for each Event A.
350 } TRIGGER_EVENTA, *PTRIGGER_EVENTA;
352 // 20/40 trigger event table
353 // If one Event A delete or created, or if Event B is detected or not detected, STA should send 2040BSSCoexistence to AP.
354 #define MAX_TRIGGER_EVENT 64
355 typedef struct _TRIGGER_EVENT_TAB{
357 TRIGGER_EVENTA EventA[MAX_TRIGGER_EVENT];
358 ULONG EventBCountDown; // Count down counter for Event B.
359 } TRIGGER_EVENT_TAB, *PTRIGGER_EVENT_TAB;
361 // 7.3.27 20/40 Bss Coexistence Mgmt capability used in extended capabilities information IE( ID = 127 = IE_EXT_CAPABILITY).
362 // This is the first octet and was defined in 802.11n D3.03 and 802.11yD9.0
363 typedef struct PACKED _EXT_CAP_INFO_ELEMENT{
364 UCHAR BssCoexistMgmtSupport:1;
366 UCHAR ExtendChannelSwitch:1;
368 }EXT_CAP_INFO_ELEMENT, *PEXT_CAP_INFO_ELEMENT;
372 typedef struct PACKED _BSS_2040_COEXIST_ELEMENT{
373 UCHAR ElementID; // ID = IE_2040_BSS_COEXIST = 72
375 BSS_2040_COEXIST_IE BssCoexistIe;
376 }BSS_2040_COEXIST_ELEMENT, *PBSS_2040_COEXIST_ELEMENT;
380 typedef struct PACKED _BSS_2040_INTOLERANT_CH_REPORT{
381 UCHAR ElementID; // ID = IE_2040_BSS_INTOLERANT_REPORT = 73
383 UCHAR RegulatoryClass;
385 }BSS_2040_INTOLERANT_CH_REPORT, *PBSS_2040_INTOLERANT_CH_REPORT;
388 // The structure for channel switch annoucement IE. This is in 802.11n D3.03
389 typedef struct PACKED _CHA_SWITCH_ANNOUNCE_IE{
390 UCHAR SwitchMode; //channel switch mode
392 UCHAR SwitchCount; //
393 } CHA_SWITCH_ANNOUNCE_IE, *PCHA_SWITCH_ANNOUNCE_IE;
396 // The structure for channel switch annoucement IE. This is in 802.11n D3.03
397 typedef struct PACKED _SEC_CHA_OFFSET_IE{
398 UCHAR SecondaryChannelOffset; // 1: Secondary above, 3: Secondary below, 0: no Secondary
399 } SEC_CHA_OFFSET_IE, *PSEC_CHA_OFFSET_IE;
402 // This structure is extracted from struct RT_HT_CAPABILITY
404 BOOLEAN bHtEnable; // If we should use ht rate.
405 BOOLEAN bPreNHt; // If we should use ht rate.
406 //Substract from HT Capability IE
407 UCHAR MCSSet[16]; //only supoort MCS=0-15,32 ,
408 } RT_HT_PHY_INFO, *PRT_HT_PHY_INFO;
410 //This structure substracts ralink supports from all 802.11n-related features.
411 //Features not listed here but contained in 802.11n spec are not supported in rt2860.
414 BOOLEAN bHtEnable; // If we should use ht rate.
415 BOOLEAN bPreNHt; // If we should use ht rate.
416 //Substract from HT Capability IE
417 UCHAR MCSSet[16]; //only supoort MCS=0-15,32 ,
419 USHORT ChannelWidth:1;
420 USHORT MimoPs:2;//mimo power safe MMPS_
421 USHORT GF:1; //green field
422 USHORT ShortGIfor20:1;
423 USHORT ShortGIfor40:1; //for40MHz
425 USHORT RxSTBC:2; // 2 bits
426 USHORT AmsduEnable:1; // Enable to transmit A-MSDU. Suggest disable. We should use A-MPDU to gain best benifit of 802.11n
427 USHORT AmsduSize:1; // Max receiving A-MSDU size
430 //Substract from Addiont HT INFO IE
431 UCHAR MaxRAmpduFactor:2;
433 UCHAR ExtChanOffset:2; // Please not the difference with following UCHAR NewExtChannelOffset; from 802.11n
436 USHORT OperaionMode:2;
437 USHORT NonGfPresent:1;
439 USHORT OBSS_NonHTExist:1;
442 // New Extension Channel Offset IE
443 UCHAR NewExtChannelOffset;
444 // Extension Capability IE = 127
445 UCHAR BSSCoexist2040;
446 } RT_HT_CAPABILITY, *PRT_HT_CAPABILITY;
448 // field in Addtional HT Information IE .
449 typedef struct PACKED {
450 UCHAR ExtChanOffset:2;
453 UCHAR S_PSMPSup:1; //Indicate support for scheduled PSMP
454 UCHAR SerInterGranu:3; //service interval granularity
455 } ADD_HTINFO, *PADD_HTINFO;
457 typedef struct PACKED{
458 USHORT OperaionMode:2;
459 USHORT NonGfPresent:1;
461 USHORT OBSS_NonHTExist:1;
463 } ADD_HTINFO2, *PADD_HTINFO2;
466 // TODO: Need sync with spec about the definition of StbcMcs. In Draft 3.03, it's reserved.
467 typedef struct PACKED{
470 USHORT DualCTSProtect:1;
472 USHORT LsigTxopProt:1; // L-SIG TXOP protection full support
476 } ADD_HTINFO3, *PADD_HTINFO3;
478 #define SIZE_ADD_HT_INFO_IE 22
479 typedef struct PACKED{
481 ADD_HTINFO AddHtInfo;
482 ADD_HTINFO2 AddHtInfo2;
483 ADD_HTINFO3 AddHtInfo3;
484 UCHAR MCSSet[16]; // Basic MCS set
485 } ADD_HT_INFO_IE, *PADD_HT_INFO_IE;
487 typedef struct PACKED{
488 UCHAR NewExtChanOffset;
489 } NEW_EXT_CHAN_IE, *PNEW_EXT_CHAN_IE;
492 // 4-byte HTC field. maybe included in any frame except non-QOS data frame. The Order bit must set 1.
493 typedef struct PACKED {
494 UINT32 MA:1; //management action payload exist in (QoS Null+HTC)
495 UINT32 TRQ:1; //sounding request
496 UINT32 MRQ:1; //MCS feedback. Request for a MCS feedback
497 UINT32 MRSorASI:3; // MRQ Sequence identifier. unchanged during entire procedure. 0x000-0x110.
498 UINT32 MFS:3; //SET to the received value of MRS. 0x111 for unsolicited MFB.
499 UINT32 MFBorASC:7; //Link adaptation feedback containing recommended MCS. 0x7f for no feedback or not available
500 UINT32 CalPos:2; // calibration position
501 UINT32 CalSeq:2; //calibration sequence
502 UINT32 FBKReq:2; //feedback request
503 UINT32 CSISTEERING:2; //CSI/ STEERING
504 UINT32 ZLFAnnouce:1; // ZLF announcement
505 UINT32 rsv:5; //calibration sequence
506 UINT32 ACConstraint:1; //feedback request
507 UINT32 RDG:1; //RDG / More PPDU
508 } HT_CONTROL, *PHT_CONTROL;
510 // 2-byte QOS CONTROL field
511 typedef struct PACKED {
514 USHORT AckPolicy:2; //0: normal ACK 1:No ACK 2:scheduled under MTBA/PSMP 3: BA
515 USHORT AMsduPresent:1;
516 USHORT Txop_QueueSize:8;
517 } QOS_CONTROL, *PQOS_CONTROL;
519 // 2-byte Frame control field
520 typedef struct PACKED {
521 USHORT Ver:2; // Protocol version
522 USHORT Type:2; // MSDU type
523 USHORT SubType:4; // MSDU subtype
524 USHORT ToDs:1; // To DS indication
525 USHORT FrDs:1; // From DS indication
526 USHORT MoreFrag:1; // More fragment bit
527 USHORT Retry:1; // Retry status bit
528 USHORT PwrMgmt:1; // Power management bit
529 USHORT MoreData:1; // More data bit
530 USHORT Wep:1; // Wep data
531 USHORT Order:1; // Strict order expected
532 } FRAME_CONTROL, *PFRAME_CONTROL;
534 typedef struct PACKED _HEADER_802_11 {
537 UCHAR Addr1[MAC_ADDR_LEN];
538 UCHAR Addr2[MAC_ADDR_LEN];
539 UCHAR Addr3[MAC_ADDR_LEN];
543 } HEADER_802_11, *PHEADER_802_11;
545 typedef struct PACKED _FRAME_802_11 {
548 } FRAME_802_11, *PFRAME_802_11;
550 // QoSNull embedding of management action. When HT Control MA field set to 1.
551 typedef struct PACKED _MA_BODY {
555 } MA_BODY, *PMA_BODY;
557 typedef struct PACKED _HEADER_802_3 {
558 UCHAR DAAddr1[MAC_ADDR_LEN];
559 UCHAR SAAddr2[MAC_ADDR_LEN];
561 } HEADER_802_3, *PHEADER_802_3;
562 ////Block ACK related format
563 // 2-byte BA Parameter field in DELBA frames to terminate an already set up bA
564 typedef struct PACKED{
565 USHORT Rsv:11; // always set to 0
566 USHORT Initiator:1; // 1: originator 0:recipient
567 USHORT TID:4; // value of TC os TS
568 } DELBA_PARM, *PDELBA_PARM;
570 // 2-byte BA Parameter Set field in ADDBA frames to signal parm for setting up a BA
571 typedef struct PACKED {
572 USHORT AMSDUSupported:1; // 0: not permitted 1: permitted
573 USHORT BAPolicy:1; // 1: immediately BA 0:delayed BA
574 USHORT TID:4; // value of TC os TS
575 USHORT BufSize:10; // number of buffe of size 2304 octetsr
576 } BA_PARM, *PBA_PARM;
578 // 2-byte BA Starting Seq CONTROL field
579 typedef union PACKED {
581 USHORT FragNum:4; // always set to 0
582 USHORT StartSeq:12; // sequence number of the 1st MSDU for which this BAR is sent
585 } BASEQ_CONTROL, *PBASEQ_CONTROL;
587 //BAControl and BARControl are the same
588 // 2-byte BA CONTROL field in BA frame
589 typedef struct PACKED {
590 USHORT ACKPolicy:1; // only related to N-Delayed BA. But not support in RT2860b. 0:NormalACK 1:No ACK
591 USHORT MTID:1; //EWC V1.24
595 } BA_CONTROL, *PBA_CONTROL;
597 // 2-byte BAR CONTROL field in BAR frame
598 typedef struct PACKED {
599 USHORT ACKPolicy:1; // 0:normal ack, 1:no ack.
600 USHORT MTID:1; //if this bit1, use FRAME_MTBA_REQ, if 0, use FRAME_BA_REQ
604 } BAR_CONTROL, *PBAR_CONTROL;
606 // BARControl in MTBAR frame
607 typedef struct PACKED {
613 } MTBAR_CONTROL, *PMTBAR_CONTROL;
615 typedef struct PACKED {
618 } PER_TID_INFO, *PPER_TID_INFO;
622 BASEQ_CONTROL BAStartingSeq;
623 } EACH_TID, *PEACH_TID;
626 typedef struct PACKED _PSPOLL_FRAME {
629 UCHAR Bssid[MAC_ADDR_LEN];
630 UCHAR Ta[MAC_ADDR_LEN];
631 } PSPOLL_FRAME, *PPSPOLL_FRAME;
633 typedef struct PACKED _RTS_FRAME {
636 UCHAR Addr1[MAC_ADDR_LEN];
637 UCHAR Addr2[MAC_ADDR_LEN];
638 }RTS_FRAME, *PRTS_FRAME;
640 // BAREQ AND MTBAREQ have the same subtype BAR, 802.11n BAR use compressed bitmap.
641 typedef struct PACKED _FRAME_BA_REQ {
644 UCHAR Addr1[MAC_ADDR_LEN];
645 UCHAR Addr2[MAC_ADDR_LEN];
646 BAR_CONTROL BARControl;
647 BASEQ_CONTROL BAStartingSeq;
648 } FRAME_BA_REQ, *PFRAME_BA_REQ;
650 typedef struct PACKED _FRAME_MTBA_REQ {
653 UCHAR Addr1[MAC_ADDR_LEN];
654 UCHAR Addr2[MAC_ADDR_LEN];
655 MTBAR_CONTROL MTBARControl;
656 PER_TID_INFO PerTIDInfo;
657 BASEQ_CONTROL BAStartingSeq;
658 } FRAME_MTBA_REQ, *PFRAME_MTBA_REQ;
660 // Compressed format is mandantory in HT STA
661 typedef struct PACKED _FRAME_MTBA {
664 UCHAR Addr1[MAC_ADDR_LEN];
665 UCHAR Addr2[MAC_ADDR_LEN];
666 BA_CONTROL BAControl;
667 BASEQ_CONTROL BAStartingSeq;
669 } FRAME_MTBA, *PFRAME_MTBA;
671 typedef struct PACKED _FRAME_PSMP_ACTION {
675 UCHAR Psmp; // 7.3.1.25
676 } FRAME_PSMP_ACTION, *PFRAME_PSMP_ACTION;
678 typedef struct PACKED _FRAME_ACTION_HDR {
682 } FRAME_ACTION_HDR, *PFRAME_ACTION_HDR;
685 //Action Frame Category:Spectrum, Action:Channel Switch. 7.3.2.20
686 typedef struct PACKED _CHAN_SWITCH_ANNOUNCE {
687 UCHAR ElementID; // ID = IE_CHANNEL_SWITCH_ANNOUNCEMENT = 37
689 CHA_SWITCH_ANNOUNCE_IE CSAnnounceIe;
690 } CHAN_SWITCH_ANNOUNCE, *PCHAN_SWITCH_ANNOUNCE;
693 //802.11n : 7.3.2.20a
694 typedef struct PACKED _SECOND_CHAN_OFFSET {
695 UCHAR ElementID; // ID = IE_SECONDARY_CH_OFFSET = 62
697 SEC_CHA_OFFSET_IE SecChOffsetIe;
698 } SECOND_CHAN_OFFSET, *PSECOND_CHAN_OFFSET;
701 typedef struct PACKED _FRAME_SPETRUM_CS {
705 CHAN_SWITCH_ANNOUNCE CSAnnounce;
706 SECOND_CHAN_OFFSET SecondChannel;
707 } FRAME_SPETRUM_CS, *PFRAME_SPETRUM_CS;
710 typedef struct PACKED _FRAME_ADDBA_REQ {
715 BA_PARM BaParm; // 2 - 10
716 USHORT TimeOutValue; // 0 - 0
717 BASEQ_CONTROL BaStartSeq; // 0-0
718 } FRAME_ADDBA_REQ, *PFRAME_ADDBA_REQ;
720 typedef struct PACKED _FRAME_ADDBA_RSP {
726 BA_PARM BaParm; //0 - 2
728 } FRAME_ADDBA_RSP, *PFRAME_ADDBA_RSP;
730 typedef struct PACKED _FRAME_DELBA_REQ {
734 DELBA_PARM DelbaParm;
736 } FRAME_DELBA_REQ, *PFRAME_DELBA_REQ;
740 typedef struct PACKED _FRAME_BAR {
743 UCHAR Addr1[MAC_ADDR_LEN];
744 UCHAR Addr2[MAC_ADDR_LEN];
745 BAR_CONTROL BarControl;
746 BASEQ_CONTROL StartingSeq;
747 } FRAME_BAR, *PFRAME_BAR;
750 typedef struct PACKED _FRAME_BA {
753 UCHAR Addr1[MAC_ADDR_LEN];
754 UCHAR Addr2[MAC_ADDR_LEN];
755 BAR_CONTROL BarControl;
756 BASEQ_CONTROL StartingSeq;
758 } FRAME_BA, *PFRAME_BA;
761 // Radio Measuement Request Frame Format
762 typedef struct PACKED _FRAME_RM_REQ_ACTION {
769 } FRAME_RM_REQ_ACTION, *PFRAME_RM_REQ_ACTION;
771 typedef struct PACKED {
774 UCHAR ChannelSwitchMode;
777 UCHAR ChannelSwitchCount;
778 } HT_EXT_CHANNEL_SWITCH_ANNOUNCEMENT_IE, *PHT_EXT_CHANNEL_SWITCH_ANNOUNCEMENT_IE;
782 // _Limit must be the 2**n - 1
783 // _SEQ1 , _SEQ2 must be within 0 ~ _Limit
785 #define SEQ_STEPONE(_SEQ1, _SEQ2, _Limit) ((_SEQ1 == ((_SEQ2+1) & _Limit)))
786 #define SEQ_SMALLER(_SEQ1, _SEQ2, _Limit) (((_SEQ1-_SEQ2) & ((_Limit+1)>>1)))
787 #define SEQ_LARGER(_SEQ1, _SEQ2, _Limit) ((_SEQ1 != _SEQ2) && !(((_SEQ1-_SEQ2) & ((_Limit+1)>>1))))
788 #define SEQ_WITHIN_WIN(_SEQ1, _SEQ2, _WIN, _Limit) (SEQ_LARGER(_SEQ1, _SEQ2, _Limit) && \
789 SEQ_SMALLER(_SEQ1, ((_SEQ2+_WIN+1)&_Limit), _Limit))
792 // Contention-free parameter (without ID and Length)
794 typedef struct PACKED {
795 BOOLEAN bValid; // 1: variable contains valid value
798 USHORT CfpMaxDuration;
799 USHORT CfpDurRemaining;
800 } CF_PARM, *PCF_PARM;
802 typedef struct _CIPHER_SUITE {
803 NDIS_802_11_ENCRYPTION_STATUS PairCipher; // Unicast cipher 1, this one has more secured cipher suite
804 NDIS_802_11_ENCRYPTION_STATUS PairCipherAux; // Unicast cipher 2 if AP announce two unicast cipher suite
805 NDIS_802_11_ENCRYPTION_STATUS GroupCipher; // Group cipher
806 USHORT RsnCapability; // RSN capability from beacon
807 BOOLEAN bMixMode; // Indicate Pair & Group cipher might be different
808 } CIPHER_SUITE, *PCIPHER_SUITE;
810 // EDCA configuration from AP's BEACON/ProbeRsp
812 BOOLEAN bValid; // 1: variable contains valid value
813 BOOLEAN bAdd; // 1: variable contains valid value
815 BOOLEAN bQueueRequest;
816 BOOLEAN bTxopRequest;
817 BOOLEAN bAPSDCapable;
818 // BOOLEAN bMoreDataAck;
819 UCHAR EdcaUpdateCount;
820 UCHAR Aifsn[4]; // 0:AC_BK, 1:AC_BE, 2:AC_VI, 3:AC_VO
823 USHORT Txop[4]; // in unit of 32-us
824 BOOLEAN bACM[4]; // 1: Admission Control of AC_BK is mandattory
825 } EDCA_PARM, *PEDCA_PARM;
827 // QBSS LOAD information from QAP's BEACON/ProbeRsp
829 BOOLEAN bValid; // 1: variable contains valid value
831 UCHAR ChannelUtilization;
832 USHORT RemainingAdmissionControl; // in unit of 32-us
833 } QBSS_LOAD_PARM, *PQBSS_LOAD_PARM;
835 // QBSS Info field in QSTA's assoc req
836 typedef struct PACKED {
844 } QBSS_STA_INFO_PARM, *PQBSS_STA_INFO_PARM;
846 // QBSS Info field in QAP's Beacon/ProbeRsp
847 typedef struct PACKED {
848 UCHAR ParamSetCount:4;
851 } QBSS_AP_INFO_PARM, *PQBSS_AP_INFO_PARM;
853 // QOS Capability reported in QAP's BEACON/ProbeRsp
854 // QOS Capability sent out in QSTA's AssociateReq/ReAssociateReq
856 BOOLEAN bValid; // 1: variable contains valid value
858 BOOLEAN bQueueRequest;
859 BOOLEAN bTxopRequest;
860 // BOOLEAN bMoreDataAck;
861 UCHAR EdcaUpdateCount;
862 } QOS_CAPABILITY_PARM, *PQOS_CAPABILITY_PARM;
864 #ifdef CONFIG_STA_SUPPORT
867 UCHAR IE[MAX_CUSTOM_LEN];
869 #endif // CONFIG_STA_SUPPORT //
873 UCHAR Bssid[MAC_ADDR_LEN];
875 UCHAR CentralChannel; //Store the wide-band central channel for 40MHz. .used in 40MHz AP. Or this is the same as Channel.
880 UCHAR SupRate[MAX_LEN_OF_SUPPORTED_RATES];
882 UCHAR ExtRate[MAX_LEN_OF_SUPPORTED_RATES];
884 HT_CAPABILITY_IE HtCapability;
885 UCHAR HtCapabilityLen;
886 ADD_HT_INFO_IE AddHtInfo; // AP might use this additional ht info IE
888 UCHAR NewExtChanOffset;
890 UCHAR Privacy; // Indicate security function ON/OFF. Don't mess up with auth mode.
894 USHORT CapabilityInfo;
898 USHORT CfpMaxDuration;
899 USHORT CfpDurRemaining;
901 CHAR Ssid[MAX_LEN_OF_SSID];
903 ULONG LastBeaconRxTime; // OS's timestamp
908 CIPHER_SUITE WPA; // AP announced WPA cipher suite
909 CIPHER_SUITE WPA2; // AP announced WPA2 cipher suite
911 // New for microsoft WPA support
912 NDIS_802_11_FIXED_IEs FixIEs;
913 NDIS_802_11_AUTHENTICATION_MODE AuthModeAux; // Addition mode for WPA2 / WPA capable AP
914 NDIS_802_11_AUTHENTICATION_MODE AuthMode;
915 NDIS_802_11_WEP_STATUS WepStatus; // Unicast Encryption Algorithm extract from VAR_IE
916 USHORT VarIELen; // Length of next VIE include EID & Length
917 UCHAR VarIEs[MAX_VIE_LEN];
919 // CCX Ckip information
923 UCHAR PTSF[4]; // Parent TSF
924 UCHAR TTSF[8]; // Target TSF
926 // 802.11e d9, and WMM
928 QOS_CAPABILITY_PARM QosCapability;
929 QBSS_LOAD_PARM QbssLoad;
930 #ifdef CONFIG_STA_SUPPORT
933 #endif // CONFIG_STA_SUPPORT //
934 } BSS_ENTRY, *PBSS_ENTRY;
939 BSS_ENTRY BssEntry[MAX_LEN_OF_BSS_TABLE];
940 } BSS_TABLE, *PBSS_TABLE;
943 typedef struct _MLME_QUEUE_ELEM {
947 UCHAR Msg[MGMT_DMA_BUFFER_SIZE];
948 LARGE_INTEGER TimeStamp;
956 } MLME_QUEUE_ELEM, *PMLME_QUEUE_ELEM;
958 typedef struct _MLME_QUEUE {
963 MLME_QUEUE_ELEM Entry[MAX_LEN_OF_MLME_QUEUE];
964 } MLME_QUEUE, *PMLME_QUEUE;
966 typedef VOID (*STATE_MACHINE_FUNC)(VOID *Adaptor, MLME_QUEUE_ELEM *Elem);
968 typedef struct _STATE_MACHINE {
973 STATE_MACHINE_FUNC *TransFunc;
974 } STATE_MACHINE, *PSTATE_MACHINE;
977 // MLME AUX data structure that hold temporarliy settings during a connection attempt.
978 // Once this attemp succeeds, all settings will be copy to pAd->StaActive.
979 // A connection attempt (user set OID, roaming, CCX fast roaming,..) consists of
980 // several steps (JOIN, AUTH, ASSOC or REASSOC) and may fail at any step. We purposely
981 // separate this under-trial settings away from pAd->StaActive so that once
982 // this new attempt failed, driver can auto-recover back to the active settings.
983 typedef struct _MLME_AUX {
985 UCHAR Ssid[MAX_LEN_OF_SSID];
987 UCHAR Bssid[MAC_ADDR_LEN];
988 UCHAR AutoReconnectSsid[MAX_LEN_OF_SSID];
989 UCHAR AutoReconnectSsidLen;
993 UCHAR CentralChannel;
995 USHORT CapabilityInfo;
997 USHORT CfpMaxDuration;
1001 // Copy supported rate from desired AP's beacon. We are trying to match
1002 // AP's supported and extended rate settings.
1003 UCHAR SupRate[MAX_LEN_OF_SUPPORTED_RATES];
1004 UCHAR ExtRate[MAX_LEN_OF_SUPPORTED_RATES];
1007 HT_CAPABILITY_IE HtCapability;
1008 UCHAR HtCapabilityLen;
1009 ADD_HT_INFO_IE AddHtInfo; // AP might use this additional ht info IE
1010 UCHAR NewExtChannelOffset;
1011 //RT_HT_CAPABILITY SupportedHtPhy;
1014 QOS_CAPABILITY_PARM APQosCapability; // QOS capability of the current associated AP
1015 EDCA_PARM APEdcaParm; // EDCA parameters of the current associated AP
1016 QBSS_LOAD_PARM APQbssLoad; // QBSS load of the current associated AP
1018 // new to keep Ralink specific feature
1021 BSS_TABLE SsidBssTab; // AP list for the same SSID
1022 BSS_TABLE RoamTab; // AP list eligible for roaming
1026 BOOLEAN CurrReqIsFromNdis;
1028 RALINK_TIMER_STRUCT BeaconTimer, ScanTimer;
1029 RALINK_TIMER_STRUCT AuthTimer;
1030 RALINK_TIMER_STRUCT AssocTimer, ReassocTimer, DisassocTimer;
1031 } MLME_AUX, *PMLME_AUX;
1033 typedef struct _MLME_ADDBA_REQ_STRUCT{
1035 UCHAR pAddr[MAC_ADDR_LEN];
1037 USHORT TimeOutValue;
1041 } MLME_ADDBA_REQ_STRUCT, *PMLME_ADDBA_REQ_STRUCT;
1044 typedef struct _MLME_DELBA_REQ_STRUCT{
1046 UCHAR Addr[MAC_ADDR_LEN];
1049 } MLME_DELBA_REQ_STRUCT, *PMLME_DELBA_REQ_STRUCT;
1051 // assoc struct is equal to reassoc
1052 typedef struct _MLME_ASSOC_REQ_STRUCT{
1053 UCHAR Addr[MAC_ADDR_LEN];
1054 USHORT CapabilityInfo;
1057 } MLME_ASSOC_REQ_STRUCT, *PMLME_ASSOC_REQ_STRUCT, MLME_REASSOC_REQ_STRUCT, *PMLME_REASSOC_REQ_STRUCT;
1059 typedef struct _MLME_DISASSOC_REQ_STRUCT{
1060 UCHAR Addr[MAC_ADDR_LEN];
1062 } MLME_DISASSOC_REQ_STRUCT, *PMLME_DISASSOC_REQ_STRUCT;
1064 typedef struct _MLME_AUTH_REQ_STRUCT {
1065 UCHAR Addr[MAC_ADDR_LEN];
1068 } MLME_AUTH_REQ_STRUCT, *PMLME_AUTH_REQ_STRUCT;
1070 typedef struct _MLME_DEAUTH_REQ_STRUCT {
1071 UCHAR Addr[MAC_ADDR_LEN];
1073 } MLME_DEAUTH_REQ_STRUCT, *PMLME_DEAUTH_REQ_STRUCT;
1077 } MLME_JOIN_REQ_STRUCT;
1079 typedef struct _MLME_SCAN_REQ_STRUCT {
1080 UCHAR Bssid[MAC_ADDR_LEN];
1084 CHAR Ssid[MAX_LEN_OF_SSID];
1085 } MLME_SCAN_REQ_STRUCT, *PMLME_SCAN_REQ_STRUCT;
1087 typedef struct _MLME_START_REQ_STRUCT {
1088 CHAR Ssid[MAX_LEN_OF_SSID];
1090 } MLME_START_REQ_STRUCT, *PMLME_START_REQ_STRUCT;
1092 typedef struct PACKED {
1096 } EID_STRUCT,*PEID_STRUCT, BEACON_EID_STRUCT, *PBEACON_EID_STRUCT;
1098 typedef struct PACKED _RTMP_TX_RATE_SWITCH
1110 } RRTMP_TX_RATE_SWITCH, *PRTMP_TX_RATE_SWITCH;
1112 // ========================== AP mlme.h ===============================
1113 #define TBTT_PRELOAD_TIME 384 // usec. LomgPreamble + 24-byte at 1Mbps
1114 #define DEFAULT_DTIM_PERIOD 1
1116 // weighting factor to calculate Channel quality, total should be 100%
1117 //#define RSSI_WEIGHTING 0
1118 //#define TX_WEIGHTING 40
1119 //#define RX_WEIGHTING 60
1121 #define MAC_TABLE_AGEOUT_TIME 300 // unit: sec
1122 #define MAC_TABLE_ASSOC_TIMEOUT 5 // unit: sec
1123 #define MAC_TABLE_FULL(Tab) ((Tab).size == MAX_LEN_OF_MAC_TABLE)
1125 // AP shall drop the sta if contine Tx fail count reach it.
1126 #define MAC_ENTRY_LIFE_CHECK_CNT 20 // packet cnt.
1128 // Value domain of pMacEntry->Sst
1130 SST_NOT_AUTH, // 0: equivalent to IEEE 802.11/1999 state 1
1131 SST_AUTH, // 1: equivalent to IEEE 802.11/1999 state 2
1132 SST_ASSOC // 2: equivalent to IEEE 802.11/1999 state 3
1135 // value domain of pMacEntry->AuthState
1136 typedef enum _AuthState {
1138 AS_AUTH_OPEN, // STA has been authenticated using OPEN SYSTEM
1139 AS_AUTH_KEY, // STA has been authenticated using SHARED KEY
1140 AS_AUTHENTICATING // STA is waiting for AUTH seq#3 using SHARED KEY
1143 //for-wpa value domain of pMacEntry->WpaState 802.1i D3 p.114
1144 typedef enum _ApWpaState {
1147 AS_DISCONNECTED, // 2
1149 AS_AUTHENTICATION, // 4
1150 AS_AUTHENTICATION2, // 5
1154 AS_PTKINIT_NEGOTIATING, // 9
1155 AS_PTKINITDONE, // 10
1156 AS_UPDATEKEYS, // 11
1157 AS_INTEGRITY_FAILURE, // 12
1161 // for-wpa value domain of pMacEntry->WpaState 802.1i D3 p.114
1162 typedef enum _GTKState {
1168 // for-wpa value domain of pMacEntry->WpaState 802.1i D3 p.114
1169 typedef enum _WpaGTKState {
1173 // ====================== end of AP mlme.h ============================