Root/
1 | /* |
2 | * Copyright 2002-2005, Devicescape Software, Inc. |
3 | * |
4 | * This program is free software; you can redistribute it and/or modify |
5 | * it under the terms of the GNU General Public License version 2 as |
6 | * published by the Free Software Foundation. |
7 | */ |
8 | |
9 | #ifndef STA_INFO_H |
10 | #define STA_INFO_H |
11 | |
12 | #include <linux/list.h> |
13 | #include <linux/types.h> |
14 | #include <linux/if_ether.h> |
15 | #include <linux/workqueue.h> |
16 | #include "key.h" |
17 | |
18 | /** |
19 | * enum ieee80211_sta_info_flags - Stations flags |
20 | * |
21 | * These flags are used with &struct sta_info's @flags member. |
22 | * |
23 | * @WLAN_STA_AUTH: Station is authenticated. |
24 | * @WLAN_STA_ASSOC: Station is associated. |
25 | * @WLAN_STA_PS_STA: Station is in power-save mode |
26 | * @WLAN_STA_AUTHORIZED: Station is authorized to send/receive traffic. |
27 | * This bit is always checked so needs to be enabled for all stations |
28 | * when virtual port control is not in use. |
29 | * @WLAN_STA_SHORT_PREAMBLE: Station is capable of receiving short-preamble |
30 | * frames. |
31 | * @WLAN_STA_ASSOC_AP: We're associated to that station, it is an AP. |
32 | * @WLAN_STA_WME: Station is a QoS-STA. |
33 | * @WLAN_STA_WDS: Station is one of our WDS peers. |
34 | * @WLAN_STA_CLEAR_PS_FILT: Clear PS filter in hardware (using the |
35 | * IEEE80211_TX_CTL_CLEAR_PS_FILT control flag) when the next |
36 | * frame to this station is transmitted. |
37 | * @WLAN_STA_MFP: Management frame protection is used with this STA. |
38 | * @WLAN_STA_SUSPEND: Set/cleared during a suspend/resume cycle. |
39 | * Used to deny ADDBA requests (both TX and RX). |
40 | * @WLAN_STA_PS_DRIVER: driver requires keeping this station in |
41 | * power-save mode logically to flush frames that might still |
42 | * be in the queues |
43 | * @WLAN_STA_PSPOLL: Station sent PS-poll while driver was keeping |
44 | * station in power-save mode, reply when the driver unblocks. |
45 | * @WLAN_STA_DISASSOC: Disassociation in progress. |
46 | * This is used to reject TX BA session requests when disassociation |
47 | * is in progress. |
48 | */ |
49 | enum ieee80211_sta_info_flags { |
50 | WLAN_STA_AUTH = 1<<0, |
51 | WLAN_STA_ASSOC = 1<<1, |
52 | WLAN_STA_PS_STA = 1<<2, |
53 | WLAN_STA_AUTHORIZED = 1<<3, |
54 | WLAN_STA_SHORT_PREAMBLE = 1<<4, |
55 | WLAN_STA_ASSOC_AP = 1<<5, |
56 | WLAN_STA_WME = 1<<6, |
57 | WLAN_STA_WDS = 1<<7, |
58 | WLAN_STA_CLEAR_PS_FILT = 1<<9, |
59 | WLAN_STA_MFP = 1<<10, |
60 | WLAN_STA_SUSPEND = 1<<11, |
61 | WLAN_STA_PS_DRIVER = 1<<12, |
62 | WLAN_STA_PSPOLL = 1<<13, |
63 | WLAN_STA_DISASSOC = 1<<14, |
64 | }; |
65 | |
66 | #define STA_TID_NUM 16 |
67 | #define ADDBA_RESP_INTERVAL HZ |
68 | #define HT_AGG_MAX_RETRIES (0x3) |
69 | |
70 | #define HT_AGG_STATE_INITIATOR_SHIFT (4) |
71 | |
72 | #define HT_ADDBA_REQUESTED_MSK BIT(0) |
73 | #define HT_ADDBA_DRV_READY_MSK BIT(1) |
74 | #define HT_ADDBA_RECEIVED_MSK BIT(2) |
75 | #define HT_AGG_STATE_REQ_STOP_BA_MSK BIT(3) |
76 | #define HT_AGG_STATE_INITIATOR_MSK BIT(HT_AGG_STATE_INITIATOR_SHIFT) |
77 | #define HT_AGG_STATE_IDLE (0x0) |
78 | #define HT_AGG_STATE_OPERATIONAL (HT_ADDBA_REQUESTED_MSK | \ |
79 | HT_ADDBA_DRV_READY_MSK | \ |
80 | HT_ADDBA_RECEIVED_MSK) |
81 | |
82 | /** |
83 | * struct tid_ampdu_tx - TID aggregation information (Tx). |
84 | * |
85 | * @addba_resp_timer: timer for peer's response to addba request |
86 | * @pending: pending frames queue -- use sta's spinlock to protect |
87 | * @ssn: Starting Sequence Number expected to be aggregated. |
88 | * @dialog_token: dialog token for aggregation session |
89 | */ |
90 | struct tid_ampdu_tx { |
91 | struct timer_list addba_resp_timer; |
92 | struct sk_buff_head pending; |
93 | u16 ssn; |
94 | u8 dialog_token; |
95 | }; |
96 | |
97 | /** |
98 | * struct tid_ampdu_rx - TID aggregation information (Rx). |
99 | * |
100 | * @reorder_buf: buffer to reorder incoming aggregated MPDUs |
101 | * @reorder_time: jiffies when skb was added |
102 | * @session_timer: check if peer keeps Tx-ing on the TID (by timeout value) |
103 | * @head_seq_num: head sequence number in reordering buffer. |
104 | * @stored_mpdu_num: number of MPDUs in reordering buffer |
105 | * @ssn: Starting Sequence Number expected to be aggregated. |
106 | * @buf_size: buffer size for incoming A-MPDUs |
107 | * @timeout: reset timer value (in TUs). |
108 | * @dialog_token: dialog token for aggregation session |
109 | * @shutdown: this session is being shut down due to STA removal |
110 | */ |
111 | struct tid_ampdu_rx { |
112 | struct sk_buff **reorder_buf; |
113 | unsigned long *reorder_time; |
114 | struct timer_list session_timer; |
115 | u16 head_seq_num; |
116 | u16 stored_mpdu_num; |
117 | u16 ssn; |
118 | u16 buf_size; |
119 | u16 timeout; |
120 | u8 dialog_token; |
121 | bool shutdown; |
122 | }; |
123 | |
124 | /** |
125 | * enum plink_state - state of a mesh peer link finite state machine |
126 | * |
127 | * @PLINK_LISTEN: initial state, considered the implicit state of non existant |
128 | * mesh peer links |
129 | * @PLINK_OPN_SNT: mesh plink open frame has been sent to this mesh peer |
130 | * @PLINK_OPN_RCVD: mesh plink open frame has been received from this mesh peer |
131 | * @PLINK_CNF_RCVD: mesh plink confirm frame has been received from this mesh |
132 | * peer |
133 | * @PLINK_ESTAB: mesh peer link is established |
134 | * @PLINK_HOLDING: mesh peer link is being closed or cancelled |
135 | * @PLINK_BLOCKED: all frames transmitted from this mesh plink are discarded |
136 | */ |
137 | enum plink_state { |
138 | PLINK_LISTEN, |
139 | PLINK_OPN_SNT, |
140 | PLINK_OPN_RCVD, |
141 | PLINK_CNF_RCVD, |
142 | PLINK_ESTAB, |
143 | PLINK_HOLDING, |
144 | PLINK_BLOCKED |
145 | }; |
146 | |
147 | /** |
148 | * struct sta_ampdu_mlme - STA aggregation information. |
149 | * |
150 | * @tid_state_rx: TID's state in Rx session state machine. |
151 | * @tid_rx: aggregation info for Rx per TID |
152 | * @tid_state_tx: TID's state in Tx session state machine. |
153 | * @tid_tx: aggregation info for Tx per TID |
154 | * @addba_req_num: number of times addBA request has been sent. |
155 | * @dialog_token_allocator: dialog token enumerator for each new session; |
156 | */ |
157 | struct sta_ampdu_mlme { |
158 | /* rx */ |
159 | u8 tid_state_rx[STA_TID_NUM]; |
160 | struct tid_ampdu_rx *tid_rx[STA_TID_NUM]; |
161 | /* tx */ |
162 | u8 tid_state_tx[STA_TID_NUM]; |
163 | struct tid_ampdu_tx *tid_tx[STA_TID_NUM]; |
164 | u8 addba_req_num[STA_TID_NUM]; |
165 | u8 dialog_token_allocator; |
166 | }; |
167 | |
168 | |
169 | /** |
170 | * struct sta_info - STA information |
171 | * |
172 | * This structure collects information about a station that |
173 | * mac80211 is communicating with. |
174 | * |
175 | * @list: global linked list entry |
176 | * @hnext: hash table linked list pointer |
177 | * @local: pointer to the global information |
178 | * @sdata: virtual interface this station belongs to |
179 | * @key: peer key negotiated with this station, if any |
180 | * @rate_ctrl: rate control algorithm reference |
181 | * @rate_ctrl_priv: rate control private per-STA pointer |
182 | * @last_tx_rate: rate used for last transmit, to report to userspace as |
183 | * "the" transmit rate |
184 | * @lock: used for locking all fields that require locking, see comments |
185 | * in the header file. |
186 | * @flaglock: spinlock for flags accesses |
187 | * @drv_unblock_wk: used for driver PS unblocking |
188 | * @listen_interval: listen interval of this station, when we're acting as AP |
189 | * @flags: STA flags, see &enum ieee80211_sta_info_flags |
190 | * @ps_tx_buf: buffer of frames to transmit to this station |
191 | * when it leaves power saving state |
192 | * @tx_filtered: buffer of frames we already tried to transmit |
193 | * but were filtered by hardware due to STA having entered |
194 | * power saving state |
195 | * @rx_packets: Number of MSDUs received from this STA |
196 | * @rx_bytes: Number of bytes received from this STA |
197 | * @wep_weak_iv_count: number of weak WEP IVs received from this station |
198 | * @last_rx: time (in jiffies) when last frame was received from this STA |
199 | * @num_duplicates: number of duplicate frames received from this STA |
200 | * @rx_fragments: number of received MPDUs |
201 | * @rx_dropped: number of dropped MPDUs from this STA |
202 | * @last_signal: signal of last received frame from this STA |
203 | * @last_noise: noise of last received frame from this STA |
204 | * @last_seq_ctrl: last received seq/frag number from this STA (per RX queue) |
205 | * @tx_filtered_count: number of frames the hardware filtered for this STA |
206 | * @tx_retry_failed: number of frames that failed retry |
207 | * @tx_retry_count: total number of retries for frames to this STA |
208 | * @fail_avg: moving percentage of failed MSDUs |
209 | * @tx_packets: number of RX/TX MSDUs |
210 | * @tx_bytes: number of bytes transmitted to this STA |
211 | * @tx_fragments: number of transmitted MPDUs |
212 | * @tid_seq: per-TID sequence numbers for sending to this STA |
213 | * @ampdu_mlme: A-MPDU state machine state |
214 | * @timer_to_tid: identity mapping to ID timers |
215 | * @llid: Local link ID |
216 | * @plid: Peer link ID |
217 | * @reason: Cancel reason on PLINK_HOLDING state |
218 | * @plink_retries: Retries in establishment |
219 | * @ignore_plink_timer: ignore the peer-link timer (used internally) |
220 | * @plink_state: peer link state |
221 | * @plink_timeout: timeout of peer link |
222 | * @plink_timer: peer link watch timer |
223 | * @plink_timer_was_running: used by suspend/resume to restore timers |
224 | * @debugfs: debug filesystem info |
225 | * @sta: station information we share with the driver |
226 | * @dead: set to true when sta is unlinked |
227 | * @uploaded: set to true when sta is uploaded to the driver |
228 | */ |
229 | struct sta_info { |
230 | /* General information, mostly static */ |
231 | struct list_head list; |
232 | struct sta_info *hnext; |
233 | struct ieee80211_local *local; |
234 | struct ieee80211_sub_if_data *sdata; |
235 | struct ieee80211_key *key; |
236 | struct rate_control_ref *rate_ctrl; |
237 | void *rate_ctrl_priv; |
238 | spinlock_t lock; |
239 | spinlock_t flaglock; |
240 | |
241 | struct work_struct drv_unblock_wk; |
242 | |
243 | u16 listen_interval; |
244 | |
245 | bool dead; |
246 | |
247 | bool uploaded; |
248 | |
249 | /* |
250 | * frequently updated, locked with own spinlock (flaglock), |
251 | * use the accessors defined below |
252 | */ |
253 | u32 flags; |
254 | |
255 | /* |
256 | * STA powersave frame queues, no more than the internal |
257 | * locking required. |
258 | */ |
259 | struct sk_buff_head ps_tx_buf; |
260 | struct sk_buff_head tx_filtered; |
261 | |
262 | /* Updated from RX path only, no locking requirements */ |
263 | unsigned long rx_packets, rx_bytes; |
264 | unsigned long wep_weak_iv_count; |
265 | unsigned long last_rx; |
266 | unsigned long num_duplicates; |
267 | unsigned long rx_fragments; |
268 | unsigned long rx_dropped; |
269 | int last_signal; |
270 | int last_noise; |
271 | __le16 last_seq_ctrl[NUM_RX_DATA_QUEUES]; |
272 | |
273 | /* Updated from TX status path only, no locking requirements */ |
274 | unsigned long tx_filtered_count; |
275 | unsigned long tx_retry_failed, tx_retry_count; |
276 | /* moving percentage of failed MSDUs */ |
277 | unsigned int fail_avg; |
278 | |
279 | /* Updated from TX path only, no locking requirements */ |
280 | unsigned long tx_packets; |
281 | unsigned long tx_bytes; |
282 | unsigned long tx_fragments; |
283 | struct ieee80211_tx_rate last_tx_rate; |
284 | u16 tid_seq[IEEE80211_QOS_CTL_TID_MASK + 1]; |
285 | |
286 | /* |
287 | * Aggregation information, locked with lock. |
288 | */ |
289 | struct sta_ampdu_mlme ampdu_mlme; |
290 | u8 timer_to_tid[STA_TID_NUM]; |
291 | |
292 | #ifdef CONFIG_MAC80211_MESH |
293 | /* |
294 | * Mesh peer link attributes |
295 | * TODO: move to a sub-structure that is referenced with pointer? |
296 | */ |
297 | __le16 llid; |
298 | __le16 plid; |
299 | __le16 reason; |
300 | u8 plink_retries; |
301 | bool ignore_plink_timer; |
302 | bool plink_timer_was_running; |
303 | enum plink_state plink_state; |
304 | u32 plink_timeout; |
305 | struct timer_list plink_timer; |
306 | #endif |
307 | |
308 | #ifdef CONFIG_MAC80211_DEBUGFS |
309 | struct sta_info_debugfsdentries { |
310 | struct dentry *dir; |
311 | bool add_has_run; |
312 | } debugfs; |
313 | #endif |
314 | |
315 | /* keep last! */ |
316 | struct ieee80211_sta sta; |
317 | }; |
318 | |
319 | static inline enum plink_state sta_plink_state(struct sta_info *sta) |
320 | { |
321 | #ifdef CONFIG_MAC80211_MESH |
322 | return sta->plink_state; |
323 | #endif |
324 | return PLINK_LISTEN; |
325 | } |
326 | |
327 | static inline void set_sta_flags(struct sta_info *sta, const u32 flags) |
328 | { |
329 | unsigned long irqfl; |
330 | |
331 | spin_lock_irqsave(&sta->flaglock, irqfl); |
332 | sta->flags |= flags; |
333 | spin_unlock_irqrestore(&sta->flaglock, irqfl); |
334 | } |
335 | |
336 | static inline void clear_sta_flags(struct sta_info *sta, const u32 flags) |
337 | { |
338 | unsigned long irqfl; |
339 | |
340 | spin_lock_irqsave(&sta->flaglock, irqfl); |
341 | sta->flags &= ~flags; |
342 | spin_unlock_irqrestore(&sta->flaglock, irqfl); |
343 | } |
344 | |
345 | static inline u32 test_sta_flags(struct sta_info *sta, const u32 flags) |
346 | { |
347 | u32 ret; |
348 | unsigned long irqfl; |
349 | |
350 | spin_lock_irqsave(&sta->flaglock, irqfl); |
351 | ret = sta->flags & flags; |
352 | spin_unlock_irqrestore(&sta->flaglock, irqfl); |
353 | |
354 | return ret; |
355 | } |
356 | |
357 | static inline u32 test_and_clear_sta_flags(struct sta_info *sta, |
358 | const u32 flags) |
359 | { |
360 | u32 ret; |
361 | unsigned long irqfl; |
362 | |
363 | spin_lock_irqsave(&sta->flaglock, irqfl); |
364 | ret = sta->flags & flags; |
365 | sta->flags &= ~flags; |
366 | spin_unlock_irqrestore(&sta->flaglock, irqfl); |
367 | |
368 | return ret; |
369 | } |
370 | |
371 | static inline u32 get_sta_flags(struct sta_info *sta) |
372 | { |
373 | u32 ret; |
374 | unsigned long irqfl; |
375 | |
376 | spin_lock_irqsave(&sta->flaglock, irqfl); |
377 | ret = sta->flags; |
378 | spin_unlock_irqrestore(&sta->flaglock, irqfl); |
379 | |
380 | return ret; |
381 | } |
382 | |
383 | |
384 | |
385 | #define STA_HASH_SIZE 256 |
386 | #define STA_HASH(sta) (sta[5]) |
387 | |
388 | |
389 | /* Maximum number of frames to buffer per power saving station */ |
390 | #define STA_MAX_TX_BUFFER 128 |
391 | |
392 | /* Minimum buffered frame expiry time. If STA uses listen interval that is |
393 | * smaller than this value, the minimum value here is used instead. */ |
394 | #define STA_TX_BUFFER_EXPIRE (10 * HZ) |
395 | |
396 | /* How often station data is cleaned up (e.g., expiration of buffered frames) |
397 | */ |
398 | #define STA_INFO_CLEANUP_INTERVAL (10 * HZ) |
399 | |
400 | /* |
401 | * Get a STA info, must be under RCU read lock. |
402 | */ |
403 | struct sta_info *sta_info_get(struct ieee80211_sub_if_data *sdata, |
404 | const u8 *addr); |
405 | |
406 | struct sta_info *sta_info_get_bss(struct ieee80211_sub_if_data *sdata, |
407 | const u8 *addr); |
408 | |
409 | static inline |
410 | void for_each_sta_info_type_check(struct ieee80211_local *local, |
411 | const u8 *addr, |
412 | struct sta_info *sta, |
413 | struct sta_info *nxt) |
414 | { |
415 | } |
416 | |
417 | #define for_each_sta_info(local, _addr, sta, nxt) \ |
418 | for ( /* initialise loop */ \ |
419 | sta = rcu_dereference(local->sta_hash[STA_HASH(_addr)]),\ |
420 | nxt = sta ? rcu_dereference(sta->hnext) : NULL; \ |
421 | /* typecheck */ \ |
422 | for_each_sta_info_type_check(local, (_addr), sta, nxt), \ |
423 | /* continue condition */ \ |
424 | sta; \ |
425 | /* advance loop */ \ |
426 | sta = nxt, \ |
427 | nxt = sta ? rcu_dereference(sta->hnext) : NULL \ |
428 | ) \ |
429 | /* compare address and run code only if it matches */ \ |
430 | if (memcmp(sta->sta.addr, (_addr), ETH_ALEN) == 0) |
431 | |
432 | /* |
433 | * Get STA info by index, BROKEN! |
434 | */ |
435 | struct sta_info *sta_info_get_by_idx(struct ieee80211_sub_if_data *sdata, |
436 | int idx); |
437 | /* |
438 | * Create a new STA info, caller owns returned structure |
439 | * until sta_info_insert(). |
440 | */ |
441 | struct sta_info *sta_info_alloc(struct ieee80211_sub_if_data *sdata, |
442 | u8 *addr, gfp_t gfp); |
443 | /* |
444 | * Insert STA info into hash table/list, returns zero or a |
445 | * -EEXIST if (if the same MAC address is already present). |
446 | * |
447 | * Calling the non-rcu version makes the caller relinquish, |
448 | * the _rcu version calls read_lock_rcu() and must be called |
449 | * without it held. |
450 | */ |
451 | int sta_info_insert(struct sta_info *sta); |
452 | int sta_info_insert_rcu(struct sta_info *sta) __acquires(RCU); |
453 | int sta_info_insert_atomic(struct sta_info *sta); |
454 | |
455 | int sta_info_destroy_addr(struct ieee80211_sub_if_data *sdata, |
456 | const u8 *addr); |
457 | int sta_info_destroy_addr_bss(struct ieee80211_sub_if_data *sdata, |
458 | const u8 *addr); |
459 | |
460 | void sta_info_set_tim_bit(struct sta_info *sta); |
461 | void sta_info_clear_tim_bit(struct sta_info *sta); |
462 | |
463 | void sta_info_init(struct ieee80211_local *local); |
464 | int sta_info_start(struct ieee80211_local *local); |
465 | void sta_info_stop(struct ieee80211_local *local); |
466 | int sta_info_flush(struct ieee80211_local *local, |
467 | struct ieee80211_sub_if_data *sdata); |
468 | void ieee80211_sta_expire(struct ieee80211_sub_if_data *sdata, |
469 | unsigned long exp_time); |
470 | |
471 | void ieee80211_sta_ps_deliver_wakeup(struct sta_info *sta); |
472 | void ieee80211_sta_ps_deliver_poll_response(struct sta_info *sta); |
473 | |
474 | #endif /* STA_INFO_H */ |
475 |
Branches:
ben-wpan
ben-wpan-stefan
javiroman/ks7010
jz-2.6.34
jz-2.6.34-rc5
jz-2.6.34-rc6
jz-2.6.34-rc7
jz-2.6.35
jz-2.6.36
jz-2.6.37
jz-2.6.38
jz-2.6.39
jz-3.0
jz-3.1
jz-3.11
jz-3.12
jz-3.13
jz-3.15
jz-3.16
jz-3.18-dt
jz-3.2
jz-3.3
jz-3.4
jz-3.5
jz-3.6
jz-3.6-rc2-pwm
jz-3.9
jz-3.9-clk
jz-3.9-rc8
jz47xx
jz47xx-2.6.38
master
Tags:
od-2011-09-04
od-2011-09-18
v2.6.34-rc5
v2.6.34-rc6
v2.6.34-rc7
v3.9