mac80211: calculate maximum sleep interval
Johannes Berg
maintainerPATCH 1/1 mac80211: calculate maximum sleep interval
The maximum sleep interval, for powersave purposes, is determined by the DTIM period (it may not be larger) and the required networking latency (it must be small enough to fulfil those constraints).
This makes mac80211 calculate the maximum sleep interval based on those constraints, and pass it to the driver. Then the driver should instruct the device to sleep at most that long.
Note that the device is responsible for aligning the maximum sleep interval between DTIMs, we make sure it's not longer but it needs to make sure it's between them.
Also, group some powersave documentation together and make it more explicit that we support managed mode only, and no IBSS powersaving (yet).
--- include/net/mac80211.h | 19 ++++++++++++++++--- net/mac80211/mlme.c | 20 ++++++++++++++++---- 2 files changed, 32 insertions(+), 7 deletions(-)
include/net/mac80211.h +16 -3
@@ -517,7 +517,7 @@ struct ieee80211_rx_status {* Flags to define PHY configuration options * * @IEEE80211_CONF_RADIOTAP: add radiotap header at receive time (if supported) -* @IEEE80211_CONF_PS: Enable 802.11 power save mode +* @IEEE80211_CONF_PS: Enable 802.11 power save mode (managed mode only) */ enum ieee80211_conf_flags {IEEE80211_CONF_RADIOTAP = (1 <<0 ),
@@ -553,14 +553,26 @@ enum ieee80211_conf_changed {* * This struct indicates how the driver shall configure the hardware. * +* @flags: configuration flags defined above +* * @radio_enabled: when zero, driver is required to switch off the radio. * @beacon_int: beacon interval (TODO make interface config) +* * @listen_interval: listen interval in units of beacon interval -* @flags: configuration flags defined above +* @max_sleep_interval: the maximum number of beacon intervals to sleep for +* before checking the beacon for a TIM bit (managed mode only); this +* value will be only achievable between DTIM frames, the hardware +* needs to check for the multicast traffic bit in DTIM beacons. +* This variable is valid only when the CONF_PS flag is set. +* @dynamic_ps_timeout: The dynamic powersave timeout (in ms), see the +* powersave documentation below. This variable is valid only when +* the CONF_PS flag is set. +* * @power_level: requested transmit power (in dBm) -* @dynamic_ps_timeout: dynamic powersave timeout (in ms) +* * @channel: the channel to tune to * @channel_type: the channel (HT) type +* * @long_frame_max_tx_count: Maximum number of transmissions for a "long" frame * (a frame not RTS protected), called "dot11LongRetryLimit" in 802.11, * but actually means the number of transmissions not the number of retries
@@ -572,6 +584,7 @@ struct ieee80211_conf {int beacon_int;u32 flags;int power_level, dynamic_ps_timeout; +int max_sleep_interval;u16 listen_interval;bool radio_enabled;
net/mac80211/mlme.c +16 -4
@@ -545,10 +545,19 @@ void ieee80211_recalc_ps(struct ieee8021 beaconint_us =ieee80211_tu_to_usec ( found->vif.bss_conf.beacon_int); -if (beaconint_us > latency) +if (beaconint_us > latency) { local->ps_sdata =NULL ; -else + }else { +u8 dtimper = found->vif.bss_conf.dtim_period; +int maxslp =1 ; + +if (dtimper >1 ) + maxslp =min_t (int, dtimper, + latency / beaconint_us); + + local->hw.conf.max_sleep_interval = maxslp; local->ps_sdata = found; + } }else { local->ps_sdata =NULL ; }
@@ -851,8 +860,11 @@ static void ieee80211_set_associated(strieee80211_bss_info_change_notify (sdata, bss_info_changed);/* will be same as sdata */ -if (local->ps_sdata) -ieee80211_enable_ps (local, sdata); +if (local->ps_sdata) { +mutex_lock (&local->iflist_mtx); +ieee80211_recalc_ps (local,-1 ); +mutex_unlock (&local->iflist_mtx); + }netif_tx_start_all_queues (sdata->dev);netif_carrier_on (sdata->dev);
Quoted 9 lines · Johannes Berg
The maximum sleep interval, for powersave purposes, is determined by the DTIM period (it may not be larger) and the required networking latency (it must be small enough to fulfil those constraints).
This makes mac80211 calculate the maximum sleep interval based on those constraints, and pass it to the driver. Then the driver should instruct the device to sleep at most that long.
I like this, just one comment:
Quoted 5 lines
+ * @max_sleep_interval: the maximum number of beacon intervals to sleep for
+ * before checking the beacon for a TIM bit (managed mode only); this
+ * value will be only achievable between DTIM frames, the hardware
+ * needs to check for the multicast traffic bit in DTIM beacons.
+ * This variable is valid only when theCONF_PSflag is set.
I would prefer to call it max_sleep_period. Or maybe even wakeup period, because it's about waking up here.
For me interval, for example beacon interval, means that the unit is TU. But this might be just me.
Signature · 1 line
Kalle Valo
Johannes Berg
maintainerQuoted 11 lines · Kalle Valo
Quoted 5 lines
+ * @max_sleep_interval: the maximum number of beacon intervals to sleep for
+ * before checking the beacon for a TIM bit (managed mode only); this
+ * value will be only achievable between DTIM frames, the hardware
+ * needs to check for the multicast traffic bit in DTIM beacons.
+ * This variable is valid only when theCONF_PSflag is set.I would prefer to call it
max_sleep_period. Or maybe even wakeup period, because it's about waking up here.For me interval, for example beacon interval, means that the unit is TU. But this might be just me.
Good argument. I'll post a follow-up patch to rename it (to make it easier).
johannes
Quoted 8 lines · Johannes Berg
Quoted 6 lines · Kalle Valo
Quoted 5 lines
+ * @max_sleep_interval: the maximum number of beacon intervals to sleep for
+ * before checking the beacon for a TIM bit (managed mode only); this
+ * value will be only achievable between DTIM frames, the hardware
+ * needs to check for the multicast traffic bit in DTIM beacons.
+ * This variable is valid only when theCONF_PSflag is set.
Quoted 8 lines
Quoted 5 lines
I would prefer to call it
max_sleep_period. Or maybe even wakeup period, because it's about waking up here.For me interval, for example beacon interval, means that the unit is TU. But this might be just me.
Good argument. I'll post a follow-up patch to rename it (to make it easier).
Thanks.
Signature · 1 line
Kalle Valo
Quoted 14 lines · Johannes Berg
The maximum sleep interval, for powersave purposes, is determined by the DTIM period (it may not be larger) and the required networking latency (it must be small enough to fulfil those constraints).
This makes mac80211 calculate the maximum sleep interval based on those constraints, and pass it to the driver. Then the driver should instruct the device to sleep at most that long.
Note that the device is responsible for aligning the maximum sleep interval between DTIMs, we make sure it's not longer but it needs to make sure it's between them.
Quoted 5 lines
Also, group some powersave documentation together and make it more explicit that we support managed mode only, and no IBSS powersaving (yet).
Signed-off-by Johannes Berg <[email protected]>
Signature · 1 line
Kalle Valo