/* * hostapd / IEEE 802.11ax HE * Copyright (c) 2016-2017, Qualcomm Atheros, Inc. * Copyright (c) 2019 John Crispin * * This software may be distributed under the terms of the BSD license. * See README for more details. */ #include "utils/includes.h" #include "utils/common.h" #include "common/ieee802_11_defs.h" #include "common/ieee802_11_common.h" #include "hostapd.h" #include "ap_config.h" #include "beacon.h" #include "sta_info.h" #include "ieee802_11.h" #include "dfs.h" static u8 ieee80211_he_ppet_size(u8 ppe_thres_hdr, const u8 *phy_cap_info) { u8 sz = 0, ru; if ((phy_cap_info[HE_PHYCAP_PPE_THRESHOLD_PRESENT_IDX] & HE_PHYCAP_PPE_THRESHOLD_PRESENT) == 0) return 0; ru = (ppe_thres_hdr >> HE_PPE_THRES_RU_INDEX_BITMASK_SHIFT) & HE_PPE_THRES_RU_INDEX_BITMASK_MASK; /* Count the number of 1 bits in RU Index Bitmask */ while (ru) { if (ru & 0x1) sz++; ru >>= 1; } /* fixed header of 3 (NSTS) + 4 (RU Index Bitmask) = 7 bits */ /* 6 * (NSTS + 1) bits for bit 1 in RU Index Bitmask */ sz *= 1 + (ppe_thres_hdr & HE_PPE_THRES_NSS_MASK); sz = (sz * 6) + 7; /* PPE Pad to count the number of needed full octets */ sz = (sz + 7) / 8; return sz; } static u8 ieee80211_he_mcs_set_size(const u8 *phy_cap_info) { u8 sz = 4; if (phy_cap_info[HE_PHYCAP_CHANNEL_WIDTH_SET_IDX] & HE_PHYCAP_CHANNEL_WIDTH_SET_80PLUS80MHZ_IN_5G) sz += 4; if (phy_cap_info[HE_PHYCAP_CHANNEL_WIDTH_SET_IDX] & HE_PHYCAP_CHANNEL_WIDTH_SET_160MHZ_IN_5G) sz += 4; return sz; } static int ieee80211_invalid_he_cap_size(const u8 *buf, size_t len) { struct ieee80211_he_capabilities *cap; size_t cap_len; u8 ppe_thres_hdr; cap = (struct ieee80211_he_capabilities *) buf; cap_len = sizeof(*cap) - sizeof(cap->optional); if (len < cap_len) return 1; cap_len += ieee80211_he_mcs_set_size(cap->he_phy_capab_info); if (len < cap_len) return 1; ppe_thres_hdr = len > cap_len ? buf[cap_len] : 0xff; cap_len += ieee80211_he_ppet_size(ppe_thres_hdr, cap->he_phy_capab_info); return len < cap_len; } u8 * hostapd_eid_he_capab(struct hostapd_data *hapd, u8 *eid, enum ieee80211_op_mode opmode) { struct ieee80211_he_capabilities *cap; struct hostapd_hw_modes *mode = hapd->iface->current_mode; u8 he_oper_chwidth = ~HE_PHYCAP_CHANNEL_WIDTH_MASK; u8 *pos = eid; u8 ie_size = 0, mcs_nss_size = 4, ppet_size = 0; if (!mode) return eid; ie_size = sizeof(*cap) - sizeof(cap->optional); ppet_size = ieee80211_he_ppet_size(mode->he_capab[opmode].ppet[0], mode->he_capab[opmode].phy_cap); switch (hapd->iface->conf->he_oper_chwidth) { case CONF_OPER_CHWIDTH_80P80MHZ: he_oper_chwidth |= HE_PHYCAP_CHANNEL_WIDTH_SET_80PLUS80MHZ_IN_5G; mcs_nss_size += 4; /* fall through */ case CONF_OPER_CHWIDTH_160MHZ: he_oper_chwidth |= HE_PHYCAP_CHANNEL_WIDTH_SET_160MHZ_IN_5G; mcs_nss_size += 4; /* fall through */ case CONF_OPER_CHWIDTH_80MHZ: case CONF_OPER_CHWIDTH_USE_HT: he_oper_chwidth |= HE_PHYCAP_CHANNEL_WIDTH_SET_40MHZ_IN_2G | HE_PHYCAP_CHANNEL_WIDTH_SET_40MHZ_80MHZ_IN_5G; break; default: break; } ie_size += mcs_nss_size + ppet_size; *pos++ = WLAN_EID_EXTENSION; *pos++ = 1 + ie_size; *pos++ = WLAN_EID_EXT_HE_CAPABILITIES; cap = (struct ieee80211_he_capabilities *) pos; os_memset(cap, 0, sizeof(*cap)); os_memcpy(cap->he_mac_capab_info, mode->he_capab[opmode].mac_cap, HE_MAX_MAC_CAPAB_SIZE); os_memcpy(cap->he_phy_capab_info, mode->he_capab[opmode].phy_cap, HE_MAX_PHY_CAPAB_SIZE); os_memcpy(cap->optional, mode->he_capab[opmode].mcs, mcs_nss_size); if (ppet_size) os_memcpy(&cap->optional[mcs_nss_size], mode->he_capab[opmode].ppet, ppet_size); if (hapd->iface->conf->he_phy_capab.he_su_beamformer) cap->he_phy_capab_info[HE_PHYCAP_SU_BEAMFORMER_CAPAB_IDX] |= HE_PHYCAP_SU_BEAMFORMER_CAPAB; else cap->he_phy_capab_info[HE_PHYCAP_SU_BEAMFORMER_CAPAB_IDX] &= ~HE_PHYCAP_SU_BEAMFORMER_CAPAB; if (hapd->iface->conf->he_phy_capab.he_su_beamformee) cap->he_phy_capab_info[HE_PHYCAP_SU_BEAMFORMEE_CAPAB_IDX] |= HE_PHYCAP_SU_BEAMFORMEE_CAPAB; else cap->he_phy_capab_info[HE_PHYCAP_SU_BEAMFORMEE_CAPAB_IDX] &= ~HE_PHYCAP_SU_BEAMFORMEE_CAPAB; if (hapd->iface->conf->he_phy_capab.he_mu_beamformer) cap->he_phy_capab_info[HE_PHYCAP_MU_BEAMFORMER_CAPAB_IDX] |= HE_PHYCAP_MU_BEAMFORMER_CAPAB; else cap->he_phy_capab_info[HE_PHYCAP_MU_BEAMFORMER_CAPAB_IDX] &= ~HE_PHYCAP_MU_BEAMFORMER_CAPAB; cap->he_phy_capab_info[HE_PHYCAP_CHANNEL_WIDTH_SET_IDX] &= he_oper_chwidth; pos += ie_size; return pos; } u8 * hostapd_eid_he_operation(struct hostapd_data *hapd, u8 *eid) { struct ieee80211_he_operation *oper; u8 *pos = eid; int oper_size = 6; u32 params = 0; if (!hapd->iface->current_mode) return eid; if (is_6ghz_op_class(hapd->iconf->op_class)) oper_size += 5; *pos++ = WLAN_EID_EXTENSION; *pos++ = 1 + oper_size; *pos++ = WLAN_EID_EXT_HE_OPERATION; oper = (struct ieee80211_he_operation *) pos; os_memset(oper, 0, sizeof(*oper)); if (hapd->iface->conf->he_op.he_default_pe_duration) params |= (hapd->iface->conf->he_op.he_default_pe_duration << HE_OPERATION_DFLT_PE_DURATION_OFFSET); if (hapd->iface->conf->he_op.he_twt_required) params |= HE_OPERATION_TWT_REQUIRED; if (hapd->iface->conf->he_op.he_rts_threshold) params |= (hapd->iface->conf->he_op.he_rts_threshold << HE_OPERATION_RTS_THRESHOLD_OFFSET); if (hapd->iface->conf->he_op.he_er_su_disable) params |= HE_OPERATION_ER_SU_DISABLE; if (hapd->iface->conf->he_op.he_bss_color_disabled || hapd->cca_in_progress) params |= HE_OPERATION_BSS_COLOR_DISABLED; if (hapd->iface->conf->he_op.he_bss_color_partial) params |= HE_OPERATION_BSS_COLOR_PARTIAL; params |= hapd->iface->conf->he_op.he_bss_color << HE_OPERATION_BSS_COLOR_OFFSET; /* HE minimum required basic MCS and NSS for STAs */ oper->he_mcs_nss_set = host_to_le16(hapd->iface->conf->he_op.he_basic_mcs_nss_set); /* TODO: conditional MaxBSSID Indicator subfield */ pos += 6; /* skip the fixed part */ if (is_6ghz_op_class(hapd->iconf->op_class)) { enum oper_chan_width oper_chwidth = hostapd_get_oper_chwidth(hapd->iconf); u8 seg0 = hapd->iconf->he_oper_centr_freq_seg0_idx; u8 seg1 = hostapd_get_oper_centr_freq_seg1_idx(hapd->iconf); u8 control; #ifdef CONFIG_IEEE80211BE if (hapd->iconf->punct_bitmap) { punct_update_legacy_bw(hapd->iconf->punct_bitmap, hapd->iconf->channel, &oper_chwidth, &seg0, &seg1); } #endif /* CONFIG_IEEE80211BE */ if (!seg0) seg0 = hapd->iconf->channel; params |= HE_OPERATION_6GHZ_OPER_INFO; /* 6 GHz Operation Information field * IEEE Std 802.11ax-2021, 9.4.2.249 HE Operation element, * Figure 9-788k */ *pos++ = hapd->iconf->channel; /* Primary Channel */ /* Control: * bits 0-1: Channel Width * bit 2: Duplicate Beacon * bits 3-5: Regulatory Info */ /* Channel Width */ if (seg1) control = 3; else control = center_idx_to_bw_6ghz(seg0); if (hapd->iconf->he_6ghz_reg_pwr_type == 1) control |= HE_6GHZ_STANDARD_POWER_AP << HE_6GHZ_OPER_INFO_CTRL_REG_INFO_SHIFT; else control |= HE_6GHZ_INDOOR_AP << HE_6GHZ_OPER_INFO_CTRL_REG_INFO_SHIFT; *pos++ = control; /* Channel Center Freq Seg0/Seg1 */ if (oper_chwidth == 2) { /* * Seg 0 indicates the channel center frequency index of * the 160 MHz channel. */ seg1 = seg0; if (hapd->iconf->channel < seg0) seg0 -= 8; else seg0 += 8; } *pos++ = seg0; *pos++ = seg1; /* Minimum Rate */ *pos++ = 6; /* TODO: what should be set here? */ } oper->he_oper_params = host_to_le32(params); return pos; } u8 * hostapd_eid_he_mu_edca_parameter_set(struct hostapd_data *hapd, u8 *eid) { struct ieee80211_he_mu_edca_parameter_set *edca; u8 *pos; size_t i; pos = (u8 *) &hapd->iface->conf->he_mu_edca; for (i = 0; i < sizeof(*edca); i++) { if (pos[i]) break; } if (i == sizeof(*edca)) return eid; /* no MU EDCA Parameters configured */ pos = eid; *pos++ = WLAN_EID_EXTENSION; *pos++ = 1 + sizeof(*edca); *pos++ = WLAN_EID_EXT_HE_MU_EDCA_PARAMS; edca = (struct ieee80211_he_mu_edca_parameter_set *) pos; os_memcpy(edca, &hapd->iface->conf->he_mu_edca, sizeof(*edca)); wpa_hexdump(MSG_DEBUG, "HE: MU EDCA Parameter Set element", pos, sizeof(*edca)); pos += sizeof(*edca); return pos; } u8 * hostapd_eid_spatial_reuse(struct hostapd_data *hapd, u8 *eid) { struct ieee80211_spatial_reuse *spr; u8 *pos = eid, *spr_param; u8 sz = 1; if (!hapd->iface->conf->spr.sr_control) return eid; if (hapd->iface->conf->spr.sr_control & SPATIAL_REUSE_NON_SRG_OFFSET_PRESENT) sz++; if (hapd->iface->conf->spr.sr_control & SPATIAL_REUSE_SRG_INFORMATION_PRESENT) sz += 18; *pos++ = WLAN_EID_EXTENSION; *pos++ = 1 + sz; *pos++ = WLAN_EID_EXT_SPATIAL_REUSE; spr = (struct ieee80211_spatial_reuse *) pos; os_memset(spr, 0, sizeof(*spr)); spr->sr_ctrl = hapd->iface->conf->spr.sr_control; pos++; spr_param = spr->params; if (spr->sr_ctrl & SPATIAL_REUSE_NON_SRG_OFFSET_PRESENT) { *spr_param++ = hapd->iface->conf->spr.non_srg_obss_pd_max_offset; pos++; } if (spr->sr_ctrl & SPATIAL_REUSE_SRG_INFORMATION_PRESENT) { *spr_param++ = hapd->iface->conf->spr.srg_obss_pd_min_offset; *spr_param++ = hapd->iface->conf->spr.srg_obss_pd_max_offset; os_memcpy(spr_param, hapd->iface->conf->spr.srg_bss_color_bitmap, 8); spr_param += 8; os_memcpy(spr_param, hapd->iface->conf->spr.srg_partial_bssid_bitmap, 8); pos += 18; } return pos; } u8 * hostapd_eid_he_6ghz_band_cap(struct hostapd_data *hapd, u8 *eid) { struct hostapd_config *conf = hapd->iface->conf; struct hostapd_hw_modes *mode = hapd->iface->current_mode; struct he_capabilities *he_cap; struct ieee80211_he_6ghz_band_cap *cap; u16 capab; u8 *pos; if (!mode || !is_6ghz_op_class(hapd->iconf->op_class) || !is_6ghz_freq(hapd->iface->freq)) return eid; he_cap = &mode->he_capab[IEEE80211_MODE_AP]; capab = he_cap->he_6ghz_capa & HE_6GHZ_BAND_CAP_MIN_MPDU_START; capab |= (conf->he_6ghz_max_ampdu_len_exp << HE_6GHZ_BAND_CAP_MAX_AMPDU_LEN_EXP_SHIFT) & HE_6GHZ_BAND_CAP_MAX_AMPDU_LEN_EXP_MASK; capab |= (conf->he_6ghz_max_mpdu << HE_6GHZ_BAND_CAP_MAX_MPDU_LEN_SHIFT) & HE_6GHZ_BAND_CAP_MAX_MPDU_LEN_MASK; capab |= HE_6GHZ_BAND_CAP_SMPS_DISABLED; if (conf->he_6ghz_rx_ant_pat) capab |= HE_6GHZ_BAND_CAP_RX_ANTPAT_CONS; if (conf->he_6ghz_tx_ant_pat) capab |= HE_6GHZ_BAND_CAP_TX_ANTPAT_CONS; pos = eid; *pos++ = WLAN_EID_EXTENSION; *pos++ = 1 + sizeof(*cap); *pos++ = WLAN_EID_EXT_HE_6GHZ_BAND_CAP; cap = (struct ieee80211_he_6ghz_band_cap *) pos; cap->capab = host_to_le16(capab); pos += sizeof(*cap); return pos; } void hostapd_get_he_capab(struct hostapd_data *hapd, const struct ieee80211_he_capabilities *he_cap, struct ieee80211_he_capabilities *neg_he_cap, size_t he_capab_len) { if (!he_cap) return; if (he_capab_len > sizeof(*neg_he_cap)) he_capab_len = sizeof(*neg_he_cap); /* TODO: mask out unsupported features */ os_memcpy(neg_he_cap, he_cap, he_capab_len); } static int check_valid_he_mcs(struct hostapd_data *hapd, const u8 *sta_he_capab, enum ieee80211_op_mode opmode) { u16 sta_rx_mcs_set, ap_tx_mcs_set; u8 mcs_count = 0; const u16 *ap_mcs_set, *sta_mcs_set; int i; if (!hapd->iface->current_mode) return 1; ap_mcs_set = (u16 *) hapd->iface->current_mode->he_capab[opmode].mcs; sta_mcs_set = (u16 *) ((const struct ieee80211_he_capabilities *) sta_he_capab)->optional; /* * Disable HE capabilities for STAs for which there is not even a single * allowed MCS in any supported number of streams, i.e., STA is * advertising 3 (not supported) as HE MCS rates for all supported * band/stream cases. */ switch (hapd->iface->conf->he_oper_chwidth) { case CONF_OPER_CHWIDTH_80P80MHZ: mcs_count = 3; break; case CONF_OPER_CHWIDTH_160MHZ: mcs_count = 2; break; default: mcs_count = 1; break; } for (i = 0; i < mcs_count; i++) { int j; /* AP Tx MCS map vs. STA Rx MCS map */ sta_rx_mcs_set = WPA_GET_LE16((const u8 *) &sta_mcs_set[i * 2]); ap_tx_mcs_set = WPA_GET_LE16((const u8 *) &ap_mcs_set[(i * 2) + 1]); for (j = 0; j < HE_NSS_MAX_STREAMS; j++) { if (((ap_tx_mcs_set >> (j * 2)) & 0x3) == 3) continue; if (((sta_rx_mcs_set >> (j * 2)) & 0x3) == 3) continue; return 1; } } wpa_printf(MSG_DEBUG, "No matching HE MCS found between AP TX and STA RX"); return 0; } u16 copy_sta_he_capab(struct hostapd_data *hapd, struct sta_info *sta, enum ieee80211_op_mode opmode, const u8 *he_capab, size_t he_capab_len) { if (!he_capab || !(sta->flags & WLAN_STA_WMM) || !hapd->iconf->ieee80211ax || hapd->conf->disable_11ax || !check_valid_he_mcs(hapd, he_capab, opmode) || ieee80211_invalid_he_cap_size(he_capab, he_capab_len) || he_capab_len > sizeof(struct ieee80211_he_capabilities)) { sta->flags &= ~WLAN_STA_HE; os_free(sta->he_capab); sta->he_capab = NULL; return WLAN_STATUS_SUCCESS; } if (!sta->he_capab) { sta->he_capab = os_zalloc(sizeof(struct ieee80211_he_capabilities)); if (!sta->he_capab) return WLAN_STATUS_UNSPECIFIED_FAILURE; } sta->flags |= WLAN_STA_HE; os_memset(sta->he_capab, 0, sizeof(struct ieee80211_he_capabilities)); os_memcpy(sta->he_capab, he_capab, he_capab_len); sta->he_capab_len = he_capab_len; return WLAN_STATUS_SUCCESS; } u16 copy_sta_he_6ghz_capab(struct hostapd_data *hapd, struct sta_info *sta, const u8 *he_6ghz_capab) { if (!he_6ghz_capab || !hapd->iconf->ieee80211ax || hapd->conf->disable_11ax || !is_6ghz_op_class(hapd->iconf->op_class)) { sta->flags &= ~WLAN_STA_6GHZ; os_free(sta->he_6ghz_capab); sta->he_6ghz_capab = NULL; return WLAN_STATUS_SUCCESS; } if (!sta->he_6ghz_capab) { sta->he_6ghz_capab = os_zalloc(sizeof(struct ieee80211_he_6ghz_band_cap)); if (!sta->he_6ghz_capab) return WLAN_STATUS_UNSPECIFIED_FAILURE; } sta->flags |= WLAN_STA_6GHZ; os_memcpy(sta->he_6ghz_capab, he_6ghz_capab, sizeof(struct ieee80211_he_6ghz_band_cap)); return WLAN_STATUS_SUCCESS; } int hostapd_get_he_twt_responder(struct hostapd_data *hapd, enum ieee80211_op_mode mode) { u8 *mac_cap; if (!hapd->iface->current_mode || !hapd->iface->current_mode->he_capab[mode].he_supported || !hapd->iconf->ieee80211ax || hapd->conf->disable_11ax) return 0; mac_cap = hapd->iface->current_mode->he_capab[mode].mac_cap; return !!(mac_cap[HE_MAC_CAPAB_0] & HE_MACCAP_TWT_RESPONDER) && hapd->iface->conf->he_op.he_twt_responder; } u8 * hostapd_eid_cca(struct hostapd_data *hapd, u8 *eid) { if (!hapd->cca_in_progress) return eid; /* BSS Color Change Announcement element */ *eid++ = WLAN_EID_EXTENSION; *eid++ = 3; *eid++ = WLAN_EID_EXT_COLOR_CHANGE_ANNOUNCEMENT; *eid++ = hapd->cca_count; /* Color Switch Countdown */ *eid++ = hapd->cca_color; /* New BSS Color Information */ return eid; }