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
81 spinlock_t lock;
82 spinlock_t lock2;
83 sint fw_state; /*shall we protect this variable? */
84 u8 to_join; /*flag*/
85 u8 *nic_hdl;
86 struct list_head *pscanned;
87 struct __queue free_bss_pool;
88 struct __queue scanned_queue;
89 u8 *free_bss_buf;
90 unsigned long num_of_scanned;
91 u8 passive_mode; /*add for Android's SCAN-ACTIVE/SCAN-PASSIVE */
92 struct ndis_802_11_ssid assoc_ssid;
93 u8 assoc_bssid[6];
94 struct wlan_network cur_network;
95 struct sitesurvey_ctrl sitesurveyctrl;
96 struct timer_list assoc_timer;
97 uint assoc_by_bssid;
98 uint assoc_by_rssi;
99 struct timer_list scan_to_timer; /* driver handles scan_timeout.*/
100 struct timer_list dhcp_timer; /* set dhcp to if driver in ps mode.*/
101 struct qos_priv qospriv;
102 struct ht_priv htpriv;
103 struct timer_list wdg_timer; /*watchdog periodic timer*/
104 };
105
get_bssid(struct mlme_priv * pmlmepriv)106 static inline u8 *get_bssid(struct mlme_priv *pmlmepriv)
107 {
108 return pmlmepriv->cur_network.network.MacAddress;
109 }
110
check_fwstate(struct mlme_priv * pmlmepriv,sint state)111 static inline u8 check_fwstate(struct mlme_priv *pmlmepriv, sint state)
112 {
113 if (pmlmepriv->fw_state & state)
114 return true;
115 return false;
116 }
117
get_fwstate(struct mlme_priv * pmlmepriv)118 static inline sint get_fwstate(struct mlme_priv *pmlmepriv)
119 {
120 return pmlmepriv->fw_state;
121 }
122
123 /*
124 * No Limit on the calling context,
125 * therefore set it to be the critical section...
126 *
127 * ### NOTE:#### (!!!!)
128 * TAKE CARE BEFORE CALLING THIS FUNC, LOCK pmlmepriv->lock
129 */
set_fwstate(struct mlme_priv * pmlmepriv,sint state)130 static inline void set_fwstate(struct mlme_priv *pmlmepriv, sint state)
131 {
132 pmlmepriv->fw_state |= state;
133 }
134
_clr_fwstate_(struct mlme_priv * pmlmepriv,sint state)135 static inline void _clr_fwstate_(struct mlme_priv *pmlmepriv, sint state)
136 {
137 pmlmepriv->fw_state &= ~state;
138 }
139
140 /*
141 * No Limit on the calling context,
142 * therefore set it to be the critical section...
143 */
clr_fwstate(struct mlme_priv * pmlmepriv,sint state)144 static inline void clr_fwstate(struct mlme_priv *pmlmepriv, sint state)
145 {
146 unsigned long irqL;
147
148 spin_lock_irqsave(&pmlmepriv->lock, irqL);
149 if (check_fwstate(pmlmepriv, state))
150 pmlmepriv->fw_state ^= state;
151 spin_unlock_irqrestore(&pmlmepriv->lock, irqL);
152 }
153
set_scanned_network_val(struct mlme_priv * pmlmepriv,sint val)154 static inline void set_scanned_network_val(struct mlme_priv *pmlmepriv,
155 sint val)
156 {
157 unsigned long irqL;
158
159 spin_lock_irqsave(&pmlmepriv->lock, irqL);
160 pmlmepriv->num_of_scanned = val;
161 spin_unlock_irqrestore(&pmlmepriv->lock, irqL);
162 }
163
164 void r8712_survey_event_callback(struct _adapter *adapter, u8 *pbuf);
165 void r8712_surveydone_event_callback(struct _adapter *adapter, u8 *pbuf);
166 void r8712_joinbss_event_callback(struct _adapter *adapter, u8 *pbuf);
167 void r8712_stassoc_event_callback(struct _adapter *adapter, u8 *pbuf);
168 void r8712_stadel_event_callback(struct _adapter *adapter, u8 *pbuf);
169 void r8712_atimdone_event_callback(struct _adapter *adapter, u8 *pbuf);
170 void r8712_cpwm_event_callback(struct _adapter *adapter, u8 *pbuf);
171 void r8712_wpspbc_event_callback(struct _adapter *adapter, u8 *pbuf);
172 void r8712_free_network_queue(struct _adapter *adapter);
173 int r8712_init_mlme_priv(struct _adapter *adapter);
174 void r8712_free_mlme_priv(struct mlme_priv *pmlmepriv);
175 int r8712_select_and_join_from_scan(struct mlme_priv *pmlmepriv);
176 int r8712_set_key(struct _adapter *adapter,
177 struct security_priv *psecuritypriv, sint keyid);
178 int r8712_set_auth(struct _adapter *adapter,
179 struct security_priv *psecuritypriv);
180 uint r8712_get_wlan_bssid_ex_sz(struct wlan_bssid_ex *bss);
181 void r8712_generate_random_ibss(u8 *pibss);
182 u8 *r8712_get_capability_from_ie(u8 *ie);
183 struct wlan_network *r8712_get_oldest_wlan_network(
184 struct __queue *scanned_queue);
185 void r8712_free_assoc_resources(struct _adapter *adapter);
186 void r8712_ind_disconnect(struct _adapter *adapter);
187 void r8712_indicate_connect(struct _adapter *adapter);
188 int r8712_restruct_sec_ie(struct _adapter *adapter, u8 *in_ie,
189 u8 *out_ie, uint in_len);
190 int r8712_restruct_wmm_ie(struct _adapter *adapter, u8 *in_ie,
191 u8 *out_ie, uint in_len, uint initial_out_len);
192 void r8712_init_registrypriv_dev_network(struct _adapter *adapter);
193 void r8712_update_registrypriv_dev_network(struct _adapter *adapter);
194 void _r8712_sitesurvey_ctrl_handler(struct _adapter *adapter);
195 void _r8712_join_timeout_handler(struct _adapter *adapter);
196 void r8712_scan_timeout_handler(struct _adapter *adapter);
197 void _r8712_dhcp_timeout_handler(struct _adapter *adapter);
198 struct wlan_network *_r8712_alloc_network(struct mlme_priv *pmlmepriv);
199 sint r8712_if_up(struct _adapter *padapter);
200 void r8712_joinbss_reset(struct _adapter *padapter);
201 unsigned int r8712_restructure_ht_ie(struct _adapter *padapter, u8 *in_ie,
202 u8 *out_ie, uint in_len, uint *pout_len);
203 void r8712_issue_addbareq_cmd(struct _adapter *padapter, int priority);
204 int r8712_is_same_ibss(struct _adapter *adapter, struct wlan_network *pnetwork);
205
206 #endif /*__RTL871X_MLME_H_*/
207