cfg80211: add support for configuring antenna gain
Subsystems (2)
PATCH 1/2 cfg80211: add support for configuring antenna gain
When using high-gain antennas, transmit power needs to be reduced to stay within legal EIRP limits.
This option only reduces transmit power as much as is necessary to stay within the limit.
--- include/net/cfg80211.h | 2 ++ include/uapi/linux/nl80211.h | 5 +++++ net/wireless/nl80211.c | 17 +++++++++++++++++ 3 files changed, 24 insertions(+)
include/net/cfg80211.h +2 -0
@@ -2061,6 +2061,7 @@ struct cfg80211_update_ft_ies_params {* (as advertised by the nl80211 feature flag.) * @get_tx_power: store the current TX power into the dbm variable; * return 0 if successful +* @set_antenna_gain: set antenna gain to reduce maximum tx power if necessary * * @set_wds_peer: set the WDS peer for a WDS interface *
@@ -2283,6 +2284,7 @@ struct cfg80211_ops { enum nl80211_tx_power_setting type, int mbm);int (*get_tx_power)(struct wiphy *wiphy,struct wireless_dev *wdev,int *dbm); +int (*set_antenna_gain)(struct wiphy *wiphy,int dbi);int (*set_wds_peer)(struct wiphy *wiphy,struct net_device *dev,const u8 *addr);
include/uapi/linux/nl80211.h +5 -0
@@ -1496,6 +1496,9 @@ enum nl80211_commands {* @NL80211_ATTR_RXMGMT_FLAGS: flags for nl80211_send_mgmt(), u32. * As specified in the &enum nl80211_rxmgmt_flags. * +* @NL80211_ATTR_WIPHY_ANTENNA_GAIN: Configured antenna gain. Used to reduce +* transmit power to stay within regulatory limits. u32, dBi. +* * @NL80211_ATTR_MAX: highest attribute number currently defined * @__NL80211_ATTR_AFTER_LAST: internal use */
@@ -1806,6 +1809,8 @@ enum nl80211_attrs {NL80211_ATTR_RXMGMT_FLAGS , +NL80211_ATTR_WIPHY_ANTENNA_GAIN , +/* add attributes here, update the policy in nl80211.c */ __NL80211_ATTR_AFTER_LAST,
net/wireless/nl80211.c +17 -0
@@ -354,6 +354,7 @@ static const struct nla_policy nl80211_policy[NL80211_ATTR_MAX+1] = { [NL80211_ATTR_CSA_IES] = { .type = NLA_NESTED }, [NL80211_ATTR_CSA_C_OFF_BEACON] = { .type = NLA_U16 }, [NL80211_ATTR_CSA_C_OFF_PRESP] = { .type = NLA_U16 }, + [NL80211_ATTR_WIPHY_ANTENNA_GAIN] = { .type = NLA_U32 }, };/* policy for the key attributes */
@@ -2033,6 +2034,22 @@ static int nl80211_set_wiphy(struct sk_buff *skb, struct genl_info *info) goto bad_res; } +if (info->attrs[NL80211_ATTR_WIPHY_ANTENNA_GAIN ]) { +int idx, dbi =0 ; + +if (!rdev->ops->set_antenna_gain) { + result = -EOPNOTSUPP ; + goto bad_res; + } + + idx =NL80211_ATTR_WIPHY_ANTENNA_GAIN ; + dbi =nla_get_u32 (info->attrs[idx]); + + result = rdev->ops->set_antenna_gain (&rdev->wiphy, dbi); +if (result) + goto bad_res; + } +if (info->attrs[NL80211_ATTR_WIPHY_ANTENNA_TX ] && info->attrs[NL80211_ATTR_WIPHY_ANTENNA_RX ]) {u32 tx_ant, rx_ant;
Signature · 1 line
1.8.0.2
PATCH 2/2 mac80211: implement support for configuring antenna gain
Report the maximum allowable extra antenna gain to the driver to allow it to reduce the tx power even further based on internal data
--- include/net/mac80211.h | 2 ++ net/mac80211/cfg.c | 14 ++++++++++++++ net/mac80211/ieee80211_i.h | 1 + net/mac80211/main.c | 18 ++++++++++++++++-- 4 files changed, 33 insertions(+), 2 deletions(-)
include/net/mac80211.h +2 -0
@@ -1019,6 +1019,7 @@ enum ieee80211_smps_mode {* * @power_level: requested transmit power (in dBm), backward compatibility * value only that is set to the minimum of all interfaces +* @max_antenna_gain: maximum antenna gain adjusted by user config (in dBi) * * @chandef: the channel definition to tune to * @radar_enabled: whether radar detection is enabled
@@ -1040,6 +1041,7 @@ struct ieee80211_conf {u32 flags;int power_level, dynamic_ps_timeout;int max_sleep_period; +int max_antenna_gain;u16 listen_interval;u8 ps_dtim_period;
net/mac80211/cfg.c +14 -0
@@ -2284,6 +2284,19 @@ static int ieee80211_get_tx_power(struct wiphy *wiphy,return 0 ; } +static int ieee80211_set_antenna_gain (struct wiphy *wiphy,int dbi) +{ +struct ieee80211_local *local =wiphy_priv (wiphy); + +if (dbi <0 ) +return -EINVAL ; + + local->user_antenna_gain = dbi; +ieee80211_hw_config (local,0 ); + +return 0 ; +} +static int ieee80211_set_wds_peer (struct wiphy *wiphy,struct net_device *dev,const u8 *addr) {
@@ -3658,6 +3671,7 @@ struct cfg80211_ops mac80211_config_ops = { .set_wiphy_params = ieee80211_set_wiphy_params, .set_tx_power = ieee80211_set_tx_power, .get_tx_power = ieee80211_get_tx_power, + .set_antenna_gain = ieee80211_set_antenna_gain, .set_wds_peer = ieee80211_set_wds_peer, .rfkill_poll = ieee80211_rfkill_poll,CFG80211_TESTMODE_CMD (ieee80211_testmode_cmd)
net/mac80211/ieee80211_i.h +1 -0
@@ -1155,6 +1155,7 @@ struct ieee80211_local {int dynamic_ps_forced_timeout;int user_power_level;/* in dBm, for all interfaces */ +int user_antenna_gain;/* in dBi */ enum ieee80211_smps_mode smps_mode;
net/mac80211/main.c +16 -2
@@ -97,7 +97,7 @@ static u32 ieee80211_hw_conf_chan(struct ieee80211_local *local)struct ieee80211_sub_if_data *sdata;struct cfg80211_chan_def chandef = {};u32 changed =0 ; -int power; +int power, ant_gain, max_power;u32 offchannel_flag; offchannel_flag = local->hw.conf.flags &IEEE80211_CONF_OFFCHANNEL ;
@@ -152,8 +152,21 @@ static u32 ieee80211_hw_conf_chan(struct ieee80211_local *local) }rcu_read_unlock (); -if (local->hw.conf.power_level != power) { + max_power = chandef.chan->max_reg_power; + ant_gain = chandef.chan->max_antenna_gain; +if (local->user_antenna_gain >0 ) { +if (local->user_antenna_gain > ant_gain) { + max_power -= local->user_antenna_gain - ant_gain; + ant_gain =0 ; + }else + ant_gain -= local->user_antenna_gain; + power =min (power, max_power); + } + +if (local->hw.conf.power_level != power || + local->hw.conf.max_antenna_gain != ant_gain) { changed |=IEEE80211_CONF_CHANGE_POWER ; + local->hw.conf.max_antenna_gain = ant_gain; local->hw.conf.power_level = power; }
@@ -583,6 +596,7 @@ struct ieee80211_hw *ieee80211_alloc_hw(size_t priv_data_len,IEEE80211_RADIOTAP_MCS_HAVE_BW ; local->hw.radiotap_vht_details =IEEE80211_RADIOTAP_VHT_KNOWN_GI |IEEE80211_RADIOTAP_VHT_KNOWN_BANDWIDTH ; + local->user_antenna_gain =0 ; local->hw.uapsd_queues =IEEE80211_DEFAULT_UAPSD_QUEUES ; local->hw.uapsd_max_sp_len =IEEE80211_DEFAULT_MAX_SP_LEN ; local->user_power_level =IEEE80211_UNSET_POWER_LEVEL ;
Signature · 1 line
1.8.0.2
Johannes Berg
maintainerRe: [PATCH 2/2] mac80211: implement support for configuring antenna gain
Quoted 2 lines · Felix Fietkau
Report the maximum allowable extra antenna gain to the driver to allow it to reduce the tx power even further based on internal data
I don't quite understand the maximum thing here - what's a user to do who has an antenna that goes over? Is that then intended to not be supported? That seems odd. A very high gain antenna might just result in signal distortions, but what's the reason for limiting it this way?
johannes
Re: [PATCH 2/2] mac80211: implement support for configuring antenna gain
Quoted 8 lines · Johannes Berg
Quoted 2 lines · Felix Fietkau
Report the maximum allowable extra antenna gain to the driver to allow it to reduce the tx power even further based on internal data
I don't quite understand the maximum thing here - what's a user to do who has an antenna that goes over? Is that then intended to not be supported? That seems odd. A very high gain antenna might just result in signal distortions, but what's the reason for limiting it this way?
Very high gain antennas are useful for long distance links. The signal is not distorted, but focused directionally, which can easily make it exceed regulatory EIRP limits, unless tx power is reduced appropriately.
If the user explicitly configures the gain of the directional antenna using this patch, mac80211 will reduce the maximum allowed tx power setting to stay within the legal limit.
- Felix
Johannes Berg
maintainerRe: [PATCH 2/2] mac80211: implement support for configuring antenna gain
Quoted 5 lines · Felix Fietkau
Quoted 4 lines · Johannes Berg
Quoted 2 lines · Felix Fietkau
Report the maximum allowable extra antenna gain to the driver to allow it to reduce the tx power even further based on internal data
Quoted 8 lines
Quoted 4 lines
I don't quite understand the maximum thing here - what's a user to do who has an antenna that goes over? Is that then intended to not be supported? That seems odd. A very high gain antenna might just result in signal distortions, but what's the reason for limiting it this way?
Very high gain antennas are useful for long distance links. The signal is not distorted, but focused directionally, which can easily make it exceed regulatory EIRP limits, unless tx power is reduced appropriately.
Sure.
Quoted 3 lines
If the user explicitly configures the gain of the directional antenna using this patch, mac80211 will reduce the maximum allowed tx power setting to stay within the legal limit.
I understand. I don't understand the pieces about "max_antenna_gain".
johannes
Re: [PATCH 2/2] mac80211: implement support for configuring antenna gain
Quoted 15 lines · Johannes Berg
Quoted 5 lines · Felix Fietkau
Quoted 4 lines · Johannes Berg
Quoted 2 lines · Felix Fietkau
Report the maximum allowable extra antenna gain to the driver to allow it to reduce the tx power even further based on internal data
Quoted 8 lines
Quoted 4 lines
I don't quite understand the maximum thing here - what's a user to do who has an antenna that goes over? Is that then intended to not be supported? That seems odd. A very high gain antenna might just result in signal distortions, but what's the reason for limiting it this way?
Very high gain antennas are useful for long distance links. The signal is not distorted, but focused directionally, which can easily make it exceed regulatory EIRP limits, unless tx power is reduced appropriately.
Quoted 7 lines
Sure.
Quoted 3 lines
If the user explicitly configures the gain of the directional antenna using this patch, mac80211 will reduce the maximum allowed tx power setting to stay within the legal limit.
I understand. I don't understand the pieces about "
max_antenna_gain".
Right now ath9k has an antenna gain value in the EEPROM, and it compares it against the channel max_antenna_gain value.
Let's assume we have configured the tx power to the maximum value, the regdb allows 3 dB antenna gain, and the ath9k EEPROM contains an antenna gain of 3 dB as well.
If we now add another 3 dB of user-configured antenna gain, it first starts tapping into the regulatory-allowed antenna gain before reducing tx power in mac80211. The driver needs to know about this, so I put the calculated maximum antenna gain into the hw conf as well.
- Felix
Johannes Berg
maintainerRe: [PATCH 2/2] mac80211: implement support for configuring antenna gain
Quoted 4 lines · Felix Fietkau
Quoted 1 line
I understand. I don't understand the pieces about "
max_antenna_gain".Right now ath9k has an antenna gain value in the EEPROM, and it compares it against the channel
max_antenna_gainvalue.
I just don't understand what the max means. If I connect a 5dBi gain antenna, but the "max antenna gain" is 3dBi, what should happen?
Quoted 7 lines
Let's assume we have configured the tx power to the maximum value, the regdb allows 3 dB antenna gain, and the ath9k EEPROM contains an antenna gain of 3 dB as well.
If we now add another 3 dB of user-configured antenna gain, it first starts tapping into the regulatory-allowed antenna gain before reducing tx power in mac80211. The driver needs to know about this, so I put the calculated maximum antenna gain into the hw conf as well.
I don't think it really works this way, does it? I don't believe the "regulatory-allowed antenna gain" is really something that's allowed on top of the EIRP?
johannes
Johannes Berg
maintainerRe: [PATCH 2/2] mac80211: implement support for configuring antenna gain
+ wireless-regdb
Quoted 29 lines · Johannes Berg
Quoted 4 lines · Felix Fietkau
Quoted 1 line
I understand. I don't understand the pieces about "
max_antenna_gain".Right now ath9k has an antenna gain value in the EEPROM, and it compares it against the channel
max_antenna_gainvalue.I just don't understand what the max means. If I connect a 5dBi gain antenna, but the "max antenna gain" is 3dBi, what should happen?
Quoted 7 lines
Let's assume we have configured the tx power to the maximum value, the regdb allows 3 dB antenna gain, and the ath9k EEPROM contains an antenna gain of 3 dB as well.
If we now add another 3 dB of user-configured antenna gain, it first starts tapping into the regulatory-allowed antenna gain before reducing tx power in mac80211. The driver needs to know about this, so I put the calculated maximum antenna gain into the hw conf as well.I don't think it really works this way, does it? I don't believe the "regulatory-allowed antenna gain" is really something that's allowed on top of the EIRP?
johannes
--
To unsubscribe from this list: send the line "unsubscribe linux-wireless" in the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html