2 * Off-channel operation helpers
4 * Copyright 2003, Jouni Malinen <jkmaline@cc.hut.fi>
5 * Copyright 2004, Instant802 Networks, Inc.
6 * Copyright 2005, Devicescape Software, Inc.
7 * Copyright 2006-2007 Jiri Benc <jbenc@suse.cz>
8 * Copyright 2007, Michael Wu <flamingice@sourmilk.net>
9 * Copyright 2009 Johannes Berg <johannes@sipsolutions.net>
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License version 2 as
13 * published by the Free Software Foundation.
15 #include <linux/export.h>
16 #include <net/mac80211.h>
17 #include "ieee80211_i.h"
18 #include "driver-ops.h"
21 * Tell our hardware to disable PS.
22 * Optionally inform AP that we will go to sleep so that it will buffer
23 * the frames while we are doing off-channel work. This is optional
24 * because we *may* be doing work on-operating channel, and want our
25 * hardware unconditionally awake, but still let the AP send us normal frames.
27 static void ieee80211_offchannel_ps_enable(struct ieee80211_sub_if_data
*sdata
)
29 struct ieee80211_local
*local
= sdata
->local
;
30 struct ieee80211_if_managed
*ifmgd
= &sdata
->u
.mgd
;
32 local
->offchannel_ps_enabled
= false;
34 /* FIXME: what to do when local->pspolling is true? */
36 del_timer_sync(&local
->dynamic_ps_timer
);
37 del_timer_sync(&ifmgd
->bcn_mon_timer
);
38 del_timer_sync(&ifmgd
->conn_mon_timer
);
40 cancel_work_sync(&local
->dynamic_ps_enable_work
);
42 if (local
->hw
.conf
.flags
& IEEE80211_CONF_PS
) {
43 local
->offchannel_ps_enabled
= true;
44 local
->hw
.conf
.flags
&= ~IEEE80211_CONF_PS
;
45 ieee80211_hw_config(local
, IEEE80211_CONF_CHANGE_PS
);
48 if (!local
->offchannel_ps_enabled
||
49 !ieee80211_hw_check(&local
->hw
, PS_NULLFUNC_STACK
))
51 * If power save was enabled, no need to send a nullfunc
52 * frame because AP knows that we are sleeping. But if the
53 * hardware is creating the nullfunc frame for power save
54 * status (ie. IEEE80211_HW_PS_NULLFUNC_STACK is not
55 * enabled) and power save was enabled, the firmware just
56 * sent a null frame with power save disabled. So we need
57 * to send a new nullfunc frame to inform the AP that we
60 ieee80211_send_nullfunc(local
, sdata
, true);
63 /* inform AP that we are awake again, unless power save is enabled */
64 static void ieee80211_offchannel_ps_disable(struct ieee80211_sub_if_data
*sdata
)
66 struct ieee80211_local
*local
= sdata
->local
;
69 ieee80211_send_nullfunc(local
, sdata
, false);
70 else if (local
->offchannel_ps_enabled
) {
72 * In !IEEE80211_HW_PS_NULLFUNC_STACK case the hardware
73 * will send a nullfunc frame with the powersave bit set
74 * even though the AP already knows that we are sleeping.
75 * This could be avoided by sending a null frame with power
76 * save bit disabled before enabling the power save, but
77 * this doesn't gain anything.
79 * When IEEE80211_HW_PS_NULLFUNC_STACK is enabled, no need
80 * to send a nullfunc frame because AP already knows that
81 * we are sleeping, let's just enable power save mode in
84 /* TODO: Only set hardware if CONF_PS changed?
85 * TODO: Should we set offchannel_ps_enabled to false?
87 local
->hw
.conf
.flags
|= IEEE80211_CONF_PS
;
88 ieee80211_hw_config(local
, IEEE80211_CONF_CHANGE_PS
);
89 } else if (local
->hw
.conf
.dynamic_ps_timeout
> 0) {
91 * If IEEE80211_CONF_PS was not set and the dynamic_ps_timer
92 * had been running before leaving the operating channel,
93 * restart the timer now and send a nullfunc frame to inform
94 * the AP that we are awake.
96 ieee80211_send_nullfunc(local
, sdata
, false);
97 mod_timer(&local
->dynamic_ps_timer
, jiffies
+
98 msecs_to_jiffies(local
->hw
.conf
.dynamic_ps_timeout
));
101 ieee80211_sta_reset_beacon_monitor(sdata
);
102 ieee80211_sta_reset_conn_monitor(sdata
);
105 void ieee80211_offchannel_stop_vifs(struct ieee80211_local
*local
)
107 struct ieee80211_sub_if_data
*sdata
;
109 if (WARN_ON(local
->use_chanctx
))
113 * notify the AP about us leaving the channel and stop all
118 * Stop queues and transmit all frames queued by the driver
119 * before sending nullfunc to enable powersave at the AP.
121 ieee80211_stop_queues_by_reason(&local
->hw
, IEEE80211_MAX_QUEUE_MAP
,
122 IEEE80211_QUEUE_STOP_REASON_OFFCHANNEL
,
124 ieee80211_flush_queues(local
, NULL
, false);
126 mutex_lock(&local
->iflist_mtx
);
127 list_for_each_entry(sdata
, &local
->interfaces
, list
) {
128 if (!ieee80211_sdata_running(sdata
))
131 if (sdata
->vif
.type
== NL80211_IFTYPE_P2P_DEVICE
)
134 if (sdata
->vif
.type
!= NL80211_IFTYPE_MONITOR
)
135 set_bit(SDATA_STATE_OFFCHANNEL
, &sdata
->state
);
137 /* Check to see if we should disable beaconing. */
138 if (sdata
->vif
.bss_conf
.enable_beacon
) {
139 set_bit(SDATA_STATE_OFFCHANNEL_BEACON_STOPPED
,
141 sdata
->vif
.bss_conf
.enable_beacon
= false;
142 ieee80211_bss_info_change_notify(
143 sdata
, BSS_CHANGED_BEACON_ENABLED
);
146 if (sdata
->vif
.type
== NL80211_IFTYPE_STATION
&&
147 sdata
->u
.mgd
.associated
)
148 ieee80211_offchannel_ps_enable(sdata
);
150 mutex_unlock(&local
->iflist_mtx
);
153 void ieee80211_offchannel_return(struct ieee80211_local
*local
)
155 struct ieee80211_sub_if_data
*sdata
;
157 if (WARN_ON(local
->use_chanctx
))
160 mutex_lock(&local
->iflist_mtx
);
161 list_for_each_entry(sdata
, &local
->interfaces
, list
) {
162 if (sdata
->vif
.type
== NL80211_IFTYPE_P2P_DEVICE
)
165 if (sdata
->vif
.type
!= NL80211_IFTYPE_MONITOR
)
166 clear_bit(SDATA_STATE_OFFCHANNEL
, &sdata
->state
);
168 if (!ieee80211_sdata_running(sdata
))
171 /* Tell AP we're back */
172 if (sdata
->vif
.type
== NL80211_IFTYPE_STATION
&&
173 sdata
->u
.mgd
.associated
)
174 ieee80211_offchannel_ps_disable(sdata
);
176 if (test_and_clear_bit(SDATA_STATE_OFFCHANNEL_BEACON_STOPPED
,
178 sdata
->vif
.bss_conf
.enable_beacon
= true;
179 ieee80211_bss_info_change_notify(
180 sdata
, BSS_CHANGED_BEACON_ENABLED
);
183 mutex_unlock(&local
->iflist_mtx
);
185 ieee80211_wake_queues_by_reason(&local
->hw
, IEEE80211_MAX_QUEUE_MAP
,
186 IEEE80211_QUEUE_STOP_REASON_OFFCHANNEL
,
190 void ieee80211_handle_roc_started(struct ieee80211_roc_work
*roc
)
195 if (roc
->mgmt_tx_cookie
) {
196 if (!WARN_ON(!roc
->frame
)) {
197 ieee80211_tx_skb_tid_band(roc
->sdata
, roc
->frame
, 7,
202 cfg80211_ready_on_channel(&roc
->sdata
->wdev
, roc
->cookie
,
203 roc
->chan
, roc
->req_duration
,
207 roc
->notified
= true;
210 static void ieee80211_hw_roc_start(struct work_struct
*work
)
212 struct ieee80211_local
*local
=
213 container_of(work
, struct ieee80211_local
, hw_roc_start
);
214 struct ieee80211_roc_work
*roc
, *dep
, *tmp
;
216 mutex_lock(&local
->mtx
);
218 if (list_empty(&local
->roc_list
))
221 roc
= list_first_entry(&local
->roc_list
, struct ieee80211_roc_work
,
227 roc
->hw_begun
= true;
228 roc
->hw_start_time
= local
->hw_roc_start_time
;
230 ieee80211_handle_roc_started(roc
);
231 list_for_each_entry_safe(dep
, tmp
, &roc
->dependents
, list
) {
232 ieee80211_handle_roc_started(dep
);
234 if (dep
->duration
> roc
->duration
) {
235 u32 dur
= dep
->duration
;
236 dep
->duration
= dur
- roc
->duration
;
238 list_move(&dep
->list
, &roc
->list
);
242 mutex_unlock(&local
->mtx
);
245 void ieee80211_ready_on_channel(struct ieee80211_hw
*hw
)
247 struct ieee80211_local
*local
= hw_to_local(hw
);
249 local
->hw_roc_start_time
= jiffies
;
251 trace_api_ready_on_channel(local
);
253 ieee80211_queue_work(hw
, &local
->hw_roc_start
);
255 EXPORT_SYMBOL_GPL(ieee80211_ready_on_channel
);
257 void ieee80211_start_next_roc(struct ieee80211_local
*local
)
259 struct ieee80211_roc_work
*roc
;
261 lockdep_assert_held(&local
->mtx
);
263 if (list_empty(&local
->roc_list
)) {
264 ieee80211_run_deferred_scan(local
);
268 roc
= list_first_entry(&local
->roc_list
, struct ieee80211_roc_work
,
271 if (WARN_ON_ONCE(roc
->started
))
274 if (local
->ops
->remain_on_channel
) {
275 int ret
, duration
= roc
->duration
;
277 /* XXX: duplicated, see ieee80211_start_roc_work() */
281 ret
= drv_remain_on_channel(local
, roc
->sdata
, roc
->chan
,
282 duration
, roc
->type
);
287 wiphy_warn(local
->hw
.wiphy
,
288 "failed to start next HW ROC (%d)\n", ret
);
290 * queue the work struct again to avoid recursion
291 * when multiple failures occur
293 ieee80211_remain_on_channel_expired(&local
->hw
);
297 ieee80211_queue_delayed_work(&local
->hw
, &roc
->work
,
298 round_jiffies_relative(HZ
/2));
302 void ieee80211_roc_notify_destroy(struct ieee80211_roc_work
*roc
, bool free
)
304 struct ieee80211_roc_work
*dep
, *tmp
;
306 if (WARN_ON(roc
->to_be_freed
))
309 /* was never transmitted */
311 cfg80211_mgmt_tx_status(&roc
->sdata
->wdev
,
312 (unsigned long)roc
->frame
,
313 roc
->frame
->data
, roc
->frame
->len
,
315 kfree_skb(roc
->frame
);
318 if (!roc
->mgmt_tx_cookie
)
319 cfg80211_remain_on_channel_expired(&roc
->sdata
->wdev
,
320 roc
->cookie
, roc
->chan
,
323 list_for_each_entry_safe(dep
, tmp
, &roc
->dependents
, list
)
324 ieee80211_roc_notify_destroy(dep
, true);
329 roc
->to_be_freed
= true;
332 void ieee80211_sw_roc_work(struct work_struct
*work
)
334 struct ieee80211_roc_work
*roc
=
335 container_of(work
, struct ieee80211_roc_work
, work
.work
);
336 struct ieee80211_sub_if_data
*sdata
= roc
->sdata
;
337 struct ieee80211_local
*local
= sdata
->local
;
338 bool started
, on_channel
;
340 mutex_lock(&local
->mtx
);
342 if (roc
->to_be_freed
)
348 if (WARN_ON(list_empty(&local
->roc_list
)))
351 if (WARN_ON(roc
!= list_first_entry(&local
->roc_list
,
352 struct ieee80211_roc_work
,
357 struct ieee80211_roc_work
*dep
;
359 WARN_ON(local
->use_chanctx
);
361 /* If actually operating on the desired channel (with at least
362 * 20 MHz channel width) don't stop all the operations but still
363 * treat it as though the ROC operation started properly, so
364 * other ROC operations won't interfere with this one.
366 roc
->on_channel
= roc
->chan
== local
->_oper_chandef
.chan
&&
367 local
->_oper_chandef
.width
!= NL80211_CHAN_WIDTH_5
&&
368 local
->_oper_chandef
.width
!= NL80211_CHAN_WIDTH_10
;
371 ieee80211_recalc_idle(local
);
373 if (!roc
->on_channel
) {
374 ieee80211_offchannel_stop_vifs(local
);
376 local
->tmp_channel
= roc
->chan
;
377 ieee80211_hw_config(local
, 0);
380 /* tell userspace or send frame */
381 ieee80211_handle_roc_started(roc
);
382 list_for_each_entry(dep
, &roc
->dependents
, list
)
383 ieee80211_handle_roc_started(dep
);
385 /* if it was pure TX, just finish right away */
390 ieee80211_queue_delayed_work(&local
->hw
, &roc
->work
,
391 msecs_to_jiffies(roc
->duration
));
393 /* finish this ROC */
395 list_del(&roc
->list
);
396 started
= roc
->started
;
397 on_channel
= roc
->on_channel
;
398 ieee80211_roc_notify_destroy(roc
, !roc
->abort
);
400 if (started
&& !on_channel
) {
401 ieee80211_flush_queues(local
, NULL
, false);
403 local
->tmp_channel
= NULL
;
404 ieee80211_hw_config(local
, 0);
406 ieee80211_offchannel_return(local
);
409 ieee80211_recalc_idle(local
);
412 ieee80211_start_next_roc(local
);
413 else if (list_empty(&local
->roc_list
))
414 ieee80211_run_deferred_scan(local
);
418 mutex_unlock(&local
->mtx
);
421 static void ieee80211_hw_roc_done(struct work_struct
*work
)
423 struct ieee80211_local
*local
=
424 container_of(work
, struct ieee80211_local
, hw_roc_done
);
425 struct ieee80211_roc_work
*roc
;
427 mutex_lock(&local
->mtx
);
429 if (list_empty(&local
->roc_list
))
432 roc
= list_first_entry(&local
->roc_list
, struct ieee80211_roc_work
,
438 list_del(&roc
->list
);
440 ieee80211_roc_notify_destroy(roc
, true);
442 /* if there's another roc, start it now */
443 ieee80211_start_next_roc(local
);
446 mutex_unlock(&local
->mtx
);
449 void ieee80211_remain_on_channel_expired(struct ieee80211_hw
*hw
)
451 struct ieee80211_local
*local
= hw_to_local(hw
);
453 trace_api_remain_on_channel_expired(local
);
455 ieee80211_queue_work(hw
, &local
->hw_roc_done
);
457 EXPORT_SYMBOL_GPL(ieee80211_remain_on_channel_expired
);
459 void ieee80211_roc_setup(struct ieee80211_local
*local
)
461 INIT_WORK(&local
->hw_roc_start
, ieee80211_hw_roc_start
);
462 INIT_WORK(&local
->hw_roc_done
, ieee80211_hw_roc_done
);
463 INIT_LIST_HEAD(&local
->roc_list
);
466 void ieee80211_roc_purge(struct ieee80211_local
*local
,
467 struct ieee80211_sub_if_data
*sdata
)
469 struct ieee80211_roc_work
*roc
, *tmp
;
472 mutex_lock(&local
->mtx
);
473 list_for_each_entry_safe(roc
, tmp
, &local
->roc_list
, list
) {
474 if (sdata
&& roc
->sdata
!= sdata
)
477 if (roc
->started
&& local
->ops
->remain_on_channel
) {
478 /* can race, so ignore return value */
479 drv_cancel_remain_on_channel(local
);
482 list_move_tail(&roc
->list
, &tmp_list
);
485 mutex_unlock(&local
->mtx
);
487 list_for_each_entry_safe(roc
, tmp
, &tmp_list
, list
) {
488 if (local
->ops
->remain_on_channel
) {
489 list_del(&roc
->list
);
490 ieee80211_roc_notify_destroy(roc
, true);
492 ieee80211_queue_delayed_work(&local
->hw
, &roc
->work
, 0);
494 /* work will clean up etc */
495 flush_delayed_work(&roc
->work
);
496 WARN_ON(!roc
->to_be_freed
);
501 WARN_ON_ONCE(!list_empty(&tmp_list
));