xref: /wlan-dirver/qca-wifi-host-cmn/umac/regulatory/dispatcher/inc/wlan_reg_services_api.h (revision 45c28558a520fd0e975b20c0ad534a0aa7f08021)
1 /*
2  * Copyright (c) 2017-2021 The Linux Foundation. All rights reserved.
3  * Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. All rights reserved.
4  *
5  * Permission to use, copy, modify, and/or distribute this software for
6  * any purpose with or without fee is hereby granted, provided that the
7  * above copyright notice and this permission notice appear in all
8  * copies.
9  *
10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17  * PERFORMANCE OF THIS SOFTWARE.
18  */
19 
20 /**
21  * DOC: wlan_reg_services_api.h
22  * This file provides prototypes of the routines needed for the
23  * external components to utilize the services provided by the
24  * regulatory component.
25  */
26 
27 #ifndef __WLAN_REG_SERVICES_API_H
28 #define __WLAN_REG_SERVICES_API_H
29 
30 #include <reg_services_public_struct.h>
31 
32 /**
33  * wlan_reg_max_5ghz_ch_num() - Get maximum 5GHz channel number
34  *
35  * Return: Maximum 5GHz channel number
36  */
37 #define WLAN_REG_MAX_5GHZ_CH_NUM wlan_reg_max_5ghz_ch_num()
38 uint8_t wlan_reg_max_5ghz_ch_num(void);
39 
40 #ifdef CONFIG_CHAN_FREQ_API
41 /**
42  * wlan_reg_min_24ghz_chan_freq() - Get minimum 2.4GHz channel frequency
43  *
44  * Return: Minimum 2.4GHz channel frequency
45  */
46 #define WLAN_REG_MIN_24GHZ_CHAN_FREQ wlan_reg_min_24ghz_chan_freq()
47 qdf_freq_t wlan_reg_min_24ghz_chan_freq(void);
48 
49 /**
50  * wlan_reg_max_24ghz_chan_freq() - Get maximum 2.4GHz channel frequency
51  *
52  * Return: Maximum 2.4GHz channel frequency
53  */
54 #define WLAN_REG_MAX_24GHZ_CHAN_FREQ wlan_reg_max_24ghz_chan_freq()
55 qdf_freq_t wlan_reg_max_24ghz_chan_freq(void);
56 
57 /**
58  * wlan_reg_min_5ghz_chan_freq() - Get minimum 5GHz channel frequency
59  *
60  * Return: Minimum 5GHz channel frequency
61  */
62 #define WLAN_REG_MIN_5GHZ_CHAN_FREQ wlan_reg_min_5ghz_chan_freq()
63 qdf_freq_t wlan_reg_min_5ghz_chan_freq(void);
64 
65 /**
66  * wlan_reg_max_5ghz_chan_freq() - Get maximum 5GHz channel frequency
67  *
68  * Return: Maximum 5GHz channel frequency
69  */
70 #define WLAN_REG_MAX_5GHZ_CHAN_FREQ wlan_reg_max_5ghz_chan_freq()
71 qdf_freq_t wlan_reg_max_5ghz_chan_freq(void);
72 #endif /* CONFIG_CHAN_FREQ_API */
73 
74 /**
75  * wlan_reg_is_24ghz_ch_freq() - Check if the given channel frequency is 2.4GHz
76  * @freq: Channel frequency
77  *
78  * Return: true if channel frequency is 2.4GHz, else false
79  */
80 #define WLAN_REG_IS_24GHZ_CH_FREQ(freq) wlan_reg_is_24ghz_ch_freq(freq)
81 bool wlan_reg_is_24ghz_ch_freq(qdf_freq_t freq);
82 
83 /**
84  * wlan_reg_is_5ghz_ch_freq() - Check if the given channel frequency is 5GHz
85  * @freq: Channel frequency
86  *
87  * Return: true if channel frequency is 5GHz, else false
88  */
89 #define WLAN_REG_IS_5GHZ_CH_FREQ(freq) wlan_reg_is_5ghz_ch_freq(freq)
90 bool wlan_reg_is_5ghz_ch_freq(qdf_freq_t freq);
91 
92 /**
93  * wlan_reg_is_range_overlap_2g() - Check if the given low_freq and high_freq
94  * is in the 2G range.
95  *
96  * @low_freq - Low frequency.
97  * @high_freq - High frequency.
98  *
99  * Return: Return true if given low_freq and high_freq overlaps 2G range,
100  * else false.
101  */
102 bool wlan_reg_is_range_overlap_2g(qdf_freq_t low_freq, qdf_freq_t high_freq);
103 
104 /**
105  * wlan_reg_is_range_overlap_5g() - Check if the given low_freq and high_freq
106  * is in the 5G range.
107  *
108  * @low_freq - Low frequency.
109  * @high_freq - High frequency.
110  *
111  * Return: Return true if given low_freq and high_freq overlaps 5G range,
112  * else false.
113  */
114 bool wlan_reg_is_range_overlap_5g(qdf_freq_t low_freq, qdf_freq_t high_freq);
115 
116 /**
117  * wlan_reg_is_freq_indoor() - Check if a frequency is indoor.
118  * @pdev: Pointer to pdev.
119  * @freq: Channel frequency.
120  *
121  * Return: Return true if a frequency is indoor, else false.
122  */
123 bool wlan_reg_is_freq_indoor(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq);
124 
125 /**
126  * wlan_reg_get_min_chwidth() - Return min chanwidth supported by freq.
127  * @pdev: Pointer to pdev.
128  * @freq: Channel frequency.
129  *
130  * Return: Min chwidth supported by freq as per regulatory DB.
131  */
132 uint16_t wlan_reg_get_min_chwidth(struct wlan_objmgr_pdev *pdev,
133 				  qdf_freq_t freq);
134 
135 /**
136  * wlan_reg_get_max_chwidth() - Return max chanwidth supported by freq.
137  * @pdev: Pointer to pdev.
138  * @freq: Channel frequency.
139  *
140  * Return: Max chwidth supported by freq as per regulatory DB.
141  */
142 uint16_t wlan_reg_get_max_chwidth(struct wlan_objmgr_pdev *pdev,
143 				  qdf_freq_t freq);
144 
145 /**
146  * wlan_reg_get_next_lower_bandwidth() - Get next lower bandwdith
147  * @ch_width: channel bandwdith
148  *
149  * Return: Return next lower bandwidth of input channel bandwidth
150  */
151 enum phy_ch_width
152 wlan_reg_get_next_lower_bandwidth(enum phy_ch_width ch_width);
153 
154 #ifdef CONFIG_REG_CLIENT
155 /**
156  * wlan_reg_is_freq_indoor_in_secondary_list() - Check if the input frequency is
157  * an indoor frequency in the secondary list
158  * @pdev: Pointer to pdev.
159  * @freq: Channel frequency.
160  *
161  * Return: Return true if a frequency is indoor, else false.
162  */
163 bool wlan_reg_is_freq_indoor_in_secondary_list(struct wlan_objmgr_pdev *pdev,
164 					       qdf_freq_t freq);
165 #endif
166 
167 #ifdef CONFIG_BAND_6GHZ
168 /**
169  * wlan_reg_is_6ghz_chan_freq() - Check if the given channel frequency is 6GHz
170  * @freq: Channel frequency
171  *
172  * Return: true if channel frequency is 6GHz, else false
173  */
174 #define WLAN_REG_IS_6GHZ_CHAN_FREQ(freq) wlan_reg_is_6ghz_chan_freq(freq)
175 bool wlan_reg_is_6ghz_chan_freq(uint16_t freq);
176 
177 #ifdef CONFIG_6G_FREQ_OVERLAP
178 /**
179  * wlan_reg_is_range_only6g() - Check if the given low_freq and high_freq
180  * is in the 6G range.
181  * @low_freq - Low frequency.
182  * @high_freq - High frequency.
183  *
184  * Return: Return true if given low_freq and high_freq overlaps 6G range,
185  * else false.
186  */
187 bool wlan_reg_is_range_only6g(qdf_freq_t low_freq, qdf_freq_t high_freq);
188 
189 /**
190  * wlan_reg_is_range_overlap_6g() - Check if the given low_freq and high_freq
191  * is in the 6G range.
192  *
193  * @low_freq - Low frequency.
194  * @high_freq - High frequency.
195  *
196  * Return: Return true if given low_freq and high_freq overlaps 6G range,
197  * else false.
198  */
199 bool wlan_reg_is_range_overlap_6g(qdf_freq_t low_freq, qdf_freq_t high_freq);
200 #else
201 static inline bool wlan_reg_is_range_only6g(qdf_freq_t low_freq,
202 					    qdf_freq_t high_freq)
203 {
204 	return false;
205 }
206 
207 static inline bool wlan_reg_is_range_overlap_6g(qdf_freq_t low_freq,
208 						qdf_freq_t high_freq)
209 {
210 	return false;
211 }
212 #endif
213 
214 /**
215  * wlan_reg_get_6g_ap_master_chan_list() - provide  the appropriate ap master
216  * channel list
217  * @pdev: pdev pointer
218  * @ap_pwr_type: The ap power type (LPI/VLP/SP)
219  * @chan_list: channel list pointer
220  *
221  * Return: QDF_STATUS
222  */
223 QDF_STATUS wlan_reg_get_6g_ap_master_chan_list(
224 					struct wlan_objmgr_pdev *pdev,
225 					enum reg_6g_ap_type ap_pwr_type,
226 					struct regulatory_channel *chan_list);
227 
228 #ifdef CONFIG_REG_CLIENT
229 /**
230  * wlan_reg_get_power_string () - wlan reg get power type string
231  * @power_type: power type enum
232  *
233  * Return: power type string
234  */
235 const char *wlan_reg_get_power_string(enum reg_6g_ap_type power_type);
236 #endif
237 
238 /**
239  * wlan_reg_is_6ghz_psc_chan_freq() - Check if the given 6GHz channel frequency
240  * is preferred scanning channel frequency.
241  * @freq: Channel frequency
242  *
243  * Return: true if given 6GHz channel frequency is preferred scanning channel
244  * frequency, else false
245  */
246 #define WLAN_REG_IS_6GHZ_PSC_CHAN_FREQ(freq) \
247 	wlan_reg_is_6ghz_psc_chan_freq(freq)
248 bool wlan_reg_is_6ghz_psc_chan_freq(uint16_t freq);
249 
250 /**
251  * wlan_reg_min_6ghz_chan_freq() - Get minimum 6GHz channel center frequency
252  *
253  * Return: Minimum 6GHz channel center frequency
254  */
255 #define WLAN_REG_MIN_6GHZ_CHAN_FREQ wlan_reg_min_6ghz_chan_freq()
256 uint16_t wlan_reg_min_6ghz_chan_freq(void);
257 
258 /**
259  * wlan_reg_max_6ghz_chan_freq() - Get maximum 6GHz channel center frequency
260  *
261  * Return: Maximum 6GHz channel center frequency
262  */
263 #define WLAN_REG_MAX_6GHZ_CHAN_FREQ wlan_reg_max_6ghz_chan_freq()
264 uint16_t wlan_reg_max_6ghz_chan_freq(void);
265 
266 /**
267  * wlan_reg_is_6g_freq_indoor() - Check if a 6GHz frequency is indoor.
268  * @pdev: Pointer to pdev.
269  * @freq: Channel frequency.
270  *
271  * Return: Return true if a 6GHz frequency is indoor, else false.
272  */
273 #define WLAN_REG_IS_6GHZ_FREQ_INDOOR(pdev, freq) \
274 					wlan_reg_is_6g_freq_indoor(pdev, freq)
275 bool wlan_reg_is_6g_freq_indoor(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq);
276 
277 /**
278  * wlan_reg_get_max_txpower_for_6g_tpe() - Get max txpower for 6G TPE IE.
279  * @pdev: Pointer to pdev.
280  * @freq: Channel frequency.
281  * @bw: Channel bandwidth.
282  * @reg_ap: Regulatory 6G AP type.
283  * @reg_client: Regulatory client type.
284  * @is_psd: True if txpower is needed in PSD format, and false if needed in EIRP
285  * format.
286  * @tx_power: Pointer to tx-power.
287  *
288  * Return: Return QDF_STATUS_SUCCESS, if tx_power is filled for 6G TPE IE
289  * else return QDF_STATUS_E_FAILURE.
290  */
291 QDF_STATUS
292 wlan_reg_get_max_txpower_for_6g_tpe(struct wlan_objmgr_pdev *pdev,
293 				    qdf_freq_t freq, uint8_t bw,
294 				    enum reg_6g_ap_type reg_ap,
295 				    enum reg_6g_client_type reg_client,
296 				    bool is_psd,
297 				    uint8_t *tx_power);
298 
299 /**
300  * wlan_reg_get_superchan_entry() - Get the address of the super channel list
301  * entry for a given input channel index.
302  *
303  * @pdev: pdev ptr
304  * @chan_enum: Channel enum
305  * @p_sup_chan_entry: Pointer to address of *p_sup_chan_entry
306  *
307  * Return: QDF_STATUS_SUCCESS if super channel entry is available for the input
308  * chan_enum else QDF_STATUS_E_FAILURE
309  */
310 QDF_STATUS wlan_reg_get_superchan_entry(
311 		struct wlan_objmgr_pdev *pdev,
312 		enum channel_enum chan_enum,
313 		const struct super_chan_info **p_sup_chan_entry);
314 #else
315 
316 #define WLAN_REG_IS_6GHZ_CHAN_FREQ(freq) (false)
317 static inline bool wlan_reg_is_6ghz_chan_freq(uint16_t freq)
318 {
319 	return false;
320 }
321 
322 static inline bool wlan_reg_is_range_only6g(qdf_freq_t low_freq,
323 					    qdf_freq_t high_freq)
324 {
325 	return false;
326 }
327 
328 #define WLAN_REG_IS_6GHZ_PSC_CHAN_FREQ(freq) (false)
329 static inline bool wlan_reg_is_6ghz_psc_chan_freq(uint16_t freq)
330 {
331 	return false;
332 }
333 
334 #define WLAN_REG_MIN_6GHZ_CHAN_FREQ (false)
335 static inline uint16_t wlan_reg_min_6ghz_chan_freq(void)
336 {
337 	return 0;
338 }
339 
340 #define WLAN_REG_MAX_6GHZ_CHAN_FREQ (false)
341 static inline uint16_t wlan_reg_max_6ghz_chan_freq(void)
342 {
343 	return 0;
344 }
345 
346 #define WLAN_REG_IS_6GHZ_FREQ_INDOOR(pdev, freq) (false)
347 static inline bool
348 wlan_reg_is_6g_freq_indoor(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq)
349 {
350 	return false;
351 }
352 
353 static inline bool wlan_reg_is_range_overlap_6g(qdf_freq_t low_freq,
354 						qdf_freq_t high_freq)
355 {
356 	return false;
357 }
358 
359 static inline QDF_STATUS
360 wlan_reg_get_max_txpower_for_6g_tpe(struct wlan_objmgr_pdev *pdev,
361 				    qdf_freq_t freq, uint8_t bw,
362 				    enum reg_6g_ap_type reg_ap,
363 				    enum reg_6g_client_type reg_client,
364 				    bool is_psd,
365 				    uint8_t *tx_power)
366 {
367 	return QDF_STATUS_E_FAILURE;
368 }
369 
370 static inline QDF_STATUS
371 wlan_reg_get_6g_ap_master_chan_list(struct wlan_objmgr_pdev *pdev,
372 				    enum reg_6g_ap_type ap_pwr_type,
373 				    struct regulatory_channel *chan_list)
374 {
375 	return QDF_STATUS_E_FAILURE;
376 }
377 
378 static inline
379 QDF_STATUS wlan_reg_get_superchan_entry(
380 		struct wlan_objmgr_pdev *pdev,
381 		enum channel_enum chan_enum,
382 		const struct super_chan_info **p_sup_chan_entry)
383 {
384 	*p_sup_chan_entry = NULL;
385 	return QDF_STATUS_E_NOSUPPORT;
386 }
387 
388 static inline
389 const char *wlan_reg_get_power_string(enum reg_6g_ap_type power_type)
390 {
391 	return "INVALID";
392 }
393 #endif /* CONFIG_BAND_6GHZ */
394 
395 /**
396  * wlan_reg_get_band_channel_list() - Get channel list based on the band_mask
397  * @pdev: pdev ptr
398  * @band_mask: Input bitmap with band set
399  * @channel_list: Pointer to Channel List
400  *
401  * Get the given channel list and number of channels from the current channel
402  * list based on input band bitmap.
403  *
404  * Return: Number of channels, else 0 to indicate error
405  */
406 uint16_t
407 wlan_reg_get_band_channel_list(struct wlan_objmgr_pdev *pdev,
408 			       uint8_t band_mask,
409 			       struct regulatory_channel *channel_list);
410 
411 #ifdef CONFIG_REG_6G_PWRMODE
412 /**
413  * wlan_reg_get_band_channel_list_for_pwrmode() - Get channel list based on the
414  * band_mask and input 6G power mode.
415  * @pdev: pdev ptr
416  * @band_mask: Input bitmap with band set
417  * @channel_list: Pointer to Channel List
418  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
419  *
420  * Get the given channel list and number of channels from the current channel
421  * list based on input band bitmap.
422  *
423  * Return: Number of channels, else 0 to indicate error
424  */
425 uint16_t
426 wlan_reg_get_band_channel_list_for_pwrmode(struct wlan_objmgr_pdev *pdev,
427 					   uint8_t band_mask,
428 					   struct regulatory_channel
429 					   *channel_list,
430 					   enum supported_6g_pwr_types
431 					   in_6g_pwr_type);
432 #endif
433 
434 #ifdef CONFIG_REG_CLIENT
435 /**
436  * wlan_reg_get_secondary_band_channel_list() - Get secondary channel list for
437  * SAP based on the band_mask
438  * @pdev: pdev ptr
439  * @band_mask: Input bitmap with band set
440  * @channel_list: Pointer to Channel List
441  *
442  * Get the given channel list and number of channels from the secondary current
443  * channel list based on input band bitmap.
444  *
445  * Return: Number of channels, else 0 to indicate error
446  */
447 uint16_t
448 wlan_reg_get_secondary_band_channel_list(struct wlan_objmgr_pdev *pdev,
449 					 uint8_t band_mask,
450 					 struct regulatory_channel
451 					 *channel_list);
452 #endif
453 
454 /**
455  * wlan_reg_chan_band_to_freq - Return channel frequency based on the channel
456  * number and band.
457  * @pdev: pdev ptr
458  * @chan: Channel Number
459  * @band_mask: Bitmap for bands
460  *
461  * Return: Return channel frequency or return 0, if the channel is disabled or
462  * if the input channel number or band_mask is invalid. Composite bands are
463  * supported only for 2.4Ghz and 5Ghz bands. For other bands the following
464  * priority is given: 1) 6Ghz 2) 5Ghz 3) 2.4Ghz.
465  */
466 qdf_freq_t wlan_reg_chan_band_to_freq(struct wlan_objmgr_pdev *pdev,
467 				      uint8_t chan,
468 				      uint8_t band_mask);
469 
470 #ifdef CONFIG_49GHZ_CHAN
471 /**
472  * wlan_reg_is_49ghz_freq() - Check if the given channel frequency is 4.9GHz
473  * @freq: Channel frequency
474  *
475  * Return: true if channel frequency is 4.9GHz, else false
476  */
477 #define WLAN_REG_IS_49GHZ_FREQ(freq) wlan_reg_is_49ghz_freq(freq)
478 bool wlan_reg_is_49ghz_freq(qdf_freq_t freq);
479 
480 #else
481 
482 #define WLAN_REG_IS_49GHZ_FREQ(freq) (false)
483 static inline bool wlan_reg_is_49ghz_freq(qdf_freq_t freq)
484 {
485 	return false;
486 }
487 #endif /* CONFIG_49GHZ_CHAN */
488 
489 /**
490  * wlan_reg_ch_num() - Get channel number from channel enum
491  * @ch_enum: Channel enum
492  *
493  * Return: channel number
494  */
495 #define WLAN_REG_CH_NUM(ch_enum) wlan_reg_ch_num(ch_enum)
496 uint8_t wlan_reg_ch_num(uint32_t ch_enum);
497 
498 /**
499  * wlan_reg_ch_to_freq() - Get channel frequency from channel enum
500  * @ch_enum: Channel enum
501  *
502  * Return: channel frequency
503  */
504 #define WLAN_REG_CH_TO_FREQ(ch_enum) wlan_reg_ch_to_freq(ch_enum)
505 qdf_freq_t wlan_reg_ch_to_freq(uint32_t ch_enum);
506 
507 /**
508  * wlan_reg_read_default_country() - Read the default country for the regdomain
509  * @country: pointer to the country code.
510  *
511  * Return: QDF_STATUS
512  */
513 QDF_STATUS wlan_reg_read_default_country(struct wlan_objmgr_psoc *psoc,
514 				   uint8_t *country);
515 
516 /**
517  * wlan_reg_get_ctry_idx_max_bw_from_country_code() - Get the max 5G
518  * bandwidth from country code
519  * @pdev: pdev pointer
520  * @cc: Country Code
521  * @max_bw_5g: Max 5G bandwidth supported by the country
522  *
523  * Return: QDF_STATUS
524  */
525 
526 QDF_STATUS wlan_reg_get_max_5g_bw_from_country_code(
527 					struct wlan_objmgr_pdev *pdev,
528 					uint16_t cc,
529 					uint16_t *max_bw_5g);
530 
531 /**
532  * wlan_reg_get_max_5g_bw_from_regdomain() - Get the max 5G bandwidth
533  * supported by the regdomain
534  * @pdev: pdev pointer
535  * @orig_regdmn: Regdomain Pair value
536  * @max_bw_5g: Max 5G bandwidth supported by the country
537  *
538  * Return: QDF_STATUS
539  */
540 QDF_STATUS wlan_reg_get_max_5g_bw_from_regdomain(
541 					struct wlan_objmgr_pdev *pdev,
542 					uint16_t regdmn,
543 					uint16_t *max_bw_5g);
544 
545 /**
546  * wlan_reg_get_max_bw_5G_for_fo() - get max_5g_bw for FullOffload
547  * @pdev: PDEV object
548  *
549  * API to get max_bw_5g from pdev object
550  *
551  * Return: @max_bw_5g
552  */
553 QDF_STATUS wlan_reg_get_max_bw_5G_for_fo(struct wlan_objmgr_pdev *pdev);
554 
555 /**
556  * wlan_reg_is_regdb_offloaded() - get offload_enabled
557  * @psoc: Psoc object
558  *
559  * API to get offload_enabled from psoc.
560  *
561  * Return: true if offload enabled
562  */
563 
564 bool wlan_reg_is_regdb_offloaded(struct wlan_objmgr_psoc *psoc);
565 
566 /**
567  * wlan_reg_get_fcc_constraint() - Check FCC constraint on given frequency
568  * @pdev: physical dev to get
569  * @freq: frequency to be checked
570  *
571  * Return: If FCC constraint is on applied given frequency return true
572  *	   else return false.
573  */
574 bool wlan_reg_get_fcc_constraint(struct wlan_objmgr_pdev *pdev, uint32_t freq);
575 
576 #ifdef CONFIG_REG_CLIENT
577 /**
578  * wlan_reg_read_current_country() - Read the current country for the regdomain
579  * @country: pointer to the country code.
580  *
581  * Return: QDF_STATUS
582  */
583 QDF_STATUS wlan_reg_read_current_country(struct wlan_objmgr_psoc *psoc,
584 				   uint8_t *country);
585 
586 #ifdef CONFIG_REG_CLIENT
587 /**
588  * wlan_reg_get_6g_power_type_for_ctry() - Return power type for 6G based
589  * on country IE
590  * @ap_ctry: ptr to country string in country IE
591  * @sta_ctry: ptr to sta programmed country
592  * @pwr_type_6g: ptr to 6G power type
593  * @ctry_code_match: Check for country IE and sta country code match
594  * @ap_pwr_type: AP's power type for 6G as advertised in HE ops IE
595  * Return: QDF_STATUS
596  */
597 QDF_STATUS
598 wlan_reg_get_6g_power_type_for_ctry(struct wlan_objmgr_psoc *psoc,
599 				    uint8_t *ap_ctry, uint8_t *sta_ctry,
600 				    enum reg_6g_ap_type *pwr_type_6g,
601 				    bool *ctry_code_match,
602 				    enum reg_6g_ap_type ap_pwr_type);
603 #endif
604 
605 #ifdef CONFIG_CHAN_FREQ_API
606 /**
607  * wlan_reg_is_etsi13_srd_chan_for_freq () - Checks if the ch is ETSI13 srd ch
608  * or not
609  * @pdev: pdev ptr
610  * @freq: channel center frequency
611  *
612  * Return: true or false
613  */
614 bool wlan_reg_is_etsi13_srd_chan_for_freq(struct wlan_objmgr_pdev *pdev,
615 					  qdf_freq_t freq);
616 #endif /*CONFIG_CHAN_FREQ_API*/
617 
618 /**
619  * wlan_reg_is_etsi13_regdmn() - Checks if current reg domain is ETSI13 or not
620  * @pdev: pdev ptr
621  *
622  * Return: true or false
623  */
624 bool wlan_reg_is_etsi13_regdmn(struct wlan_objmgr_pdev *pdev);
625 
626 /**
627  * wlan_reg_is_etsi13_srd_chan_allowed_master_mode() - Checks if regdmn is
628  * ETSI13 and SRD channels are allowed in master mode or not.
629  *
630  * @pdev: pdev ptr
631  *
632  * Return: true or false
633  */
634 bool wlan_reg_is_etsi13_srd_chan_allowed_master_mode(struct wlan_objmgr_pdev
635 						     *pdev);
636 #endif
637 
638 /**
639  * wlan_reg_is_world() - reg is world mode
640  * @country: The country information
641  *
642  * Return: true or false
643  */
644 bool wlan_reg_is_world(uint8_t *country);
645 
646 /**
647  * wlan_reg_get_dfs_region () - Get the current dfs region
648  * @dfs_reg: pointer to dfs region
649  *
650  * Return: Status
651  */
652 QDF_STATUS wlan_reg_get_dfs_region(struct wlan_objmgr_pdev *pdev,
653 			     enum dfs_reg *dfs_reg);
654 
655 /**
656  * wlan_reg_is_chan_disabled_and_not_nol() - In the regulatory channel list, a
657  * channel may be disabled by the regulatory/device or by radar. Radar is
658  * temporary and a radar disabled channel does not mean that the channel is
659  * permanently disabled. The API checks if the channel is disabled, but not due
660  * to radar.
661  * @chan - Regulatory channel object
662  *
663  * Return - True,  the channel is disabled, but not due to radar, else false.
664  */
665 bool wlan_reg_is_chan_disabled_and_not_nol(struct regulatory_channel *chan);
666 
667 /**
668  * wlan_reg_get_current_chan_list() - provide the pdev current channel list
669  * @pdev: pdev pointer
670  * @chan_list: channel list pointer
671  *
672  * Return: QDF_STATUS
673  */
674 QDF_STATUS wlan_reg_get_current_chan_list(struct wlan_objmgr_pdev *pdev,
675 		struct regulatory_channel *chan_list);
676 
677 /**
678  * wlan_reg_is_freq_enabled() - Checks if the given frequency is enabled on the
679  * given power mode or not. If the frequency is not a 6G frequency then the
680  * input power mode is ignored and only current channel list is searched.
681  *
682  * @pdev: pdev pointer.
683  * @freq: input frequency.
684  * @in_6g_pwr_mode: Power mode on which the freq is enabled or not is to be
685  * checked.
686  *
687  * Return: True if the frequency is present in the given power mode channel
688  * list.
689  */
690 bool wlan_reg_is_freq_enabled(struct wlan_objmgr_pdev *pdev,
691 			      qdf_freq_t freq,
692 			      enum supported_6g_pwr_types in_6g_pwr_mode);
693 
694 /**
695  * wlan_reg_is_freq_idx_enabled() - Checks if the given frequency index is
696  * enabled on the given power mode or not. If the frequency index is not a 6G
697  * frequency then the input power mode is ignored and only current channel list
698  * is searched.
699  *
700  * @pdev: pdev pointer.
701  * @freq_idx: input frequency index.
702  * @in_6g_pwr_mode: Power mode on which the frequency index is enabled or not
703  * is to be checked.
704  *
705  * Return: True if the frequency index is present in the given power mode
706  * channel list.
707  */
708 bool wlan_reg_is_freq_idx_enabled(struct wlan_objmgr_pdev *pdev,
709 				  enum channel_enum freq_idx,
710 				  enum supported_6g_pwr_types in_6g_pwr_mode);
711 
712 /**
713  * wlan_reg_get_pwrmode_chan_list() - Get the modified channel list. A modified
714  * current channel list consists of 2G and 5G portions of the current channel
715  * list and the 6G portion of the current channel list is derived from the input
716  * 6g power type.
717  * @pdev: Pointer to pdev
718  * @chan_list: Pointer to buffer which stores list of regulatory_channels.
719  * @in_6g_pwr_mode: 6GHz power type
720  *
721  * Return:
722  * QDF_STATUS_SUCCESS: Success
723  * QDF_STATUS_E_INVAL: Failed to get channel list
724  */
725 QDF_STATUS wlan_reg_get_pwrmode_chan_list(struct wlan_objmgr_pdev *pdev,
726 					  struct regulatory_channel *chan_list,
727 					  enum supported_6g_pwr_types
728 					  in_6g_pwr_mode);
729 
730 #ifdef CONFIG_REG_CLIENT
731 /**
732  * wlan_reg_get_secondary_current_chan_list() - provide the pdev secondary
733  * current channel list
734  * @pdev: pdev pointer
735  * @chan_list: channel list pointer
736  *
737  * Return: QDF_STATUS
738  */
739 QDF_STATUS wlan_reg_get_secondary_current_chan_list(
740 					struct wlan_objmgr_pdev *pdev,
741 					struct regulatory_channel *chan_list);
742 #endif
743 
744 #if defined(CONFIG_AFC_SUPPORT) && defined(CONFIG_BAND_6GHZ)
745 /**
746  * wlan_reg_get_6g_afc_chan_list() - provide the pdev afc channel list
747  * @pdev: pdev pointer
748  * @chan_list: channel list pointer
749  *
750  * Return: QDF_STATUS
751  */
752 QDF_STATUS wlan_reg_get_6g_afc_chan_list(struct wlan_objmgr_pdev *pdev,
753 					 struct regulatory_channel *chan_list);
754 
755 /**
756  * wlan_reg_get_6g_afc_mas_chan_list() - provide the pdev afc master channel
757  * list
758  * @pdev: pdev pointer
759  * @chan_list: channel list pointer
760  *
761  * Return: QDF_STATUS
762  */
763 QDF_STATUS
764 wlan_reg_get_6g_afc_mas_chan_list(struct wlan_objmgr_pdev *pdev,
765 				  struct regulatory_channel *chan_list);
766 
767 /**
768  * wlan_reg_is_afc_power_event_received() - Checks if AFC power event is
769  * received from the FW.
770  *
771  * @pdev: pdev ptr
772  *
773  * Return: true if AFC power event is received from the FW or false otherwise
774  */
775 bool wlan_reg_is_afc_power_event_received(struct wlan_objmgr_pdev *pdev);
776 
777 /**
778  * wlan_reg_is_afc_done() - Check if AFC response enables the given frequency.
779  * @pdev: pdev ptr
780  * @freq: given frequency.
781  *
782  * Return: True if frequency is enabled, false otherwise.
783  */
784 bool wlan_reg_is_afc_done(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq);
785 
786 /**
787  * wlan_reg_get_afc_req_id() - Get the AFC request ID
788  * @pdev: pdev pointer
789  * @req_id: Pointer to request id
790  *
791  * Return: QDF_STATUS
792  */
793 QDF_STATUS wlan_reg_get_afc_req_id(struct wlan_objmgr_pdev *pdev,
794 				   uint64_t *req_id);
795 
796 /**
797  * wlan_reg_is_afc_expiry_event_received() - Checks if AFC power event is
798  * received from the FW.
799  *
800  * @pdev: pdev ptr
801  *
802  * Return: true if AFC exipry event is received from the FW or false otherwise
803  */
804 bool wlan_reg_is_afc_expiry_event_received(struct wlan_objmgr_pdev *pdev);
805 
806 /**
807  * wlan_reg_is_noaction_on_afc_pwr_evt() - Checks whether driver needs to
808  * take action for AFC action or the response should be handled by the
809  * user application.
810  *
811  * @pdev: pdev ptr
812  *
813  * Return: true if driver need not take action for AFC resp, false otherwise.
814  */
815 bool
816 wlan_reg_is_noaction_on_afc_pwr_evt(struct wlan_objmgr_pdev *pdev);
817 
818 /**
819  * wlan_reg_get_afc_dev_deploy_type() - Get AFC device deployment type
820  * @pdev: pdev pointer
821  * @afc_dev_type: Pointer to afc device deployment type
822  *
823  * Return: QDF_STATUS
824  */
825 QDF_STATUS
826 wlan_reg_get_afc_dev_deploy_type(struct wlan_objmgr_pdev *pdev,
827 				 enum reg_afc_dev_deploy_type *afc_dev_type);
828 
829 /**
830  * wlan_reg_is_sta_connect_allowed() - Check if STA connection allowed
831  * @pdev: pdev pointer
832  * @root_ap_pwr_mode: power mode of the Root AP.
833  *
834  * Return : True if STA Vap connection is allowed.
835  */
836 bool
837 wlan_reg_is_sta_connect_allowed(struct wlan_objmgr_pdev *pdev,
838 				enum reg_6g_ap_type root_ap_pwr_mode);
839 #else
840 static inline bool
841 wlan_reg_is_afc_power_event_received(struct wlan_objmgr_pdev *pdev)
842 {
843 	return false;
844 }
845 
846 static inline bool
847 wlan_reg_is_afc_done(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq)
848 {
849 	return true;
850 }
851 
852 static inline QDF_STATUS
853 wlan_reg_get_6g_afc_chan_list(struct wlan_objmgr_pdev *pdev,
854 			      struct regulatory_channel *chan_list)
855 {
856 	return QDF_STATUS_E_NOSUPPORT;
857 }
858 
859 static inline bool
860 wlan_reg_is_sta_connect_allowed(struct wlan_objmgr_pdev *pdev,
861 				enum reg_6g_ap_type root_ap_pwr_mode)
862 {
863 	return true;
864 }
865 #endif
866 
867 /**
868  * wlan_reg_get_bonded_channel_state_for_freq() - Get bonded channel freq state
869  * @freq: channel frequency
870  * @bw: channel band width
871  * @sec_freq: secondary frequency
872  *
873  * Return: channel state
874  */
875 enum channel_state
876 wlan_reg_get_bonded_channel_state_for_freq(struct wlan_objmgr_pdev *pdev,
877 					   qdf_freq_t freq,
878 					   enum phy_ch_width bw,
879 					   qdf_freq_t sec_freq);
880 
881 #ifdef CONFIG_REG_6G_PWRMODE
882 /**
883  * wlan_reg_get_bonded_channel_state_for_pwrmode() - Get bonded channel freq
884  * state
885  * @freq: channel frequency
886  * @bw: channel band width
887  * @sec_freq: secondary frequency
888  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
889  *
890  * Return: channel state
891  */
892 enum channel_state
893 wlan_reg_get_bonded_channel_state_for_pwrmode(struct wlan_objmgr_pdev *pdev,
894 					      qdf_freq_t freq,
895 					      enum phy_ch_width bw,
896 					      qdf_freq_t sec_freq,
897 					      enum supported_6g_pwr_types
898 					      in_6g_pwr_mode);
899 #endif
900 
901 /**
902  * wlan_reg_set_dfs_region() - set the dfs region
903  * @pdev: pdev ptr
904  * @dfs_reg: dfs region
905  *
906  * Return: void
907  */
908 void wlan_reg_set_dfs_region(struct wlan_objmgr_pdev *pdev,
909 			     enum dfs_reg dfs_reg);
910 
911 /**
912  * wlan_reg_get_bw_value() - provide the channel center freq
913  * @chan_num: chennal number
914  *
915  * Return: int
916  */
917 uint16_t wlan_reg_get_bw_value(enum phy_ch_width bw);
918 
919 /**
920  * wlan_reg_get_domain_from_country_code() - provide the channel center freq
921  * @reg_domain_ptr: regulatory domain ptr
922  * @country_alpha2: country alpha2
923  * @source: alpha2 source
924  *
925  * Return: int
926  */
927 QDF_STATUS wlan_reg_get_domain_from_country_code(v_REGDOMAIN_t *reg_domain_ptr,
928 						 const uint8_t *country_alpha2,
929 						 enum country_src source);
930 
931 /**
932  * wlan_reg_dmn_get_opclass_from_channel() - provide the channel center freq
933  * @country: country alpha2
934  * @channel: channel number
935  * @offset: offset
936  *
937  * Return: int
938  */
939 uint16_t wlan_reg_dmn_get_opclass_from_channel(uint8_t *country,
940 					       uint8_t channel,
941 					       uint8_t offset);
942 
943 /**
944  * wlan_reg_get_opclass_from_freq_width() - Get operating class from frequency
945  * @country: Country code.
946  * @freq: Channel center frequency.
947  * @ch_width: Channel width.
948  * @behav_limit: Behaviour limit.
949  *
950  * Return: Error code.
951  */
952 uint8_t wlan_reg_get_opclass_from_freq_width(uint8_t *country,
953 					     qdf_freq_t freq,
954 					     uint16_t ch_width,
955 					     uint16_t behav_limit);
956 
957 /**
958  * wlan_reg_get_band_cap_from_op_class() - Return band capability bitmap
959  * @country: Pointer to Country code.
960  * @num_of_opclass: Number of Operating class.
961  * @opclass: Pointer to opclass.
962  *
963  * Return supported band bitmap based on the input operating class list
964  * provided.
965  *
966  * Return: Return supported band capability
967  */
968 uint8_t wlan_reg_get_band_cap_from_op_class(const uint8_t *country,
969 					    uint8_t num_of_opclass,
970 					    const uint8_t *opclass);
971 
972 /**
973  * wlan_reg_dmn_print_channels_in_opclass() - Print channels in op-class
974  * @country: country alpha2
975  * @opclass: oplcass
976  *
977  * Return: void
978  */
979 void wlan_reg_dmn_print_channels_in_opclass(uint8_t *country,
980 					    uint8_t opclass);
981 
982 
983 /**
984  * wlan_reg_dmn_get_chanwidth_from_opclass() - get channel width from
985  *                                             operating class
986  * @country: country alpha2
987  * @channel: channel number
988  * @opclass: operating class
989  *
990  * Return: int
991  */
992 uint16_t wlan_reg_dmn_get_chanwidth_from_opclass(uint8_t *country,
993 						 uint8_t channel,
994 						 uint8_t opclass);
995 
996 /**
997  * wlan_reg_dmn_get_chanwidth_from_opclass_auto() - get channel width from
998  * operating class. If opclass not found then search in global opclass.
999  * @country: country alpha2
1000  * @channel: channel number
1001  * @opclass: operating class
1002  *
1003  * Return: int
1004  */
1005 uint16_t wlan_reg_dmn_get_chanwidth_from_opclass_auto(uint8_t *country,
1006 						      uint8_t channel,
1007 						      uint8_t opclass);
1008 
1009 /**
1010  * wlan_reg_dmn_set_curr_opclasses() - set operating class
1011  * @num_classes: number of classes
1012  * @class: operating class
1013  *
1014  * Return: int
1015  */
1016 uint16_t wlan_reg_dmn_set_curr_opclasses(uint8_t num_classes,
1017 					 uint8_t *class);
1018 
1019 /**
1020  * wlan_reg_dmn_get_curr_opclasses() - get current oper classes
1021  * @num_classes: number of classes
1022  * @class: operating class
1023  *
1024  * Return: int
1025  */
1026 uint16_t wlan_reg_dmn_get_curr_opclasses(uint8_t *num_classes,
1027 					 uint8_t *class);
1028 
1029 
1030 /**
1031  * wlan_reg_get_opclass_details() - Get details about the current opclass table.
1032  * @pdev: Pointer to pdev.
1033  * @reg_ap_cap: Pointer to reg_ap_cap.
1034  * @n_opclasses: Pointer to number of opclasses.
1035  * @max_supp_op_class: Maximum number of operating classes supported.
1036  * @global_tbl_lookup: Whether to lookup global op class tbl.
1037  *
1038  * Return: QDF_STATUS_SUCCESS if success, else return QDF_STATUS_FAILURE.
1039  */
1040 QDF_STATUS
1041 wlan_reg_get_opclass_details(struct wlan_objmgr_pdev *pdev,
1042 			     struct regdmn_ap_cap_opclass_t *reg_ap_cap,
1043 			     uint8_t *n_opclasses,
1044 			     uint8_t max_supp_op_class,
1045 			     bool global_tbl_lookup);
1046 
1047 /**
1048  * wlan_reg_get_opclass_for_cur_hwmode() - Get details about the
1049  * opclass table for the current hwmode.
1050  * @pdev: Pointer to pdev.
1051  * @reg_ap_cap: Pointer to reg_ap_cap.
1052  * @n_opclasses: Pointer to number of opclasses.
1053  * @max_supp_op_class: Maximum number of operating classes supported.
1054  * @global_tbl_lookup: Whether to lookup global op class tbl.
1055  * @max_chwidth: Maximum channel width supported by cur hwmode
1056  * @is_80p80_supp: Bool to indicate if 80p80 is supported.
1057  *
1058  * Return: QDF_STATUS_SUCCESS if success, else return QDF_STATUS_FAILURE.
1059  */
1060 QDF_STATUS
1061 wlan_reg_get_opclass_for_cur_hwmode(struct wlan_objmgr_pdev *pdev,
1062 				    struct regdmn_ap_cap_opclass_t *reg_ap_cap,
1063 				    uint8_t *n_opclasses,
1064 				    uint8_t max_supp_op_class,
1065 				    bool global_tbl_lookup,
1066 				    enum phy_ch_width max_chwidth,
1067 				    bool is_80p80_supp);
1068 /**
1069  * wlan_reg_get_cc_and_src () - get country code and src
1070  * @psoc: psoc ptr
1071  * @alpha2: country code alpha2
1072  *
1073  * Return: country_src
1074  */
1075 enum country_src wlan_reg_get_cc_and_src(struct wlan_objmgr_psoc *psoc,
1076 					 uint8_t *alpha);
1077 
1078 /**
1079  * wlan_regulatory_init() - init regulatory component
1080  *
1081  * Return: Success or Failure
1082  */
1083 QDF_STATUS wlan_regulatory_init(void);
1084 
1085 /**
1086  * wlan_regulatory_deinit() - deinit regulatory component
1087  *
1088  * Return: Success or Failure
1089  */
1090 QDF_STATUS wlan_regulatory_deinit(void);
1091 
1092 /**
1093  * regulatory_psoc_open() - open regulatory component
1094  *
1095  * Return: Success or Failure
1096  */
1097 QDF_STATUS regulatory_psoc_open(struct wlan_objmgr_psoc *psoc);
1098 
1099 
1100 /**
1101  * regulatory_psoc_close() - close regulatory component
1102  *
1103  * Return: Success or Failure
1104  */
1105 QDF_STATUS regulatory_psoc_close(struct wlan_objmgr_psoc *psoc);
1106 
1107 /**
1108  * regulatory_pdev_open() - Open regulatory component
1109  * @pdev: Pointer to pdev structure
1110  *
1111  * Return: Success or Failure
1112  */
1113 QDF_STATUS regulatory_pdev_open(struct wlan_objmgr_pdev *pdev);
1114 
1115 /**
1116  * regulatory_pdev_close() - Close regulatory component
1117  * @pdev: Pointer to pdev structure.
1118  *
1119  * Return: Success or Failure
1120  */
1121 QDF_STATUS regulatory_pdev_close(struct wlan_objmgr_pdev *pdev);
1122 
1123 /**
1124  * wlan_reg_freq_to_chan () - convert channel freq to channel number
1125  * @pdev: The physical dev to set current country for
1126  * @freq: frequency
1127  *
1128  * Return: true or false
1129  */
1130 uint8_t wlan_reg_freq_to_chan(struct wlan_objmgr_pdev *pdev,
1131 			      qdf_freq_t freq);
1132 
1133 /**
1134  * wlan_reg_legacy_chan_to_freq () - convert chan to freq, for 2G and 5G
1135  * @chan: channel number
1136  *
1137  * Return: frequency
1138  */
1139 qdf_freq_t wlan_reg_legacy_chan_to_freq(struct wlan_objmgr_pdev *pdev,
1140 					uint8_t chan);
1141 
1142 /**
1143  * wlan_reg_is_us() - reg is us country
1144  * @country: The country information
1145  *
1146  * Return: true or false
1147  */
1148 bool wlan_reg_is_us(uint8_t *country);
1149 
1150 /**
1151  * wlan_reg_is_etsi() - reg is a country in EU
1152  * @country: The country information
1153  *
1154  * Return: true or false
1155  */
1156 bool wlan_reg_is_etsi(uint8_t *country);
1157 
1158 
1159 /**
1160  * wlan_reg_ctry_support_vlp() - Country supports VLP or not
1161  * @country: The country information
1162  *
1163  * Return: true or false
1164  */
1165 bool wlan_reg_ctry_support_vlp(uint8_t *country);
1166 
1167 /**
1168  * wlan_reg_set_country() - Set the current regulatory country
1169  * @pdev: The physical dev to set current country for
1170  * @country: The country information to configure
1171  *
1172  * Return: QDF_STATUS
1173  */
1174 QDF_STATUS wlan_reg_set_country(struct wlan_objmgr_pdev *pdev,
1175 				uint8_t *country);
1176 
1177 /**
1178  * wlan_reg_set_11d_country() - Set the 11d regulatory country
1179  * @pdev: The physical dev to set current country for
1180  * @country: The country information to configure
1181  *
1182  * Return: QDF_STATUS
1183  */
1184 QDF_STATUS wlan_reg_set_11d_country(struct wlan_objmgr_pdev *pdev,
1185 				    uint8_t *country);
1186 
1187 /**
1188  * wlan_reg_register_chan_change_callback () - add chan change cbk
1189  * @psoc: psoc ptr
1190  * @cbk: callback
1191  * @arg: argument
1192  *
1193  * Return: true or false
1194  */
1195 void wlan_reg_register_chan_change_callback(struct wlan_objmgr_psoc *psoc,
1196 					    void *cbk, void *arg);
1197 
1198 /**
1199  * wlan_reg_unregister_chan_change_callback () - remove chan change cbk
1200  * @psoc: psoc ptr
1201  * @cbk:callback
1202  *
1203  * Return: true or false
1204  */
1205 void wlan_reg_unregister_chan_change_callback(struct wlan_objmgr_psoc *psoc,
1206 					      void *cbk);
1207 
1208 /**
1209  * wlan_reg_is_11d_offloaded() - 11d offloaded supported
1210  * @psoc: psoc ptr
1211  *
1212  * Return: bool
1213  */
1214 bool wlan_reg_is_11d_offloaded(struct wlan_objmgr_psoc *psoc);
1215 
1216 /**
1217  * wlan_reg_11d_enabled_on_host() - 11d enabled don host
1218  * @psoc: psoc ptr
1219  *
1220  * Return: bool
1221  */
1222 bool wlan_reg_11d_enabled_on_host(struct wlan_objmgr_psoc *psoc);
1223 
1224 /**
1225  * wlan_reg_get_chip_mode() - get supported chip mode
1226  * @pdev: pdev pointer
1227  * @chip_mode: chip mode
1228  *
1229  * Return: QDF STATUS
1230  */
1231 QDF_STATUS wlan_reg_get_chip_mode(struct wlan_objmgr_pdev *pdev,
1232 		uint64_t *chip_mode);
1233 
1234 /**
1235  * wlan_reg_is_11d_scan_inprogress() - checks 11d scan status
1236  * @psoc: psoc ptr
1237  *
1238  * Return: bool
1239  */
1240 bool wlan_reg_is_11d_scan_inprogress(struct wlan_objmgr_psoc *psoc);
1241 /**
1242  * wlan_reg_get_freq_range() - Get 2GHz and 5GHz frequency range
1243  * @pdev: pdev pointer
1244  * @low_2g: low 2GHz frequency range
1245  * @high_2g: high 2GHz frequency range
1246  * @low_5g: low 5GHz frequency range
1247  * @high_5g: high 5GHz frequency range
1248  *
1249  * Return: QDF status
1250  */
1251 QDF_STATUS wlan_reg_get_freq_range(struct wlan_objmgr_pdev *pdev,
1252 		qdf_freq_t *low_2g,
1253 		qdf_freq_t *high_2g,
1254 		qdf_freq_t *low_5g,
1255 		qdf_freq_t *high_5g);
1256 /**
1257  * wlan_reg_get_tx_ops () - get regulatory tx ops
1258  * @psoc: psoc ptr
1259  *
1260  */
1261 struct wlan_lmac_if_reg_tx_ops *
1262 wlan_reg_get_tx_ops(struct wlan_objmgr_psoc *psoc);
1263 
1264 /**
1265  * wlan_reg_get_curr_regdomain() - Get current regdomain in use
1266  * @pdev: pdev pointer
1267  * @cur_regdmn: Current regdomain info
1268  *
1269  * Return: QDF status
1270  */
1271 QDF_STATUS wlan_reg_get_curr_regdomain(struct wlan_objmgr_pdev *pdev,
1272 		struct cur_regdmn_info *cur_regdmn);
1273 
1274 #ifdef WLAN_REG_PARTIAL_OFFLOAD
1275 /**
1276  * wlan_reg_is_regdmn_en302502_applicable() - Find if ETSI EN302_502 radar
1277  * pattern is applicable in the current regulatory domain.
1278  * @pdev:    Pdev ptr.
1279  *
1280  * Return: Boolean.
1281  * True:  If EN302_502 is applicable.
1282  * False: otherwise.
1283  */
1284 bool wlan_reg_is_regdmn_en302502_applicable(struct wlan_objmgr_pdev *pdev);
1285 #endif
1286 
1287 /**
1288  * wlan_reg_modify_pdev_chan_range() - Compute current channel list for the
1289  * modified channel range in the regcap.
1290  * @pdev: pointer to wlan_objmgr_pdev.
1291  *
1292  * Return : QDF_STATUS
1293  */
1294 QDF_STATUS wlan_reg_modify_pdev_chan_range(struct wlan_objmgr_pdev *pdev);
1295 
1296 /**
1297  * wlan_reg_get_phybitmap() - Get phybitmap from regulatory pdev_priv_obj
1298  * @pdev: pdev pointer
1299  * @phybitmap: pointer to phybitmap
1300  *
1301  * Return: QDF STATUS
1302  */
1303 QDF_STATUS wlan_reg_get_phybitmap(struct wlan_objmgr_pdev *pdev,
1304 				  uint16_t *phybitmap);
1305 
1306 /**
1307  * wlan_reg_update_pdev_wireless_modes() - Update the wireless_modes in the
1308  * pdev_priv_obj with the input wireless_modes
1309  * @pdev: pointer to wlan_objmgr_pdev.
1310  * @wireless_modes: Wireless modes.
1311  *
1312  * Return : QDF_STATUS
1313  */
1314 QDF_STATUS wlan_reg_update_pdev_wireless_modes(struct wlan_objmgr_pdev *pdev,
1315 					       uint64_t wireless_modes);
1316 /**
1317  * wlan_reg_disable_chan_coex() - Disable Coexisting channels based on the input
1318  * bitmask
1319  * @pdev: pointer to wlan_objmgr_pdev.
1320  * unii_5g_bitmap: UNII 5G bitmap.
1321  *
1322  * Return : QDF_STATUS
1323  */
1324 #ifdef DISABLE_UNII_SHARED_BANDS
1325 QDF_STATUS wlan_reg_disable_chan_coex(struct wlan_objmgr_pdev *pdev,
1326 				      uint8_t unii_5g_bitmap);
1327 #else
1328 static inline QDF_STATUS
1329 wlan_reg_disable_chan_coex(struct wlan_objmgr_pdev *pdev,
1330 			   uint8_t unii_5g_bitmap)
1331 {
1332 	return QDF_STATUS_SUCCESS;
1333 }
1334 #endif
1335 
1336 #ifdef WLAN_FEATURE_GET_USABLE_CHAN_LIST
1337 /**
1338  * wlan_reg_get_usable_channel() - Get usable channels
1339  * @pdev: Pointer to pdev
1340  * @req_msg: Request msg
1341  * @res_msg: Response msg
1342  * @count: no of usable channels
1343  *
1344  * Return: qdf status
1345  */
1346 QDF_STATUS
1347 wlan_reg_get_usable_channel(struct wlan_objmgr_pdev *pdev,
1348 			    struct get_usable_chan_req_params req_msg,
1349 			    struct get_usable_chan_res_params *res_msg,
1350 			    uint32_t *count);
1351 #endif
1352 
1353 #ifdef CONFIG_CHAN_FREQ_API
1354 /**
1355  * wlan_reg_is_same_band_freqs() - Check if two channel frequencies
1356  * have same band
1357  * @freq1: Frequency 1
1358  * @freq2: Frequency 2
1359  *
1360  * Return: true if both the channel frequency has the same band.
1361  */
1362 #define WLAN_REG_IS_SAME_BAND_FREQS(freq1, freq2) \
1363 	wlan_reg_is_same_band_freqs(freq1, freq2)
1364 bool wlan_reg_is_same_band_freqs(qdf_freq_t freq1, qdf_freq_t freq2);
1365 
1366 /**
1367  * wlan_reg_get_chan_enum_for_freq() - Get channel enum for given channel center
1368  * frequency
1369  * @freq: Channel center frequency
1370  *
1371  * Return: Channel enum
1372  */
1373 enum channel_enum wlan_reg_get_chan_enum_for_freq(qdf_freq_t freq);
1374 
1375 /**
1376  * wlan_reg_is_freq_present_in_cur_chan_list() - Check if channel is present
1377  * in the current channel list
1378  * @pdev: pdev pointer
1379  * @freq: Channel center frequency
1380  *
1381  * Return: true if channel is present in current channel list
1382  */
1383 bool wlan_reg_is_freq_present_in_cur_chan_list(struct wlan_objmgr_pdev *pdev,
1384 					       qdf_freq_t freq);
1385 
1386 /**
1387  * wlan_reg_update_nol_history_ch_for_freq() - Set nol-history flag for the
1388  * channels in the list.
1389  *
1390  * @pdev: Pdev ptr
1391  * @ch_list: Input channel list.
1392  * @num_ch: Number of channels.
1393  * @nol_history_ch: Nol history value.
1394  *
1395  * Return: void
1396  */
1397 void wlan_reg_update_nol_history_ch_for_freq(struct wlan_objmgr_pdev *pdev,
1398 					     uint16_t *ch_list,
1399 					     uint8_t num_ch,
1400 					     bool nol_history_ch);
1401 
1402 /**
1403  * wlan_reg_chan_has_dfs_attribute_for_freq() - check channel has dfs
1404  * attribute flag
1405  * @freq: channel center frequency.
1406  *
1407  * This API get chan initial dfs attribute from regdomain
1408  *
1409  * Return: true if chan is dfs, otherwise false
1410  */
1411 bool
1412 wlan_reg_chan_has_dfs_attribute_for_freq(struct wlan_objmgr_pdev *pdev,
1413 					 qdf_freq_t freq);
1414 
1415 /**
1416  * wlan_reg_get_channel_list_with_power_for_freq() - Provide the channel list
1417  * with power
1418  * @ch_list: pointer to the channel list.
1419  *
1420  * Return: QDF_STATUS
1421  */
1422 QDF_STATUS
1423 wlan_reg_get_channel_list_with_power_for_freq(struct wlan_objmgr_pdev *pdev,
1424 					      struct channel_power *ch_list,
1425 					      uint8_t *num_chan);
1426 /**
1427  * wlan_reg_get_5g_bonded_channel_state_for_freq() - Get 5G bonded channel state
1428  * @pdev: The physical dev to program country code or regdomain
1429  * @freq: channel frequency.
1430  * @bw: channel band width
1431  *
1432  * Return: channel state
1433  */
1434 enum channel_state
1435 wlan_reg_get_5g_bonded_channel_state_for_freq(struct wlan_objmgr_pdev *pdev,
1436 					      qdf_freq_t freq,
1437 					      enum phy_ch_width bw);
1438 
1439 #ifdef CONFIG_REG_6G_PWRMODE
1440 /**
1441  * wlan_reg_get_5g_bonded_channel_state_for_pwrmode() - Get 5G bonded channel
1442  * state.
1443  * @pdev: The physical dev to program country code or regdomain
1444  * @freq: channel frequency.
1445  * @ch_params: channel parameters
1446  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
1447  *
1448  * Return: channel state
1449  */
1450 enum channel_state
1451 wlan_reg_get_5g_bonded_channel_state_for_pwrmode(struct wlan_objmgr_pdev *pdev,
1452 						 qdf_freq_t freq,
1453 						 struct ch_params *ch_params,
1454 						 enum supported_6g_pwr_types
1455 						 in_6g_pwr_type);
1456 #endif
1457 
1458 /**
1459  * wlan_reg_get_2g_bonded_channel_state_for_freq() - Get 2G bonded channel state
1460  * @pdev: The physical dev to program country code or regdomain
1461  * @freq: channel center frequency.
1462  * @sec_ch_freq: Secondary channel center frequency.
1463  * @bw: channel band width
1464  *
1465  * Return: channel state
1466  */
1467 enum channel_state
1468 wlan_reg_get_2g_bonded_channel_state_for_freq(struct wlan_objmgr_pdev *pdev,
1469 					      qdf_freq_t freq,
1470 					      qdf_freq_t sec_ch_freq,
1471 					      enum phy_ch_width bw);
1472 
1473 #ifdef CONFIG_REG_6G_PWRMODE
1474 /**
1475  * wlan_reg_get_channel_state_for_pwrmode() - Get channel state from regulatory
1476  * @pdev: Pointer to pdev
1477  * @freq: channel center frequency.
1478  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
1479  *
1480  * Return: channel state
1481  */
1482 enum channel_state
1483 wlan_reg_get_channel_state_for_pwrmode(
1484 				    struct wlan_objmgr_pdev *pdev,
1485 				    qdf_freq_t freq,
1486 				    enum supported_6g_pwr_types in_6g_pwr_type);
1487 #endif
1488 
1489 #ifdef CONFIG_REG_CLIENT
1490 /**
1491  * wlan_reg_get_channel_state_from_secondary_list_for_freq() - Get channel state
1492  * from secondary regulatory current channel list
1493  * @pdev: Pointer to pdev
1494  * @freq: channel center frequency.
1495  *
1496  * Return: channel state
1497  */
1498 enum channel_state wlan_reg_get_channel_state_from_secondary_list_for_freq(
1499 						struct wlan_objmgr_pdev *pdev,
1500 						qdf_freq_t freq);
1501 
1502 /**
1503  * wlan_reg_get_channel_list_with_power() - Provide channel list with tx power
1504  * @ch_list: pointer to the channel list.
1505  * @num_chan: Number of channels which has been filed in ch_list
1506  * @in_6g_pwr_type: 6G power type corresponding to which 6G channels needs to
1507  * be provided
1508  *
1509  * Return: QDF_STATUS
1510  */
1511 QDF_STATUS
1512 wlan_reg_get_channel_list_with_power(
1513 				struct wlan_objmgr_pdev *pdev,
1514 				struct channel_power *ch_list,
1515 				uint8_t *num_chan,
1516 				enum supported_6g_pwr_types in_6g_pwr_type);
1517 #endif
1518 
1519 #ifdef WLAN_FEATURE_11BE
1520 /**
1521  * wlan_reg_fill_channel_list() - Fills the reg_channel_list (list of channels)
1522  * @pdev: Pointer to struct wlan_objmgr_pdev.
1523  * @freq: Center frequency of the primary channel in MHz
1524  * @sec_ch_2g_freq: Secondary channel center frequency.
1525  * @ch_width: Channel width of type 'enum phy_ch_width'.
1526  * @band_center_320: Center frequency of 320MHZ channel.
1527  * @chan_list: Pointer to struct reg_channel_list to be filled (Output param).
1528  * @treat_nol_chan_as_disabled: bool to treat nol channel as enabled or
1529  * disabled. If set to true, nol chan is considered as disabled in chan search.
1530  *
1531  * Return: None
1532  */
1533 void wlan_reg_fill_channel_list(struct wlan_objmgr_pdev *pdev,
1534 				qdf_freq_t freq,
1535 				qdf_freq_t sec_ch_2g_freq,
1536 				enum phy_ch_width ch_width,
1537 				qdf_freq_t band_center_320,
1538 				struct reg_channel_list *chan_list,
1539 				bool treat_nol_chan_as_disabled);
1540 
1541 /**
1542  * wlan_reg_is_punc_bitmap_valid() - is puncture bitmap valid or not
1543  * @bw: Input channel width.
1544  * @puncture_bitmap Input puncture bitmap.
1545  *
1546  * Return: true if given puncture bitmap is valid
1547  */
1548 bool wlan_reg_is_punc_bitmap_valid(enum phy_ch_width bw,
1549 				   uint16_t puncture_bitmap);
1550 
1551 #ifdef QCA_DFS_BW_PUNCTURE
1552 /**
1553  * wlan_reg_find_nearest_puncture_pattern() - is proposed bitmap valid or not
1554  * @bw: Input channel width.
1555  * @proposed_bitmap: Input puncture bitmap.
1556  *
1557  * Return: Radar bitmap if it is valid.
1558  */
1559 uint16_t wlan_reg_find_nearest_puncture_pattern(enum phy_ch_width bw,
1560 						uint16_t proposed_bitmap);
1561 #else
1562 static inline
1563 uint16_t wlan_reg_find_nearest_puncture_pattern(enum phy_ch_width bw,
1564 						uint16_t proposed_bitmap)
1565 {
1566 	return 0;
1567 }
1568 #endif /* QCA_DFS_BW_PUNCTURE */
1569 
1570 /**
1571  * wlan_reg_extract_puncture_by_bw() - generate new puncture bitmap from
1572  *                                     original puncture bitmap and bandwidth
1573  *                                     based on new bandwidth
1574  * @ori_bw: original bandwidth
1575  * @ori_puncture_bitmap: original puncture bitmap
1576  * @freq: frequency of primary channel
1577  * @cen320_freq: center frequency of 320 MHZ if channel width is 320
1578  * @new_bw new bandwidth
1579  * @new_puncture_bitmap: output of puncture bitmap
1580  *
1581  * Return: QDF_STATUS
1582  */
1583 QDF_STATUS wlan_reg_extract_puncture_by_bw(enum phy_ch_width ori_bw,
1584 					   uint16_t ori_puncture_bitmap,
1585 					   qdf_freq_t freq,
1586 					   qdf_freq_t cen320_freq,
1587 					   enum phy_ch_width new_bw,
1588 					   uint16_t *new_puncture_bitmap);
1589 
1590 /**
1591  * wlan_reg_set_create_punc_bitmap() - set is_create_punc_bitmap of ch_params
1592  * @ch_params: ch_params to set
1593  * @is_create_punc_bitmap: is create punc bitmap
1594  *
1595  * Return: NULL
1596  */
1597 void wlan_reg_set_create_punc_bitmap(struct ch_params *ch_params,
1598 				     bool is_create_punc_bitmap);
1599 #ifdef CONFIG_REG_6G_PWRMODE
1600 /**
1601  * wlan_reg_fill_channel_list_for_pwrmode() - Fills the reg_channel_list
1602  * (list of channels)
1603  * @pdev: Pointer to struct wlan_objmgr_pdev.
1604  * @freq: Center frequency of the primary channel in MHz
1605  * @sec_ch_2g_freq: Secondary channel center frequency.
1606  * @ch_width: Channel width of type 'enum phy_ch_width'.
1607  * @band_center_320: Center frequency of 320MHZ channel.
1608  * @chan_list: Pointer to struct reg_channel_list to be filled (Output param).
1609  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
1610  * @treat_nol_chan_as_disabled: bool to treat nol channel as enabled or
1611  * disabled. If set to true, nol chan is considered as disabled in chan search.
1612  *
1613  * Return: None
1614  */
1615 void wlan_reg_fill_channel_list_for_pwrmode(
1616 				struct wlan_objmgr_pdev *pdev,
1617 				qdf_freq_t freq,
1618 				qdf_freq_t sec_ch_2g_freq,
1619 				enum phy_ch_width ch_width,
1620 				qdf_freq_t band_center_320,
1621 				struct reg_channel_list *chan_list,
1622 				enum supported_6g_pwr_types in_6g_pwr_type,
1623 				bool treat_nol_chan_as_disabled);
1624 #endif
1625 #else
1626 static inline
1627 QDF_STATUS wlan_reg_extract_puncture_by_bw(enum phy_ch_width ori_bw,
1628 					   uint16_t ori_puncture_bitmap,
1629 					   qdf_freq_t freq,
1630 					   enum phy_ch_width new_bw,
1631 					   uint16_t *new_puncture_bitmap)
1632 {
1633 	return QDF_STATUS_SUCCESS;
1634 }
1635 
1636 static inline void wlan_reg_set_create_punc_bitmap(struct ch_params *ch_params,
1637 						   bool is_create_punc_bitmap)
1638 {
1639 }
1640 
1641 static inline
1642 uint16_t wlan_reg_find_nearest_puncture_pattern(enum phy_ch_width bw,
1643 						uint16_t proposed_bitmap)
1644 {
1645 	return 0;
1646 }
1647 #endif
1648 
1649 /**
1650  * wlan_reg_set_channel_params_for_freq() - Sets channel parameteres for
1651  * given bandwidth
1652  * @pdev: The physical dev to program country code or regdomain
1653  * @freq: channel center frequency.
1654  * @sec_ch_2g_freq: Secondary channel center frequency.
1655  * @ch_params: pointer to the channel parameters.
1656  *
1657  * Return: None
1658  */
1659 void wlan_reg_set_channel_params_for_freq(struct wlan_objmgr_pdev *pdev,
1660 					  qdf_freq_t freq,
1661 					  qdf_freq_t sec_ch_2g_freq,
1662 					  struct ch_params *ch_params);
1663 
1664 #ifdef CONFIG_REG_6G_PWRMODE
1665 /**
1666  * wlan_reg_set_channel_params_for_pwrmode() - Sets channel parameteres for
1667  * given bandwidth
1668  * @pdev: The physical dev to program country code or regdomain
1669  * @freq: channel center frequency.
1670  * @sec_ch_2g_freq: Secondary channel center frequency.
1671  * @ch_params: pointer to the channel parameters.
1672  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
1673  *
1674  * Return: None
1675  */
1676 void wlan_reg_set_channel_params_for_pwrmode(struct wlan_objmgr_pdev *pdev,
1677 					     qdf_freq_t freq,
1678 					     qdf_freq_t sec_ch_2g_freq,
1679 					     struct ch_params *ch_params,
1680 					     enum supported_6g_pwr_types
1681 					     in_6g_pwr_mode);
1682 #endif
1683 
1684 /**
1685  * wlan_reg_get_channel_cfreq_reg_power_for_freq() - Provide the channel
1686  * regulatory power
1687  * @freq: channel center frequency
1688  *
1689  * Return: int
1690  */
1691 uint8_t wlan_reg_get_channel_reg_power_for_freq(struct wlan_objmgr_pdev *pdev,
1692 						qdf_freq_t freq);
1693 
1694 /**
1695  * wlan_reg_update_nol_ch_for_freq () - set nol channel
1696  * @pdev: pdev ptr
1697  * @chan_freq_list: channel list to be returned
1698  * @num_ch: number of channels
1699  * @nol_ch: nol flag
1700  *
1701  * Return: void
1702  */
1703 void wlan_reg_update_nol_ch_for_freq(struct wlan_objmgr_pdev *pdev,
1704 				     uint16_t *chan_freq_list,
1705 				     uint8_t num_ch,
1706 				     bool nol_ch);
1707 
1708 /**
1709  * wlan_reg_is_dfs_freq() - Checks the channel state for DFS
1710  * @freq: Channel center frequency
1711  *
1712  * Return: true or false
1713  */
1714 bool wlan_reg_is_dfs_for_freq(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq);
1715 
1716 /**
1717  * wlan_reg_is_dsrc_freq() - Checks if the channel is dsrc channel or not
1718  * @freq: Channel center frequency
1719  *
1720  * Return: true or false
1721  */
1722 bool wlan_reg_is_dsrc_freq(qdf_freq_t freq);
1723 
1724 /**
1725  * wlan_reg_is_passive_or_disable_for_freq() - Checks chan state for passive
1726  * and disabled
1727  * @pdev: pdev ptr
1728  * @freq: Channel center frequency
1729  *
1730  * Return: true or false
1731  */
1732 bool wlan_reg_is_passive_or_disable_for_freq(struct wlan_objmgr_pdev *pdev,
1733 					     qdf_freq_t freq);
1734 
1735 #ifdef CONFIG_REG_6G_PWRMODE
1736 /**
1737  * wlan_reg_is_disable_for_pwrmode() - Checks chan state for disabled
1738  * @pdev: pdev ptr
1739  * @freq: Channel center frequency
1740  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
1741  *
1742  * Return: true or false
1743  */
1744 bool wlan_reg_is_disable_for_pwrmode(
1745 				  struct wlan_objmgr_pdev *pdev,
1746 				  qdf_freq_t freq,
1747 				  enum supported_6g_pwr_types in_6g_pwr_mode);
1748 #endif
1749 
1750 #ifdef CONFIG_REG_CLIENT
1751 /**
1752  * wlan_reg_is_disable_in_secondary_list_for_freq() - Checks in the secondary
1753  * channel list to see if chan state is disabled
1754  * @pdev: pdev ptr
1755  * @freq: Channel center frequency
1756  *
1757  * Return: true or false
1758  */
1759 bool wlan_reg_is_disable_in_secondary_list_for_freq(
1760 						struct wlan_objmgr_pdev *pdev,
1761 						qdf_freq_t freq);
1762 
1763 /**
1764  * wlan_reg_is_enable_in_secondary_list_for_freq() - Checks in the secondary
1765  * channel list to see if chan state is enabled
1766  * @pdev: pdev ptr
1767  * @freq: Channel center frequency
1768  *
1769  * Return: true or false
1770  */
1771 bool wlan_reg_is_enable_in_secondary_list_for_freq(
1772 						struct wlan_objmgr_pdev *pdev,
1773 						qdf_freq_t freq);
1774 
1775 /**
1776  * wlan_reg_is_dfs_in_secondary_list_for_freq() - hecks the channel state for
1777  * DFS from the secondary channel list
1778  * @pdev: pdev ptr
1779  * @freq: Channel center frequency
1780  *
1781  * Return: true or false
1782  */
1783 bool wlan_reg_is_dfs_in_secondary_list_for_freq(struct wlan_objmgr_pdev *pdev,
1784 						qdf_freq_t freq);
1785 #endif
1786 
1787 /**
1788  * wlan_reg_is_passive_for_freq() - Check the channel flags to see if the
1789  * passive flag is set
1790  * @pdev: pdev ptr
1791  * @freq: Channel center frequency
1792  *
1793  * Return: true or false
1794  */
1795 bool wlan_reg_is_passive_for_freq(struct wlan_objmgr_pdev *pdev,
1796 				  qdf_freq_t freq);
1797 
1798 /**
1799  * wlan_reg_freq_to_band() - Get band from channel number
1800  * @freq:Channel frequency in MHz
1801  *
1802  * Return: wifi band
1803  */
1804 enum reg_wifi_band wlan_reg_freq_to_band(qdf_freq_t freq);
1805 
1806 /**
1807  * wlan_reg_min_chan_freq() - Minimum channel frequency supported
1808  *
1809  * Return: frequency
1810  */
1811 qdf_freq_t wlan_reg_min_chan_freq(void);
1812 
1813 /**
1814  * wlan_reg_max_chan_freq() - Return max. frequency
1815  *
1816  * Return: frequency
1817  */
1818 qdf_freq_t wlan_reg_max_chan_freq(void);
1819 
1820 /**
1821  * wlan_reg_freq_width_to_chan_op_class() -Get op class from freq
1822  * @pdev: pdev ptr
1823  * @freq: channel frequency
1824  * @chan_width: channel width
1825  * @global_tbl_lookup: whether to look up global table
1826  * @behav_limit: behavior limit
1827  * @op_class: operating class
1828  * @chan_num: channel number
1829  *
1830  * Return: void
1831  */
1832 void wlan_reg_freq_width_to_chan_op_class(struct wlan_objmgr_pdev *pdev,
1833 					  qdf_freq_t freq,
1834 					  uint16_t chan_width,
1835 					  bool global_tbl_lookup,
1836 					  uint16_t behav_limit,
1837 					  uint8_t *op_class,
1838 					  uint8_t *chan_num);
1839 
1840 /**
1841  * wlan_reg_freq_width_to_chan_op_class_auto() - convert frequency to
1842  * operating class,channel
1843  * @pdev: pdev pointer
1844  * @freq: channel frequency in mhz
1845  * @chan_width: channel width
1846  * @global_tbl_lookup: whether to lookup global op class tbl
1847  * @behav_limit: behavior limit
1848  * @op_class: operating class
1849  * @chan_num: channel number
1850  *
1851  * Return: Void.
1852  */
1853 void wlan_reg_freq_width_to_chan_op_class_auto(struct wlan_objmgr_pdev *pdev,
1854 					       qdf_freq_t freq,
1855 					       uint16_t chan_width,
1856 					       bool global_tbl_lookup,
1857 					       uint16_t behav_limit,
1858 					       uint8_t *op_class,
1859 					       uint8_t *chan_num);
1860 
1861 /**
1862  * wlan_reg_freq_to_chan_and_op_class() - Converts freq to oper class
1863  * @pdev: pdev ptr
1864  * @freq: channel frequency
1865  * @global_tbl_lookup: whether to look up global table
1866  * @behav_limit: behavior limit
1867  * @op_class: operating class
1868  * @chan_num: channel number
1869  *
1870  * Return: void
1871  */
1872 void wlan_reg_freq_to_chan_op_class(struct wlan_objmgr_pdev *pdev,
1873 				    qdf_freq_t freq,
1874 				    bool global_tbl_lookup,
1875 				    uint16_t behav_limit,
1876 				    uint8_t *op_class,
1877 				    uint8_t *chan_num);
1878 
1879 /**
1880  * wlan_reg_is_freq_in_country_opclass() - checks frequency in (ctry, op class)
1881  *                                         pair
1882  * @pdev: pdev ptr
1883  * @country: country information
1884  * @op_class: operating class
1885  * @chan_freq: channel frequency
1886  *
1887  * Return: bool
1888  */
1889 bool wlan_reg_is_freq_in_country_opclass(struct wlan_objmgr_pdev *pdev,
1890 					 const uint8_t country[3],
1891 					 uint8_t op_class,
1892 					 qdf_freq_t chan_freq);
1893 /**
1894  * wlan_reg_get_5g_bonded_channel_and_state_for_freq()- Return the channel
1895  * state for a 5G or 6G channel frequency based on the channel width and
1896  * bonded channel.
1897  * @pdev: Pointer to pdev.
1898  * @freq: Channel center frequency.
1899  * @bw Channel Width.
1900  * @bonded_chan_ptr_ptr: Pointer to bonded_channel_freq.
1901  *
1902  * Return: Channel State
1903  */
1904 enum channel_state
1905 wlan_reg_get_5g_bonded_channel_and_state_for_freq(struct wlan_objmgr_pdev *pdev,
1906 						  uint16_t freq,
1907 						  enum phy_ch_width bw,
1908 						  const
1909 						  struct bonded_channel_freq
1910 						  **bonded_chan_ptr_ptr);
1911 
1912 #ifdef CONFIG_REG_6G_PWRMODE
1913 /**
1914  * wlan_reg_get_5g_bonded_channel_and_state_for_pwrmode()- Return the channel
1915  * state for a 5G or 6G channel frequency based on the channel width and
1916  * bonded channel.
1917  * @pdev: Pointer to pdev.
1918  * @freq: Channel center frequency.
1919  * @bw Channel Width.
1920  * @bonded_chan_ptr_ptr: Pointer to bonded_channel_freq.
1921  * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup.
1922  *
1923  * Return: Channel State
1924  */
1925 enum channel_state
1926 wlan_reg_get_5g_bonded_channel_and_state_for_pwrmode(
1927 						  struct wlan_objmgr_pdev *pdev,
1928 						  uint16_t freq,
1929 						  enum phy_ch_width bw,
1930 						  const
1931 						  struct bonded_channel_freq
1932 						  **bonded_chan_ptr_ptr,
1933 						  enum supported_6g_pwr_types
1934 						  in_6g_pwr_mode);
1935 #endif
1936 #endif /*CONFIG_CHAN_FREQ_API */
1937 
1938 /**
1939  * wlan_reg_get_op_class_width() - Get operating class chan width
1940  * @pdev: pdev ptr
1941  * @freq: channel frequency
1942  * @global_tbl_lookup: whether to look up global table
1943  * @op_class: operating class
1944  * @chan_num: channel number
1945  *
1946  * Return: channel width of op class
1947  */
1948 uint16_t wlan_reg_get_op_class_width(struct wlan_objmgr_pdev *pdev,
1949 				     uint8_t op_class,
1950 				     bool global_tbl_lookup);
1951 
1952 /**
1953  * wlan_reg_is_5ghz_op_class() - Check if the input opclass is a 5GHz opclass.
1954  * @country: Country code.
1955  * @op_class: Operating class.
1956  *
1957  * Return: Return true if input the opclass is a 5GHz opclass,
1958  * else return false.
1959  */
1960 bool wlan_reg_is_5ghz_op_class(const uint8_t *country, uint8_t op_class);
1961 
1962 /**
1963  * wlan_reg_is_2ghz_op_class() - Check if the input opclass is a 2.4GHz opclass.
1964  * @country: Country code.
1965  * @op_class: Operating class.
1966  *
1967  * Return: Return true if input the opclass is a 2.4GHz opclass,
1968  * else return false.
1969  */
1970 bool wlan_reg_is_2ghz_op_class(const uint8_t *country, uint8_t op_class);
1971 
1972 /**
1973  * wlan_reg_is_6ghz_op_class() - Whether 6ghz oper class
1974  * @pdev: pdev ptr
1975  * @op_class: operating class
1976  *
1977  * Return: bool
1978  */
1979 bool wlan_reg_is_6ghz_op_class(struct wlan_objmgr_pdev *pdev,
1980 			       uint8_t op_class);
1981 
1982 #ifdef CONFIG_REG_CLIENT
1983 /**
1984  * wlan_reg_is_6ghz_supported() - Whether 6ghz is supported
1985  * @psoc: psoc ptr
1986  *
1987  * Return: bool
1988  */
1989 bool wlan_reg_is_6ghz_supported(struct wlan_objmgr_psoc *psoc);
1990 #endif
1991 
1992 #ifdef HOST_OPCLASS_EXT
1993 /**
1994  * wlan_reg_country_chan_opclass_to_freq() - Convert channel number to
1995  * frequency based on country code and op class
1996  * @pdev: pdev object.
1997  * @country: country code.
1998  * @chan: IEEE Channel Number.
1999  * @op_class: Opclass.
2000  * @strict: flag to find channel from matched operating class code.
2001  *
2002  * Look up (channel, operating class) pair in country operating class tables
2003  * and return the channel frequency.
2004  * If not found and "strict" flag is false, try to get frequency (Mhz) by
2005  * channel number only.
2006  *
2007  * Return: Channel center frequency else return 0.
2008  */
2009 qdf_freq_t
2010 wlan_reg_country_chan_opclass_to_freq(struct wlan_objmgr_pdev *pdev,
2011 				      const uint8_t country[3],
2012 				      uint8_t chan, uint8_t op_class,
2013 				      bool strict);
2014 #endif
2015 
2016 /**
2017  * reg_chan_opclass_to_freq() - Convert channel number and opclass to frequency
2018  * @chan: IEEE Channel Number.
2019  * @op_class: Opclass.
2020  * @global_tbl_lookup: Global table lookup.
2021  *
2022  * Return: Channel center frequency else return 0.
2023  */
2024 uint16_t wlan_reg_chan_opclass_to_freq(uint8_t chan,
2025 				       uint8_t op_class,
2026 				       bool global_tbl_lookup);
2027 
2028 /**
2029  * wlan_reg_chan_opclass_to_freq_auto() - Convert channel number and opclass to
2030  * frequency
2031  * @chan: IEEE channel number
2032  * @op_class: Operating class of channel
2033  * @global_tbl_lookup: Flag to determine if global table has to be looked up
2034  *
2035  * Return: Channel center frequency if valid, else zero
2036  */
2037 
2038 qdf_freq_t wlan_reg_chan_opclass_to_freq_auto(uint8_t chan, uint8_t op_class,
2039 					      bool global_tbl_lookup);
2040 
2041 #ifdef CHECK_REG_PHYMODE
2042 /**
2043  * wlan_reg_get_max_phymode() - Find the best possible phymode given a
2044  * phymode, a frequency, and per-country regulations
2045  * @pdev: pdev pointer
2046  * @phy_in: phymode that the user requested
2047  * @freq: current operating center frequency
2048  *
2049  * Return: maximum phymode allowed in current country that is <= phy_in
2050  */
2051 enum reg_phymode wlan_reg_get_max_phymode(struct wlan_objmgr_pdev *pdev,
2052 					  enum reg_phymode phy_in,
2053 					  qdf_freq_t freq);
2054 #else
2055 static inline enum reg_phymode
2056 wlan_reg_get_max_phymode(struct wlan_objmgr_pdev *pdev,
2057 			 enum reg_phymode phy_in,
2058 			 qdf_freq_t freq)
2059 {
2060 	return REG_PHYMODE_INVALID;
2061 }
2062 #endif /* CHECK_REG_PHYMODE */
2063 
2064 #ifdef CONFIG_REG_CLIENT
2065 /**
2066  * wlan_reg_band_bitmap_to_band_info() - Convert the band_bitmap to a
2067  *	band_info enum
2068  * @band_bitmap: bitmap on top of reg_wifi_band of bands enabled
2069  *
2070  * Return: BAND_ALL if both 2G and 5G band is enabled
2071  *	BAND_2G if 2G is enabled but 5G isn't
2072  *	BAND_5G if 5G is enabled but 2G isn't
2073  */
2074 enum band_info wlan_reg_band_bitmap_to_band_info(uint32_t band_bitmap);
2075 #endif
2076 
2077 #if defined(CONFIG_BAND_6GHZ)
2078 /**
2079  * wlan_reg_get_cur_6g_ap_pwr_type() - Get the current 6G regulatory AP power
2080  * type.
2081  * @pdev: Pointer to PDEV object.
2082  * @reg_cur_6g_ap_pwr_type: The current regulatory 6G AP power type ie.
2083  * LPI/SP/VLP.
2084  *
2085  * Return: QDF_STATUS.
2086  */
2087 QDF_STATUS
2088 wlan_reg_get_cur_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev,
2089 				enum reg_6g_ap_type *reg_cur_6g_ap_pwr_type);
2090 
2091 /**
2092  * wlan_reg_get_cur_6g_client_type() - Get the current 6G regulatory client
2093  * type.
2094  * @pdev: Pointer to PDEV object.
2095  * @reg_cur_6g_client_mobility_type: The current regulatory 6G client type ie.
2096  * default/subordinate.
2097  *
2098  * Return: QDF_STATUS.
2099  */
2100 QDF_STATUS
2101 wlan_reg_get_cur_6g_client_type(struct wlan_objmgr_pdev *pdev,
2102 				enum reg_6g_client_type
2103 				*reg_cur_6g_client_mobility_type);
2104 /**
2105  * wlan_reg_get_rnr_tpe_usable() - Tells if RNR IE is applicable for current
2106  * domain.
2107  * @pdev: Pointer to PDEV object.
2108  * @reg_rnr_tpe_usable: Pointer to hold the bool value, true if RNR IE is
2109  * applicable, else false.
2110  *
2111  * Return: QDF_STATUS.
2112  */
2113 QDF_STATUS wlan_reg_get_rnr_tpe_usable(struct wlan_objmgr_pdev *pdev,
2114 				       bool *reg_rnr_tpe_usable);
2115 
2116 /**
2117  * wlan_reg_get_unspecified_ap_usable() - Tells if AP type unspecified by 802.11
2118  * can be used or not.
2119  * @pdev: Pointer to PDEV object.
2120  * @reg_unspecified_ap_usable: Pointer to hold the bool value, true if
2121  * unspecified AP types can be used in the IE, else false.
2122  *
2123  * Return: QDF_STATUS.
2124  */
2125 QDF_STATUS wlan_reg_get_unspecified_ap_usable(struct wlan_objmgr_pdev *pdev,
2126 					      bool *reg_unspecified_ap_usable);
2127 
2128 /**
2129  * wlan_reg_is_6g_psd_power() - Checks if given freq is PSD power
2130  *
2131  * @pdev: pdev ptr
2132  * @freq: channel frequency
2133  *
2134  * Return: true if channel is PSD power or false otherwise
2135  */
2136 bool wlan_reg_is_6g_psd_power(struct wlan_objmgr_pdev *pdev);
2137 
2138 /**
2139  * wlan_reg_get_6g_chan_ap_power() - Finds the AP TX power for the given channel
2140  *	frequency
2141  *
2142  * @pdev: pdev ptr
2143  * @chan_freq: channel frequency
2144  * @is_psd: is channel PSD or not
2145  * @tx_power: transmit power to fill for chan_freq
2146  * @eirp_psd_power: EIRP power, will only be filled if is_psd is true
2147  *
2148  * Return: QDF_STATUS
2149  */
2150 QDF_STATUS wlan_reg_get_6g_chan_ap_power(struct wlan_objmgr_pdev *pdev,
2151 					 qdf_freq_t chan_freq, bool *is_psd,
2152 					 uint16_t *tx_power,
2153 					 uint16_t *eirp_psd_power);
2154 
2155 /**
2156  * wlan_reg_get_client_power_for_connecting_ap() - Find the channel information
2157  *	when device is operating as a client
2158  *
2159  * @pdev: pdev ptr
2160  * @ap_type: type of AP that device is connected to
2161  * @chan_freq: channel frequency
2162  * @is_psd: is channel PSD or not
2163  * @tx_power: transmit power to fill for chan_freq
2164  * @eirp_psd_power: EIRP power, will only be filled if is_psd is true
2165  *
2166  * This function is meant to be called to find the channel frequency power
2167  * information for a client when the device is operating as a client. It will
2168  * fill in the parameters tx_power and eirp_psd_power. eirp_psd_power will
2169  * only be filled if the channel is PSD.
2170  *
2171  * Return: QDF_STATUS
2172  */
2173 QDF_STATUS
2174 wlan_reg_get_client_power_for_connecting_ap(struct wlan_objmgr_pdev *pdev,
2175 					    enum reg_6g_ap_type ap_type,
2176 					    qdf_freq_t chan_freq,
2177 					    bool is_psd, uint16_t *tx_power,
2178 					    uint16_t *eirp_psd_power);
2179 
2180 /**
2181  * wlan_reg_get_client_power_for_6ghz_ap() - Find the channel information when
2182  *	device is operating as a 6GHz AP
2183  *
2184  * @pdev: pdev ptr
2185  * @client_type: type of client that is connected to our AP
2186  * @chan_freq: channel frequency
2187  * @is_psd: is channel PSD or not
2188  * @tx_power: transmit power to fill for chan_freq
2189  * @eirp_psd_power: EIRP power, will only be filled if is_psd is true
2190  *
2191  * This function is meant to be called to find the channel frequency power
2192  * information for a client when the device is operating as an AP. It will fill
2193  * in the parameter is_psd, tx_power, and eirp_psd_power. eirp_psd_power will
2194  * only be filled if the channel is PSD.
2195  *
2196  * Return: QDF_STATUS
2197  */
2198 QDF_STATUS
2199 wlan_reg_get_client_power_for_6ghz_ap(struct wlan_objmgr_pdev *pdev,
2200 				      enum reg_6g_client_type client_type,
2201 				      qdf_freq_t chan_freq,
2202 				      bool *is_psd, uint16_t *tx_power,
2203 				      uint16_t *eirp_psd_power);
2204 
2205 /**
2206  * wlan_reg_decide_6g_ap_pwr_type() - Decide which power mode AP should operate
2207  * in
2208  *
2209  * @pdev: pdev ptr
2210  *
2211  * Return: AP power type
2212  */
2213 enum reg_6g_ap_type
2214 wlan_reg_decide_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev);
2215 
2216 /**
2217  * wlan_reg_set_ap_pwr_and_update_chan_list() - Set the AP power mode and
2218  * recompute the current channel list
2219  *
2220  * @pdev: pdev ptr
2221  * @ap_pwr_type: the AP power type to update to
2222  *
2223  * Return: QDF_STATUS
2224  */
2225 QDF_STATUS
2226 wlan_reg_set_ap_pwr_and_update_chan_list(struct wlan_objmgr_pdev *pdev,
2227 					 enum reg_6g_ap_type ap_pwr_type);
2228 
2229 /**
2230  * wlan_reg_get_best_6g_pwr_type() - Returns the best 6g power type supported
2231  * for a given frequency.
2232  * @pdev: pdev pointer
2233  * @freq: input frequency.
2234  *
2235  * Return: supported_6g_pwr_types enum.
2236  */
2237 enum supported_6g_pwr_types
2238 wlan_reg_get_best_6g_pwr_type(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq);
2239 
2240 /**
2241  * wlan_reg_conv_6g_ap_type_to_supported_6g_pwr_types() - Converts the 6G AP
2242  * power type to 6g supported power type enum.
2243  * @ap_pwr_type: input 6G AP power type.
2244  *
2245  * Return: supported_6g_pwr_types enum.
2246  */
2247 enum supported_6g_pwr_types
2248 wlan_reg_conv_6g_ap_type_to_supported_6g_pwr_types(enum reg_6g_ap_type
2249 						   ap_pwr_type);
2250 
2251 /**
2252  * wlan_reg_conv_supported_6g_pwr_type_to_ap_pwr_type() - The supported 6G power
2253  * type is a combination of AP and client power types. This API return the 6G AP
2254  * power type portion of the supported 6G power type.
2255  * @in_6g_pwr_type: input 6G supported power type.
2256  *
2257  * Return: 6G AP power type.
2258  */
2259 enum reg_6g_ap_type
2260 wlan_reg_conv_supported_6g_pwr_type_to_ap_pwr_type(enum supported_6g_pwr_types
2261 						  in_6g_pwr_type);
2262 #else /* !CONFIG_BAND_6GHZ */
2263 static inline QDF_STATUS
2264 wlan_reg_get_cur_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev,
2265 				enum reg_6g_ap_type *reg_cur_6g_ap_pwr_type)
2266 {
2267 	*reg_cur_6g_ap_pwr_type = REG_CURRENT_MAX_AP_TYPE;
2268 	return QDF_STATUS_E_NOSUPPORT;
2269 }
2270 
2271 static inline QDF_STATUS
2272 wlan_reg_get_cur_6g_client_type(struct wlan_objmgr_pdev *pdev,
2273 				enum reg_6g_client_type
2274 				*reg_cur_6g_client_mobility_type)
2275 {
2276 	*reg_cur_6g_client_mobility_type = REG_SUBORDINATE_CLIENT;
2277 	return QDF_STATUS_E_NOSUPPORT;
2278 }
2279 
2280 static inline
2281 QDF_STATUS wlan_reg_get_rnr_tpe_usable(struct wlan_objmgr_pdev *pdev,
2282 				       bool *reg_rnr_tpe_usable)
2283 {
2284 	*reg_rnr_tpe_usable = false;
2285 	return QDF_STATUS_E_NOSUPPORT;
2286 }
2287 
2288 static inline
2289 QDF_STATUS wlan_reg_get_unspecified_ap_usable(struct wlan_objmgr_pdev *pdev,
2290 					      bool *reg_unspecified_ap_usable)
2291 {
2292 	*reg_unspecified_ap_usable = false;
2293 	return QDF_STATUS_E_NOSUPPORT;
2294 }
2295 
2296 static inline
2297 bool wlan_reg_is_6g_psd_power(struct wlan_objmgr_pdev *pdev)
2298 {
2299 	return false;
2300 }
2301 
2302 static inline
2303 QDF_STATUS wlan_reg_get_6g_chan_ap_power(struct wlan_objmgr_pdev *pdev,
2304 					 qdf_freq_t chan_freq, bool *is_psd,
2305 					 uint16_t *tx_power,
2306 					 uint16_t *eirp_psd_power)
2307 {
2308 	*is_psd = false;
2309 	*tx_power = 0;
2310 	*eirp_psd_power = 0;
2311 	return QDF_STATUS_E_NOSUPPORT;
2312 }
2313 
2314 static inline QDF_STATUS
2315 wlan_reg_get_client_power_for_connecting_ap(struct wlan_objmgr_pdev *pdev,
2316 					    enum reg_6g_ap_type ap_type,
2317 					    qdf_freq_t chan_freq,
2318 					    bool is_psd, uint16_t *tx_power,
2319 					    uint16_t *eirp_psd_power)
2320 {
2321 	*tx_power = 0;
2322 	*eirp_psd_power = 0;
2323 	return QDF_STATUS_E_NOSUPPORT;
2324 }
2325 
2326 static inline QDF_STATUS
2327 wlan_reg_get_client_power_for_6ghz_ap(struct wlan_objmgr_pdev *pdev,
2328 				      enum reg_6g_client_type client_type,
2329 				      qdf_freq_t chan_freq,
2330 				      bool *is_psd, uint16_t *tx_power,
2331 				      uint16_t *eirp_psd_power)
2332 {
2333 	*is_psd = false;
2334 	*tx_power = 0;
2335 	*eirp_psd_power = 0;
2336 	return QDF_STATUS_E_NOSUPPORT;
2337 }
2338 
2339 static inline enum reg_6g_ap_type
2340 wlan_reg_decide_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev)
2341 {
2342 	return REG_INDOOR_AP;
2343 }
2344 
2345 static inline QDF_STATUS
2346 wlan_reg_set_ap_pwr_and_update_chan_list(struct wlan_objmgr_pdev *pdev,
2347 					 enum reg_6g_ap_type ap_pwr_type)
2348 {
2349 	return QDF_STATUS_E_NOSUPPORT;
2350 }
2351 
2352 static inline enum supported_6g_pwr_types
2353 wlan_reg_get_best_6g_pwr_type(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq)
2354 {
2355 	return REG_INVALID_PWR_MODE;
2356 }
2357 
2358 static inline enum supported_6g_pwr_types
2359 wlan_reg_conv_6g_ap_type_to_supported_6g_pwr_types(enum reg_6g_ap_type
2360 						   ap_pwr_type)
2361 {
2362 	return REG_INVALID_PWR_MODE;
2363 }
2364 
2365 static inline enum reg_6g_ap_type
2366 wlan_reg_conv_supported_6g_pwr_type_to_ap_pwr_type(enum supported_6g_pwr_types
2367 						   in_6g_pwr_type)
2368 {
2369 	return REG_MAX_AP_TYPE;
2370 }
2371 #endif /* CONFIG_BAND_6GHZ */
2372 
2373 /**
2374  * wlan_reg_is_ext_tpc_supported() - Checks if FW supports new WMI cmd for TPC
2375  *
2376  * @psoc: psoc ptr
2377  *
2378  * Return: true if FW supports new command or false otherwise
2379  */
2380 bool wlan_reg_is_ext_tpc_supported(struct wlan_objmgr_psoc *psoc);
2381 
2382 /**
2383  * wlan_reg_is_chwidth_supported() - Check if given channel width is supported
2384  * on a given pdev
2385  * @pdev: pdev pointer
2386  * @ch_width: channel width.
2387  * @is_supported: whether the channel width is supported
2388  *
2389  * Return QDF_STATUS_SUCCESS of operation
2390  */
2391 QDF_STATUS wlan_reg_is_chwidth_supported(struct wlan_objmgr_pdev *pdev,
2392 					 enum phy_ch_width ch_width,
2393 					 bool *is_supported);
2394 
2395 #ifdef CONFIG_BAND_6GHZ
2396 /**
2397  * wlan_reg_get_thresh_priority_freq() - Get the prioritized frequency value
2398  * @pdev: pdev pointer
2399  */
2400 qdf_freq_t wlan_reg_get_thresh_priority_freq(struct wlan_objmgr_pdev *pdev);
2401 
2402 /**
2403  * wlan_reg_psd_2_eirp() - Calculate EIRP from PSD and bandwidth
2404  * channel list
2405  * @pdev: pdev pointer
2406  * @psd: Power Spectral Density in dBm/MHz
2407  * @ch_bw: Bandwidth of a channel in MHz (20/40/80/160/320 etc)
2408  * @eirp:  EIRP power  in dBm
2409  *
2410  * Return: QDF_STATUS
2411  */
2412 QDF_STATUS wlan_reg_psd_2_eirp(struct wlan_objmgr_pdev *pdev,
2413 			       int16_t psd,
2414 			       uint16_t ch_bw,
2415 			       int16_t *eirp);
2416 
2417 /**
2418  * wlan_reg_eirp_2_psd() - Calculate PSD poewr from EIRP and bandwidth
2419  * @pdev: pdev pointer
2420  * @ch_bw: Bandwidth of a channel in MHz (20/40/80/160/320 etc)
2421  * @eirp:  EIRP power  in dBm
2422  * @psd: Power Spectral Density in dBm/MHz
2423  *
2424  * Return: QDF_STATUS
2425  */
2426 QDF_STATUS wlan_reg_eirp_2_psd(struct wlan_objmgr_pdev *pdev,
2427 			       uint16_t ch_bw,
2428 			       int16_t eirp,
2429 			       int16_t *psd);
2430 
2431 /**
2432  * wlan_reg_get_best_pwr_mode() - Get the best power mode based on input freq
2433  * and bandwidth. The mode that provides the best EIRP is the best power mode.
2434  * @pdev: Pointer to pdev
2435  * @freq: Frequency in MHz
2436  * @cen320: 320 MHz band center frequency. For other BW, this param is
2437  * ignored while processing
2438  * @bw: Bandwidth in MHz
2439  *
2440  * Return: Best power mode
2441  */
2442 enum reg_6g_ap_type
2443 wlan_reg_get_best_pwr_mode(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq,
2444 			   qdf_freq_t cen320, uint16_t bw);
2445 
2446 /**
2447  * wlan_reg_get_eirp_pwr() - Get eirp power based on the AP power mode
2448  * @pdev: Pointer to pdev
2449  * @freq: Frequency in MHz
2450  * @cen320: 320 MHz Band center frequency
2451  * @bw: Bandwidth in MHz
2452  * @ap_pwr_type: AP power type
2453  *
2454  * Return: EIRP power
2455  */
2456 uint8_t wlan_reg_get_eirp_pwr(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq,
2457 			      qdf_freq_t cen320, uint16_t bw,
2458 			      enum reg_6g_ap_type ap_pwr_type);
2459 #else
2460 static inline
2461 qdf_freq_t wlan_reg_get_thresh_priority_freq(struct wlan_objmgr_pdev *pdev)
2462 {
2463 	return 0;
2464 }
2465 
2466 static inline enum reg_6g_ap_type
2467 wlan_reg_get_best_pwr_mode(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq,
2468 			   qdf_freq_t cen320,
2469 			   uint16_t bw)
2470 {
2471 	return REG_MAX_AP_TYPE;
2472 }
2473 
2474 static inline QDF_STATUS wlan_reg_psd_2_eirp(struct wlan_objmgr_pdev *pdev,
2475 					     int16_t psd,
2476 					     uint16_t ch_bw,
2477 					     int16_t *eirp)
2478 {
2479 	return QDF_STATUS_E_FAILURE;
2480 }
2481 
2482 static inline QDF_STATUS wlan_reg_eirp_2_psd(struct wlan_objmgr_pdev *pdev,
2483 					     uint16_t ch_bw,
2484 					     int16_t eirp,
2485 					     int16_t *psd)
2486 {
2487 	return QDF_STATUS_E_FAILURE;
2488 }
2489 
2490 static inline uint8_t wlan_reg_get_eirp_pwr(struct wlan_objmgr_pdev *pdev,
2491 					    qdf_freq_t freq,
2492 					    qdf_freq_t cen320, uint16_t bw,
2493 					    enum reg_6g_ap_type ap_pwr_type)
2494 {
2495 	return 0;
2496 }
2497 #endif /* CONFIG_BAND_6GHZ */
2498 /**
2499  * wlan_reg_find_chwidth_from_bw () - Gets channel width for given
2500  * bandwidth
2501  * @bw: Bandwidth
2502  *
2503  * Return: phy_ch_width
2504  */
2505 enum phy_ch_width wlan_reg_find_chwidth_from_bw(uint16_t bw);
2506 
2507 /**
2508  * wlan_reg_get_chan_state_for_320() - Get the channel state of a 320 MHz
2509  * bonded channel.
2510  * @pdev: Pointer to wlan_objmgr_pdev
2511  * @freq: Primary frequency
2512  * @center_320: Band center of 320 MHz
2513  * @ch_width: Channel width
2514  * @bonded_chan_ptr_ptr: Pointer to bonded channel pointer
2515  * @treat_nol_chan_as_disabled: Bool to treat nol chan as enabled/disabled
2516  * @in_pwr_type: Input 6g power type
2517  *
2518  * Return: Channel state
2519  */
2520 #ifdef WLAN_FEATURE_11BE
2521 enum channel_state
2522 wlan_reg_get_chan_state_for_320(struct wlan_objmgr_pdev *pdev,
2523 				uint16_t freq,
2524 				qdf_freq_t center_320,
2525 				enum phy_ch_width ch_width,
2526 				const struct bonded_channel_freq
2527 				**bonded_chan_ptr_ptr,
2528 				enum supported_6g_pwr_types in_6g_pwr_type,
2529 				bool treat_nol_chan_as_disabled);
2530 #else
2531 static inline enum channel_state
2532 wlan_reg_get_chan_state_for_320(struct wlan_objmgr_pdev *pdev,
2533 				uint16_t freq,
2534 				qdf_freq_t center_320,
2535 				enum phy_ch_width ch_width,
2536 				const struct bonded_channel_freq
2537 				**bonded_chan_ptr_ptr,
2538 				enum supported_6g_pwr_types in_6g_pwr_type,
2539 				bool treat_nol_chan_as_disabled)
2540 {
2541 	return CHANNEL_STATE_INVALID;
2542 }
2543 #endif
2544 
2545 /**
2546  * wlan_is_sup_chan_entry_afc_done() - Checks if the super chan entry of given
2547  * channel idx and power mode has REGULATORY_CHAN_AFC_NOT_DONE flag cleared.
2548  *
2549  * @pdev: pdev pointer
2550  * @freq: input channel idx
2551  * @in_6g_pwr_mode: input power mode
2552  *
2553  * Return: True if REGULATORY_CHAN_AFC_NOT_DONE flag is clear for the super
2554  * chan entry.
2555  */
2556 #ifdef CONFIG_BAND_6GHZ
2557 bool
2558 wlan_is_sup_chan_entry_afc_done(struct wlan_objmgr_pdev *pdev,
2559 				enum channel_enum chan_idx,
2560 				enum supported_6g_pwr_types in_6g_pwr_mode);
2561 
2562 /**
2563  * wlan_reg_display_super_chan_list() - Display super channel list for all modes
2564  * @pdev: Pointer to pdev
2565  *
2566  * Return: QDF_STATUS
2567  */
2568 QDF_STATUS
2569 wlan_reg_display_super_chan_list(struct wlan_objmgr_pdev *pdev);
2570 #else
2571 static inline bool
2572 wlan_is_sup_chan_entry_afc_done(struct wlan_objmgr_pdev *pdev,
2573 				enum channel_enum chan_idx,
2574 				enum supported_6g_pwr_types in_6g_pwr_mode)
2575 {
2576 	return false;
2577 }
2578 
2579 static inline QDF_STATUS
2580 wlan_reg_display_super_chan_list(struct wlan_objmgr_pdev *pdev)
2581 {
2582 	return QDF_STATUS_E_NOSUPPORT;
2583 }
2584 #endif
2585 #endif
2586