linux/net/mac80211/offchannel.c
<<
>>
Prefs
   1/*
   2 * Off-channel operation helpers
   3 *
   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>
  10 *
  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.
  14 */
  15#include <net/mac80211.h>
  16#include "ieee80211_i.h"
  17#include "driver-trace.h"
  18
  19/*
  20 * Tell our hardware to disable PS.
  21 * Optionally inform AP that we will go to sleep so that it will buffer
  22 * the frames while we are doing off-channel work.  This is optional
  23 * because we *may* be doing work on-operating channel, and want our
  24 * hardware unconditionally awake, but still let the AP send us normal frames.
  25 */
  26static void ieee80211_offchannel_ps_enable(struct ieee80211_sub_if_data *sdata,
  27                                           bool tell_ap)
  28{
  29        struct ieee80211_local *local = sdata->local;
  30        struct ieee80211_if_managed *ifmgd = &sdata->u.mgd;
  31
  32        local->offchannel_ps_enabled = false;
  33
  34        /* FIXME: what to do when local->pspolling is true? */
  35
  36        del_timer_sync(&local->dynamic_ps_timer);
  37        del_timer_sync(&ifmgd->bcn_mon_timer);
  38        del_timer_sync(&ifmgd->conn_mon_timer);
  39
  40        cancel_work_sync(&local->dynamic_ps_enable_work);
  41
  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);
  46        }
  47
  48        if (tell_ap && (!local->offchannel_ps_enabled ||
  49                        !(local->hw.flags & IEEE80211_HW_PS_NULLFUNC_STACK)))
  50                /*
  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
  58                 * are again sleeping.
  59                 */
  60                ieee80211_send_nullfunc(local, sdata, 1);
  61}
  62
  63/* inform AP that we are awake again, unless power save is enabled */
  64static void ieee80211_offchannel_ps_disable(struct ieee80211_sub_if_data *sdata)
  65{
  66        struct ieee80211_local *local = sdata->local;
  67
  68        if (!local->ps_sdata)
  69                ieee80211_send_nullfunc(local, sdata, 0);
  70        else if (local->offchannel_ps_enabled) {
  71                /*
  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.
  78                 *
  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
  82                 * hardware.
  83                 */
  84                /* TODO:  Only set hardware if CONF_PS changed?
  85                 * TODO:  Should we set offchannel_ps_enabled to false?
  86                 */
  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) {
  90                /*
  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.
  95                 */
  96                ieee80211_send_nullfunc(local, sdata, 0);
  97                mod_timer(&local->dynamic_ps_timer, jiffies +
  98                          msecs_to_jiffies(local->hw.conf.dynamic_ps_timeout));
  99        }
 100
 101        ieee80211_sta_reset_beacon_monitor(sdata);
 102        ieee80211_sta_reset_conn_monitor(sdata);
 103}
 104
 105void ieee80211_offchannel_stop_vifs(struct ieee80211_local *local,
 106                                    bool offchannel_ps_enable)
 107{
 108        struct ieee80211_sub_if_data *sdata;
 109
 110        /*
 111         * notify the AP about us leaving the channel and stop all
 112         * STA interfaces.
 113         */
 114        mutex_lock(&local->iflist_mtx);
 115        list_for_each_entry(sdata, &local->interfaces, list) {
 116                if (!ieee80211_sdata_running(sdata))
 117                        continue;
 118
 119                if (sdata->vif.type != NL80211_IFTYPE_MONITOR)
 120                        set_bit(SDATA_STATE_OFFCHANNEL, &sdata->state);
 121
 122                /* Check to see if we should disable beaconing. */
 123                if (sdata->vif.type == NL80211_IFTYPE_AP ||
 124                    sdata->vif.type == NL80211_IFTYPE_ADHOC ||
 125                    sdata->vif.type == NL80211_IFTYPE_MESH_POINT)
 126                        ieee80211_bss_info_change_notify(
 127                                sdata, BSS_CHANGED_BEACON_ENABLED);
 128
 129                if (sdata->vif.type != NL80211_IFTYPE_MONITOR) {
 130                        netif_tx_stop_all_queues(sdata->dev);
 131                        if (offchannel_ps_enable &&
 132                            (sdata->vif.type == NL80211_IFTYPE_STATION) &&
 133                            sdata->u.mgd.associated)
 134                                ieee80211_offchannel_ps_enable(sdata, true);
 135                }
 136        }
 137        mutex_unlock(&local->iflist_mtx);
 138}
 139
 140void ieee80211_offchannel_enable_all_ps(struct ieee80211_local *local,
 141                                        bool tell_ap)
 142{
 143        struct ieee80211_sub_if_data *sdata;
 144
 145        mutex_lock(&local->iflist_mtx);
 146        list_for_each_entry(sdata, &local->interfaces, list) {
 147                if (!ieee80211_sdata_running(sdata))
 148                        continue;
 149
 150                if (sdata->vif.type == NL80211_IFTYPE_STATION &&
 151                    sdata->u.mgd.associated)
 152                        ieee80211_offchannel_ps_enable(sdata, tell_ap);
 153        }
 154        mutex_unlock(&local->iflist_mtx);
 155}
 156
 157void ieee80211_offchannel_return(struct ieee80211_local *local,
 158                                 bool enable_beaconing,
 159                                 bool offchannel_ps_disable)
 160{
 161        struct ieee80211_sub_if_data *sdata;
 162
 163        mutex_lock(&local->iflist_mtx);
 164        list_for_each_entry(sdata, &local->interfaces, list) {
 165                if (!ieee80211_sdata_running(sdata))
 166                        continue;
 167
 168                /* Tell AP we're back */
 169                if (offchannel_ps_disable &&
 170                    sdata->vif.type == NL80211_IFTYPE_STATION) {
 171                        if (sdata->u.mgd.associated)
 172                                ieee80211_offchannel_ps_disable(sdata);
 173                }
 174
 175                if (sdata->vif.type != NL80211_IFTYPE_MONITOR) {
 176                        clear_bit(SDATA_STATE_OFFCHANNEL, &sdata->state);
 177                        /*
 178                         * This may wake up queues even though the driver
 179                         * currently has them stopped. This is not very
 180                         * likely, since the driver won't have gotten any
 181                         * (or hardly any) new packets while we weren't
 182                         * on the right channel, and even if it happens
 183                         * it will at most lead to queueing up one more
 184                         * packet per queue in mac80211 rather than on
 185                         * the interface qdisc.
 186                         */
 187                        netif_tx_wake_all_queues(sdata->dev);
 188                }
 189
 190                /* Check to see if we should re-enable beaconing */
 191                if (enable_beaconing &&
 192                    (sdata->vif.type == NL80211_IFTYPE_AP ||
 193                     sdata->vif.type == NL80211_IFTYPE_ADHOC ||
 194                     sdata->vif.type == NL80211_IFTYPE_MESH_POINT))
 195                        ieee80211_bss_info_change_notify(
 196                                sdata, BSS_CHANGED_BEACON_ENABLED);
 197        }
 198        mutex_unlock(&local->iflist_mtx);
 199}
 200
 201static void ieee80211_hw_roc_start(struct work_struct *work)
 202{
 203        struct ieee80211_local *local =
 204                container_of(work, struct ieee80211_local, hw_roc_start);
 205        struct ieee80211_sub_if_data *sdata;
 206
 207        mutex_lock(&local->mtx);
 208
 209        if (!local->hw_roc_channel) {
 210                mutex_unlock(&local->mtx);
 211                return;
 212        }
 213
 214        ieee80211_recalc_idle(local);
 215
 216        if (local->hw_roc_skb) {
 217                sdata = IEEE80211_DEV_TO_SUB_IF(local->hw_roc_dev);
 218                ieee80211_tx_skb(sdata, local->hw_roc_skb);
 219                local->hw_roc_skb = NULL;
 220        } else {
 221                cfg80211_ready_on_channel(local->hw_roc_dev,
 222                                          local->hw_roc_cookie,
 223                                          local->hw_roc_channel,
 224                                          local->hw_roc_channel_type,
 225                                          local->hw_roc_duration,
 226                                          GFP_KERNEL);
 227        }
 228
 229        mutex_unlock(&local->mtx);
 230}
 231
 232void ieee80211_ready_on_channel(struct ieee80211_hw *hw)
 233{
 234        struct ieee80211_local *local = hw_to_local(hw);
 235
 236        trace_api_ready_on_channel(local);
 237
 238        ieee80211_queue_work(hw, &local->hw_roc_start);
 239}
 240EXPORT_SYMBOL_GPL(ieee80211_ready_on_channel);
 241
 242static void ieee80211_hw_roc_done(struct work_struct *work)
 243{
 244        struct ieee80211_local *local =
 245                container_of(work, struct ieee80211_local, hw_roc_done);
 246
 247        mutex_lock(&local->mtx);
 248
 249        if (!local->hw_roc_channel) {
 250                mutex_unlock(&local->mtx);
 251                return;
 252        }
 253
 254        if (!local->hw_roc_for_tx)
 255                cfg80211_remain_on_channel_expired(local->hw_roc_dev,
 256                                                   local->hw_roc_cookie,
 257                                                   local->hw_roc_channel,
 258                                                   local->hw_roc_channel_type,
 259                                                   GFP_KERNEL);
 260
 261        local->hw_roc_channel = NULL;
 262        local->hw_roc_cookie = 0;
 263
 264        ieee80211_recalc_idle(local);
 265
 266        mutex_unlock(&local->mtx);
 267}
 268
 269void ieee80211_remain_on_channel_expired(struct ieee80211_hw *hw)
 270{
 271        struct ieee80211_local *local = hw_to_local(hw);
 272
 273        trace_api_remain_on_channel_expired(local);
 274
 275        ieee80211_queue_work(hw, &local->hw_roc_done);
 276}
 277EXPORT_SYMBOL_GPL(ieee80211_remain_on_channel_expired);
 278
 279void ieee80211_hw_roc_setup(struct ieee80211_local *local)
 280{
 281        INIT_WORK(&local->hw_roc_start, ieee80211_hw_roc_start);
 282        INIT_WORK(&local->hw_roc_done, ieee80211_hw_roc_done);
 283}
 284