1 /* 2 * Copyright (c) 2021-2023 Qualcomm Innovation Center, Inc. All rights reserved. 3 * 4 * Permission to use, copy, modify, and/or distribute this software for any 5 * purpose with or without fee is hereby granted, provided that the above 6 * copyright notice and this permission notice appear in all copies. 7 * 8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 15 */ 16 #ifndef __DP_MLO_H 17 #define __DP_MLO_H 18 19 #include <dp_types.h> 20 #include <dp_peer.h> 21 22 /* Max number of chips that can participate in MLO */ 23 #define DP_MAX_MLO_CHIPS WLAN_MAX_MLO_CHIPS 24 25 /* Max number of peers supported */ 26 #define DP_MAX_MLO_PEER 512 27 28 /* Max number of chips supported */ 29 #define DP_MLO_MAX_DEST_CHIP_ID 4 30 31 /* 32 * NB: intentionally not using kernel-doc comment because the kernel-doc 33 * script does not handle the TAILQ_HEAD macro 34 * struct dp_mlo_ctxt - datapath MLO context 35 * 36 * @ctrl_ctxt: opaque handle of cp mlo mgr 37 * @ml_soc_list: list of socs which are mlo enabled. This also maintains 38 * mlo_chip_id to dp_soc mapping 39 * @ml_soc_cnt: number of SOCs 40 * @ml_soc_list_lock: lock to protect ml_soc_list 41 * @mld_peer_hash: peer hash table for ML peers 42 * Associated peer with this MAC address) 43 * @mld_peer_hash_lock: lock to protect mld_peer_hash 44 * @toeplitz_hash_ipv4: 45 * @toeplitz_hash_ipv6: 46 * @link_to_pdev_map: link to pdev mapping 47 * @rx_fst: pointer to rx_fst handle 48 * @rx_fst_ref_cnt: ref count of rx_fst 49 * @grp_umac_reset_ctx: UMAC reset context at mlo group level 50 * @mlo_dev_list: list of MLO device context 51 * @mlo_dev_list_lock: lock to protect MLO device ctxt 52 */ 53 struct dp_mlo_ctxt { 54 struct cdp_ctrl_mlo_mgr *ctrl_ctxt; 55 struct dp_soc *ml_soc_list[DP_MAX_MLO_CHIPS]; 56 uint8_t ml_soc_cnt; 57 qdf_spinlock_t ml_soc_list_lock; 58 struct { 59 uint32_t mask; 60 uint32_t idx_bits; 61 62 TAILQ_HEAD(, dp_peer) * bins; 63 } mld_peer_hash; 64 65 qdf_spinlock_t mld_peer_hash_lock; 66 uint32_t toeplitz_hash_ipv4[LRO_IPV4_SEED_ARR_SZ]; 67 uint32_t toeplitz_hash_ipv6[LRO_IPV6_SEED_ARR_SZ]; 68 struct dp_pdev_be *link_to_pdev_map[WLAN_MAX_MLO_CHIPS * 69 WLAN_MAX_MLO_LINKS_PER_SOC]; 70 #ifdef DP_UMAC_HW_RESET_SUPPORT 71 struct dp_soc_mlo_umac_reset_ctx grp_umac_reset_ctx; 72 #endif 73 /* MLO device ctxt list */ 74 TAILQ_HEAD(, dp_mlo_dev_ctxt) mlo_dev_list; 75 qdf_spinlock_t mlo_dev_list_lock; 76 }; 77 78 /** 79 * dp_mlo_ctx_to_cdp() - typecast dp mlo context to CDP context 80 * @mlo_ctxt: DP MLO context 81 * 82 * Return: struct cdp_mlo_ctxt pointer 83 */ 84 static inline 85 struct cdp_mlo_ctxt *dp_mlo_ctx_to_cdp(struct dp_mlo_ctxt *mlo_ctxt) 86 { 87 return (struct cdp_mlo_ctxt *)mlo_ctxt; 88 } 89 90 /** 91 * cdp_mlo_ctx_to_dp() - typecast CDP MLO context to DP MLO context 92 * @mlo_ctxt: CDP MLO context 93 * 94 * Return: struct dp_soc pointer 95 */ 96 static inline 97 struct dp_mlo_ctxt *cdp_mlo_ctx_to_dp(struct cdp_mlo_ctxt *mlo_ctxt) 98 { 99 return (struct dp_mlo_ctxt *)mlo_ctxt; 100 } 101 102 /** 103 * dp_soc_mlo_fill_params() - update SOC mlo params 104 * @soc: DP soc 105 * @params: soc attach params 106 * 107 * Return: struct dp_soc pointer 108 */ 109 void dp_soc_mlo_fill_params(struct dp_soc *soc, 110 struct cdp_soc_attach_params *params); 111 112 /** 113 * dp_pdev_mlo_fill_params() - update PDEV mlo params 114 * @pdev: DP PDEV 115 * @params: PDEV attach params 116 * 117 * Return: struct dp_soc pointer 118 */ 119 void dp_pdev_mlo_fill_params(struct dp_pdev *pdev, 120 struct cdp_pdev_attach_params *params); 121 122 /** 123 * dp_mlo_get_soc_ref_by_chip_id() - Get DP soc from DP ML context. 124 * @ml_ctxt: DP ML context handle 125 * @chip_id: MLO chip id 126 * 127 * This API will increment a reference count for DP soc. Caller has 128 * to take care for decrementing refcount. 129 * 130 * Return: dp_soc 131 */ 132 struct dp_soc* 133 dp_mlo_get_soc_ref_by_chip_id(struct dp_mlo_ctxt *ml_ctxt, uint8_t chip_id); 134 135 /** 136 * dp_mlo_get_rx_hash_key() - Get Rx hash key from MLO context 137 * @soc: DP SOC 138 * @lro_hash: Hash params 139 * 140 */ 141 void dp_mlo_get_rx_hash_key(struct dp_soc *soc, 142 struct cdp_lro_hash_config *lro_hash); 143 144 /** 145 * dp_mlo_rx_fst_deref() - decrement rx_fst 146 * @soc: dp soc 147 * 148 * return: soc cnt 149 */ 150 uint8_t dp_mlo_rx_fst_deref(struct dp_soc *soc); 151 152 /** 153 * dp_mlo_rx_fst_ref() - increment ref of rx_fst 154 * @soc: dp soc 155 * 156 */ 157 void dp_mlo_rx_fst_ref(struct dp_soc *soc); 158 159 /** 160 * dp_mlo_get_rx_fst() - Get Rx FST from MLO context 161 * @soc: DP SOC 162 * 163 * Return: struct dp_rx_fst pointer 164 */ 165 struct dp_rx_fst *dp_mlo_get_rx_fst(struct dp_soc *soc); 166 167 /** 168 * dp_mlo_set_rx_fst() - Set Rx FST in MLO context 169 * @soc: DP SOC 170 * @fst: pointer dp_rx_fst 171 * 172 */ 173 void dp_mlo_set_rx_fst(struct dp_soc *soc, struct dp_rx_fst *fst); 174 175 /** 176 * dp_mlo_update_link_to_pdev_map() - map link-id to pdev mapping 177 * @soc: DP SOC 178 * @pdev: DP PDEV 179 * 180 * Return: none 181 */ 182 void dp_mlo_update_link_to_pdev_map(struct dp_soc *soc, struct dp_pdev *pdev); 183 184 /** 185 * dp_mlo_update_link_to_pdev_unmap() - unmap link-id to pdev mapping 186 * @soc: DP SOC 187 * @pdev: DP PDEV 188 * 189 * Return: none 190 */ 191 void dp_mlo_update_link_to_pdev_unmap(struct dp_soc *soc, struct dp_pdev *pdev); 192 193 /** 194 * dp_mlo_get_delta_tsf2_wrt_mlo_offset() - Get delta between mlo timestamp 195 * offset and delta tsf2 196 * @soc: DP SOC 197 * @hw_link_id: link id 198 * 199 * Return: int32_t 200 */ 201 int32_t dp_mlo_get_delta_tsf2_wrt_mlo_offset(struct dp_soc *soc, 202 uint8_t hw_link_id); 203 204 /** 205 * dp_mlo_get_delta_tqm_wrt_mlo_offset() - Get delta between mlo timestamp 206 * offset and delta tqm 207 * @soc: DP SOC 208 * 209 * Return: int32_t 210 */ 211 int32_t dp_mlo_get_delta_tqm_wrt_mlo_offset(struct dp_soc *soc); 212 213 /** 214 * dp_get_interface_stats_be() - get vdev stats for ath interface 215 * @soc_hdl: CDP SoC handle 216 * @vdev_id: vdev Id 217 * @buf: buffer for vdev stats 218 * @is_aggregate: for aggregation 219 * 220 * Return: QDF_STATUS 221 */ 222 QDF_STATUS 223 dp_get_interface_stats_be(struct cdp_soc_t *soc_hdl, uint8_t vdev_id, 224 void *buf, bool is_aggregate); 225 226 /* 227 * dp_mlo_debug_print_ptnr_info() - print partner info 228 * @vdev: DP VDEV 229 * 230 * Return: none 231 */ 232 void dp_mlo_debug_print_ptnr_info(struct dp_vdev *vdev); 233 234 /* 235 * dp_mlo_get_chip_id() - return MLO chip id 236 * @soc: DP soc 237 * 238 * Return: chip_id 239 */ 240 uint8_t dp_mlo_get_chip_id(struct dp_soc *soc); 241 242 /* 243 * dp_mlo_link_peer_hash_find_by_chip_id() - returns mlo link peer on chip_id 244 * peer_hash_table matching vdev_id and mac_address 245 * @soc: partner soc handle in MLO 246 * @peer_mac_addr: peer mac address 247 * @mac_addr_is_aligned: is mac addr aligned 248 * @vdev_id: vdev_id 249 * @chip_id: mlo_chip_id 250 * @mod_id: id of module requesting reference 251 * 252 * return: peer in success 253 * NULL in failure 254 */ 255 struct dp_peer * 256 dp_mlo_link_peer_hash_find_by_chip_id(struct dp_soc *soc, 257 uint8_t *peer_mac_addr, 258 int mac_addr_is_aligned, 259 uint8_t vdev_id, 260 uint8_t chip_id, 261 enum dp_mod_id mod_id); 262 #endif /* __DP_MLO_H */ 263