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