/****************************************************************************** * * Copyright(c) 2019 - 2021 Realtek Corporation. * * This program is free software; you can redistribute it and/or modify it * under the terms of version 2 of the GNU General Public License as * published by the Free Software Foundation. * * This program is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for * more details. * *****************************************************************************/ #ifndef __RTW_CSA_H_ #define __RTW_CSA_H_ #if CONFIG_DFS #define CSA_IE_LEN 3 /* Length of Channel Switch Announcement element */ #define ECSA_IE_LEN 4 /* Length of Extended Channel Switch Announcement element */ #define CSA_SWITCH_MODE 0 #define CSA_NEW_CH 1 #define CSA_SWITCH_COUNT 2 #define MAX_CSA_CNT 10 #define WAIT_BCN_TIMES 5 #define CS_WR_DATA_LEN 5 /* Length of Channel Switch Wrapper element */ #ifdef CONFIG_ECSA_PHL #define MCC_ECSA_DELAY_START_TIME 3000 /* ms */ enum ecsa_state_t { ECSA_ST_NONE, ECSA_ST_SW_START, /* ready to switch */ ECSA_ST_SW_DONE /* switch done */ }; enum csa_trigger_type { /* AP mode trigger channel switch via driver core layer */ CSA_AP_CORE_SWITCH_CH, /* AP mode trigger channel switch via chan_switch command from hostapd or wpa_supplicant */ CSA_AP_CFG80211_SWITCH_CH, /* STA mode receive CSA/ECSA IE from associating AP */ CSA_STA_RX_CSA_IE, /* STA mode disconnect with DFS AP and DFS region not supported, so switching AP mode to non-DFS channel */ CSA_STA_DISCONNECT_ON_DFS }; enum ecsa_mr_case { ECSA_SINGLE_ROLE, ECSA_MR_SCC_STA_AP, ECSA_MR_UNSUPPORTED }; enum core_layer_ecsa_type{ ECSA_CORE_TYPE_NONE = 0, ECSA_CORE_TYPE_AP = 1, ECSA_CORE_TYPE_STA = 2, ECSA_CORE_TYPE_SCC_STA_AP = 3 /* Concurrent: one STA mode and one AP mode*/ }; struct core_ecsa_info { enum ecsa_state_t state; enum core_layer_ecsa_type core_ecsa_type; enum phl_ecsa_start_reason ecsa_allow_case; u32 ecsa_delay_time; /* @channel_width defined in 802.11-2016, Table 9-252 VHT operation information subfields * The format of the Wide Bandwidth Channel Switch subelement is the same as the * Wide Bandwidth Channel Switch element (see 9.4.2.161) except for the following: * A value 0 in the New Channel Width field signifies only a 40 MHz BSS bandwidth * 0 for 40 MHz * 1 for 80 MHz, 160 MHz or 80+80 MHz * 2 for 160 MHz (deprecated) * 3 for non-contiguous 80+80 MHz (deprecated) * 255 for initial value, defined by driver */ u8 channel_width; struct createbss_parm *bss_param; struct rtw_phl_ecsa_param phl_ecsa_param; struct _ADAPTER *trigger_iface; /* interface which trigger core layer ECSA flow */ struct _ADAPTER *execute_iface; /* interface which actually execute PHL ECSA FG */ }; __inline static void set_ecsa_state(struct core_ecsa_info *ecsa_info, enum ecsa_state_t state) { ecsa_info->state = state; } __inline static bool check_ecsa_state(struct core_ecsa_info *ecsa_info, enum ecsa_state_t state) { if (ecsa_info->state == state) return _TRUE; return _FALSE; } #define SET_ECSA_STATE(adapter, state) set_ecsa_state(&((adapter)->ecsa_info), (state)) #define CHK_ECSA_STATE(adapter, state) check_ecsa_state(&((adapter)->ecsa_info), (state)) void reset_ecsa_param(struct _ADAPTER *a); bool rtw_is_ecsa_enabled(struct _ADAPTER *a); bool rtw_mr_is_ecsa_running(struct _ADAPTER *a); bool rtw_hal_is_csa_support(struct _ADAPTER *a); void rtw_ecsa_update_sta_mlme(struct _ADAPTER_LINK *alink, u8 *pframe, u32 packet_len); void rtw_build_css_ie(struct _ADAPTER *a, struct rtw_phl_ecsa_param *ecsa_param); void rtw_build_sec_offset_ie(struct _ADAPTER *a, u8 seconday_offset); void rtw_build_wide_bw_cs_ie(struct _ADAPTER *a, struct rtw_chan_def new_chandef); void rtw_cfg80211_build_csa_beacon( struct _ADAPTER *a, struct cfg80211_csa_settings *params, struct rtw_chan_def csa_chdef ); void rtw_ecsa_update_probe_resp(struct xmit_frame *xframe); void rtw_ecsa_update_beacon(void *priv, struct rtw_wifi_role_t *role, struct rtw_wifi_role_link_t *rlink); bool rtw_ap_check_ecsa_allow( void *priv, struct rtw_wifi_role_t *role, struct rtw_chan_def chan_def, enum phl_ecsa_start_reason reason, #ifdef CONFIG_PHL_ECSA_EXTEND_OPTION u32 *extend_option, #endif u32 *delay_start_ms ); void rtw_ecsa_mr_update_chan_info_by_role( void *priv, struct rtw_wifi_role_t *role, struct rtw_wifi_role_link_t *rlink, struct rtw_chan_def new_chan_def ); bool rtw_ecsa_check_tx_resume_allow(void *priv, struct rtw_wifi_role_t *role); void rtw_ecsa_complete(void *priv, struct rtw_wifi_role_t *role); bool rtw_trigger_phl_ecsa_start(struct _ADAPTER *trigger_iface, enum csa_trigger_type trigger_type); bool rtw_hal_trigger_csa_start(struct _ADAPTER *a, enum csa_trigger_type trigger_type, u8 csa_mode, u8 ecsa_op_class, u8 csa_switch_cnt, u8 csa_band, u8 csa_ch, u8 csa_bw, u8 csa_offset, u8 csa_ch_width, u8 csa_ch_freq_seg0, u8 csa_ch_freq_seg1); bool rtw_hal_dfs_trigger_csa(struct _ADAPTER *a, enum csa_trigger_type trigger_type, u8 band_idx, u8 u_ch, u8 u_bw, u8 u_offset); #endif /* CONFIG_ECSA_PHL */ #endif /* CONFIG_DFS */ #endif