1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /****************************************************************************** 3 * 4 * Copyright(c) 2007 - 2010 Realtek Corporation. All rights reserved. 5 * 6 * Modifications for inclusion into the Linux staging tree are 7 * Copyright(c) 2010 Larry Finger. All rights reserved. 8 * 9 * Contact information: 10 * WLAN FAE <wlanfae@realtek.com> 11 * Larry Finger <Larry.Finger@lwfinger.net> 12 * 13 ******************************************************************************/ 14 #ifndef __RTL871X_MLME_H_ 15 #define __RTL871X_MLME_H_ 16 17 #include "osdep_service.h" 18 #include "drv_types.h" 19 #include "wlan_bssdef.h" 20 21 #define MAX_BSS_CNT 64 22 #define MAX_JOIN_TIMEOUT 6000 23 24 #define SCANNING_TIMEOUT 4500 25 26 #define SCANQUEUE_LIFETIME 20 /* unit:sec */ 27 28 #define WIFI_NULL_STATE 0x00000000 29 #define WIFI_ASOC_STATE 0x00000001 /* Under Linked state...*/ 30 #define WIFI_REASOC_STATE 0x00000002 31 #define WIFI_SLEEP_STATE 0x00000004 32 #define WIFI_STATION_STATE 0x00000008 33 #define WIFI_AP_STATE 0x00000010 34 #define WIFI_ADHOC_STATE 0x00000020 35 #define WIFI_ADHOC_MASTER_STATE 0x00000040 36 #define WIFI_UNDER_LINKING 0x00000080 37 #define WIFI_SITE_MONITOR 0x00000800 /* to indicate the station 38 * is under site surveying 39 */ 40 #define WIFI_MP_STATE 0x00010000 41 #define WIFI_MP_CTX_BACKGROUND 0x00020000 /* in cont. tx background*/ 42 #define WIFI_MP_CTX_ST 0x00040000 /* in cont. tx with 43 * single-tone 44 */ 45 #define WIFI_MP_CTX_BACKGROUND_PENDING 0x00080000 /* pending in cont, tx 46 * background due 47 * to out of skb 48 */ 49 #define WIFI_MP_CTX_CCK_HW 0x00100000 /* in continuous tx*/ 50 #define WIFI_MP_CTX_CCK_CS 0x00200000 /* in cont, tx with carrier 51 * suppression 52 */ 53 #define WIFI_MP_LPBK_STATE 0x00400000 54 55 #define _FW_UNDER_LINKING WIFI_UNDER_LINKING 56 #define _FW_LINKED WIFI_ASOC_STATE 57 #define _FW_UNDER_SURVEY WIFI_SITE_MONITOR 58 59 /* 60 * there are several "locks" in mlme_priv, 61 * since mlme_priv is a shared resource between many threads, 62 * like ISR/Call-Back functions, the OID handlers, and even timer functions. 63 * Each _queue has its own locks, already. 64 * Other items are protected by mlme_priv.lock. 65 * To avoid possible dead lock, any thread trying to modify mlme_priv 66 * SHALL not lock up more than one lock at a time! 67 */ 68 69 #define traffic_threshold 10 70 #define traffic_scan_period 500 71 72 struct sitesurvey_ctrl { 73 u64 last_tx_pkts; 74 uint last_rx_pkts; 75 sint traffic_busy; 76 struct timer_list sitesurvey_ctrl_timer; 77 }; 78 79 struct mlme_priv { 80 spinlock_t lock; 81 spinlock_t lock2; 82 sint fw_state; /*shall we protect this variable? */ 83 u8 to_join; /*flag*/ 84 u8 *nic_hdl; 85 struct list_head *pscanned; 86 struct __queue free_bss_pool; 87 struct __queue scanned_queue; 88 u8 *free_bss_buf; 89 unsigned long num_of_scanned; 90 u8 passive_mode; /*add for Android's SCAN-ACTIVE/SCAN-PASSIVE */ 91 struct ndis_802_11_ssid assoc_ssid; 92 u8 assoc_bssid[6]; 93 struct wlan_network cur_network; 94 struct sitesurvey_ctrl sitesurveyctrl; 95 struct timer_list assoc_timer; 96 uint assoc_by_bssid; 97 uint assoc_by_rssi; 98 struct timer_list scan_to_timer; /* driver handles scan_timeout.*/ 99 struct timer_list dhcp_timer; /* set dhcp to if driver in ps mode.*/ 100 struct qos_priv qospriv; 101 struct ht_priv htpriv; 102 struct timer_list wdg_timer; /*watchdog periodic timer*/ 103 }; 104 105 static inline u8 *get_bssid(struct mlme_priv *pmlmepriv) 106 { 107 return pmlmepriv->cur_network.network.MacAddress; 108 } 109 110 static inline u8 check_fwstate(struct mlme_priv *pmlmepriv, sint state) 111 { 112 if (pmlmepriv->fw_state & state) 113 return true; 114 return false; 115 } 116 117 static inline sint get_fwstate(struct mlme_priv *pmlmepriv) 118 { 119 return pmlmepriv->fw_state; 120 } 121 122 /* 123 * No Limit on the calling context, 124 * therefore set it to be the critical section... 125 * 126 * ### NOTE:#### (!!!!) 127 * TAKE CARE BEFORE CALLING THIS FUNC, LOCK pmlmepriv->lock 128 */ 129 static inline void set_fwstate(struct mlme_priv *pmlmepriv, sint state) 130 { 131 pmlmepriv->fw_state |= state; 132 } 133 134 static inline void _clr_fwstate_(struct mlme_priv *pmlmepriv, sint state) 135 { 136 pmlmepriv->fw_state &= ~state; 137 } 138 139 /* 140 * No Limit on the calling context, 141 * therefore set it to be the critical section... 142 */ 143 static inline void clr_fwstate(struct mlme_priv *pmlmepriv, sint state) 144 { 145 unsigned long irqL; 146 147 spin_lock_irqsave(&pmlmepriv->lock, irqL); 148 if (check_fwstate(pmlmepriv, state)) 149 pmlmepriv->fw_state ^= state; 150 spin_unlock_irqrestore(&pmlmepriv->lock, irqL); 151 } 152 153 static inline void set_scanned_network_val(struct mlme_priv *pmlmepriv, 154 sint val) 155 { 156 unsigned long irqL; 157 158 spin_lock_irqsave(&pmlmepriv->lock, irqL); 159 pmlmepriv->num_of_scanned = val; 160 spin_unlock_irqrestore(&pmlmepriv->lock, irqL); 161 } 162 163 void r8712_survey_event_callback(struct _adapter *adapter, u8 *pbuf); 164 void r8712_surveydone_event_callback(struct _adapter *adapter, u8 *pbuf); 165 void r8712_joinbss_event_callback(struct _adapter *adapter, u8 *pbuf); 166 void r8712_stassoc_event_callback(struct _adapter *adapter, u8 *pbuf); 167 void r8712_stadel_event_callback(struct _adapter *adapter, u8 *pbuf); 168 void r8712_atimdone_event_callback(struct _adapter *adapter, u8 *pbuf); 169 void r8712_cpwm_event_callback(struct _adapter *adapter, u8 *pbuf); 170 void r8712_wpspbc_event_callback(struct _adapter *adapter, u8 *pbuf); 171 void r8712_free_network_queue(struct _adapter *adapter); 172 int r8712_init_mlme_priv(struct _adapter *adapter); 173 void r8712_free_mlme_priv(struct mlme_priv *pmlmepriv); 174 int r8712_select_and_join_from_scan(struct mlme_priv *pmlmepriv); 175 int r8712_set_key(struct _adapter *adapter, 176 struct security_priv *psecuritypriv, sint keyid); 177 int r8712_set_auth(struct _adapter *adapter, 178 struct security_priv *psecuritypriv); 179 uint r8712_get_wlan_bssid_ex_sz(struct wlan_bssid_ex *bss); 180 void r8712_generate_random_ibss(u8 *pibss); 181 u8 *r8712_get_capability_from_ie(u8 *ie); 182 struct wlan_network *r8712_get_oldest_wlan_network( 183 struct __queue *scanned_queue); 184 void r8712_free_assoc_resources(struct _adapter *adapter); 185 void r8712_ind_disconnect(struct _adapter *adapter); 186 void r8712_indicate_connect(struct _adapter *adapter); 187 int r8712_restruct_sec_ie(struct _adapter *adapter, u8 *in_ie, 188 u8 *out_ie, uint in_len); 189 int r8712_restruct_wmm_ie(struct _adapter *adapter, u8 *in_ie, 190 u8 *out_ie, uint in_len, uint initial_out_len); 191 void r8712_init_registrypriv_dev_network(struct _adapter *adapter); 192 void r8712_update_registrypriv_dev_network(struct _adapter *adapter); 193 void _r8712_sitesurvey_ctrl_handler(struct _adapter *adapter); 194 void _r8712_join_timeout_handler(struct _adapter *adapter); 195 void r8712_scan_timeout_handler(struct _adapter *adapter); 196 void _r8712_dhcp_timeout_handler(struct _adapter *adapter); 197 struct wlan_network *_r8712_alloc_network(struct mlme_priv *pmlmepriv); 198 sint r8712_if_up(struct _adapter *padapter); 199 void r8712_joinbss_reset(struct _adapter *padapter); 200 unsigned int r8712_restructure_ht_ie(struct _adapter *padapter, u8 *in_ie, 201 u8 *out_ie, uint in_len, uint *pout_len); 202 void r8712_issue_addbareq_cmd(struct _adapter *padapter, int priority); 203 int r8712_is_same_ibss(struct _adapter *adapter, struct wlan_network *pnetwork); 204 205 #endif /*__RTL871X_MLME_H_*/ 206