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 * 6 * Permission to use, copy, modify, and/or distribute this software for 7 * any purpose with or without fee is hereby granted, provided that the 8 * above copyright notice and this permission notice appear in all 9 * copies. 10 * 11 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL 12 * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED 13 * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE 14 * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL 15 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR 16 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER 17 * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR 18 * PERFORMANCE OF THIS SOFTWARE. 19 */ 20 21 /** 22 * DOC: reg_services.h 23 * This file provides prototypes of the regulatory component 24 * service functions 25 */ 26 27 #ifndef __REG_SERVICES_COMMON_H_ 28 #define __REG_SERVICES_COMMON_H_ 29 30 #ifdef CONFIG_AFC_SUPPORT 31 #include <wlan_reg_afc.h> 32 #endif 33 34 #define IS_VALID_PSOC_REG_OBJ(psoc_priv_obj) (psoc_priv_obj) 35 #define IS_VALID_PDEV_REG_OBJ(pdev_priv_obj) (pdev_priv_obj) 36 #define FREQ_TO_CHAN_SCALE 5 37 /* The distance between the 80Mhz center and the nearest 20Mhz channel */ 38 #define NEAREST_20MHZ_CHAN_FREQ_OFFSET 10 39 #define NUM_20_MHZ_CHAN_IN_40_MHZ_CHAN 2 40 #define NUM_20_MHZ_CHAN_IN_80_MHZ_CHAN 4 41 #define NUM_20_MHZ_CHAN_IN_160_MHZ_CHAN 8 42 #define NUM_20_MHZ_CHAN_IN_320_MHZ_CHAN 16 43 44 #define REG_MAX_5GHZ_CH_NUM channel_map[MAX_5GHZ_CHANNEL].chan_num 45 46 #define REG_MIN_24GHZ_CH_FREQ channel_map[MIN_24GHZ_CHANNEL].center_freq 47 #define REG_MAX_24GHZ_CH_FREQ channel_map[MAX_24GHZ_CHANNEL].center_freq 48 49 #define REG_IS_24GHZ_CH_FREQ(freq) \ 50 (((freq) >= REG_MIN_24GHZ_CH_FREQ) && \ 51 ((freq) <= REG_MAX_24GHZ_CH_FREQ)) 52 53 #ifdef CONFIG_CHAN_FREQ_API 54 #define REG_MIN_5GHZ_CH_FREQ channel_map[MIN_5GHZ_CHANNEL].center_freq 55 #define REG_MAX_5GHZ_CH_FREQ channel_map[MAX_5GHZ_CHANNEL].center_freq 56 #endif /* CONFIG_CHAN_FREQ_API */ 57 58 #ifdef CONFIG_49GHZ_CHAN 59 #define REG_MIN_49GHZ_CH_FREQ channel_map[MIN_49GHZ_CHANNEL].center_freq 60 #define REG_MAX_49GHZ_CH_FREQ channel_map[MAX_49GHZ_CHANNEL].center_freq 61 #else 62 #define REG_MIN_49GHZ_CH_FREQ 0 63 #define REG_MAX_49GHZ_CH_FREQ 0 64 #endif /* CONFIG_49GHZ_CHAN */ 65 66 #define REG_IS_49GHZ_FREQ(freq) \ 67 (((freq) >= REG_MIN_49GHZ_CH_FREQ) && \ 68 ((freq) <= REG_MAX_49GHZ_CH_FREQ)) 69 70 71 #define REG_IS_5GHZ_FREQ(freq) \ 72 (((freq) >= channel_map[MIN_5GHZ_CHANNEL].center_freq) && \ 73 ((freq) <= channel_map[MAX_5GHZ_CHANNEL].center_freq)) 74 75 /* 76 * It should be 2.5 MHz actually but since we are using integer use 2 77 * instead, which does not create any problem in the start edge calculation. 78 */ 79 #define HALF_5MHZ_BW 2 80 #define HALF_20MHZ_BW 10 81 #define HALF_40MHZ_BW 20 82 #define HALF_80MHZ_BW 40 83 #define HALF_160MHZ_BW 80 84 85 #define TWO_GIG_STARTING_EDGE_FREQ (channel_map_global[MIN_24GHZ_CHANNEL]. \ 86 center_freq - HALF_20MHZ_BW) 87 #define TWO_GIG_ENDING_EDGE_FREQ (channel_map_global[MAX_24GHZ_CHANNEL]. \ 88 center_freq + HALF_20MHZ_BW) 89 #ifdef CONFIG_49GHZ_CHAN 90 #define FIVE_GIG_STARTING_EDGE_FREQ (channel_map_global[MIN_49GHZ_CHANNEL]. \ 91 center_freq - HALF_5MHZ_BW) 92 #else 93 #define FIVE_GIG_STARTING_EDGE_FREQ (channel_map_global[MIN_5GHZ_CHANNEL]. \ 94 center_freq - HALF_20MHZ_BW) 95 #endif /* CONFIG_49GHZ_CHAN */ 96 #define FIVE_GIG_ENDING_EDGE_FREQ (channel_map_global[MAX_5GHZ_CHANNEL]. \ 97 center_freq + HALF_20MHZ_BW) 98 99 #ifdef CONFIG_BAND_6GHZ 100 #define SIX_GIG_STARTING_EDGE_FREQ (channel_map_global[MIN_6GHZ_CHANNEL]. \ 101 center_freq - HALF_20MHZ_BW) 102 #define SIX_GIG_ENDING_EDGE_FREQ (channel_map_global[MAX_6GHZ_CHANNEL]. \ 103 center_freq + HALF_20MHZ_BW) 104 #define SIXG_START_FREQ 5950 105 #define FREQ_LEFT_SHIFT 55 106 #define SIX_GHZ_NON_ORPHAN_START_FREQ \ 107 (channel_map_global[MIN_6GHZ_NON_ORPHAN_CHANNEL].center_freq - 5) 108 #define CHAN_FREQ_5935 5935 109 #define NUM_80MHZ_BAND_IN_6G 16 110 #define NUM_PSC_FREQ 15 111 #define PSC_BAND_MHZ (FREQ_TO_CHAN_SCALE * NUM_80MHZ_BAND_IN_6G) 112 #define REG_MIN_6GHZ_CHAN_FREQ channel_map[MIN_6GHZ_CHANNEL].center_freq 113 #define REG_MAX_6GHZ_CHAN_FREQ channel_map[MAX_6GHZ_CHANNEL].center_freq 114 #else 115 #define FREQ_LEFT_SHIFT 0 116 #define SIX_GHZ_NON_ORPHAN_START_FREQ 0 117 #define CHAN_FREQ_5935 0 118 #define NUM_80MHZ_BAND_IN_6G 0 119 #define NUM_PSC_FREQ 0 120 #define PSC_BAND_MHZ (FREQ_TO_CHAN_SCALE * NUM_80MHZ_BAND_IN_6G) 121 #define REG_MIN_6GHZ_CHAN_FREQ 0 122 #define REG_MAX_6GHZ_CHAN_FREQ 0 123 #endif /*CONFIG_BAND_6GHZ*/ 124 125 #define REG_CH_NUM(ch_enum) channel_map[ch_enum].chan_num 126 #define REG_CH_TO_FREQ(ch_enum) channel_map[ch_enum].center_freq 127 128 /* EEPROM setting is a country code */ 129 #define COUNTRY_ERD_FLAG 0x8000 130 #define MIN_6GHZ_OPER_CLASS 131 131 #define MAX_6GHZ_OPER_CLASS 137 132 133 #ifdef CONFIG_AFC_SUPPORT 134 #define DEFAULT_REQ_ID 11235813 135 /* default minimum power in dBm units */ 136 #define DEFAULT_MIN_POWER (-10) 137 #define DEFAULT_NUM_FREQS 1 138 139 /* Have the entire 6Ghz band as single range */ 140 #define DEFAULT_LOW_6GFREQ 5925 141 #define DEFAULT_HIGH_6GFREQ 7125 142 #endif 143 144 #define SIXG_CHAN_2 2 145 #ifdef CONFIG_BAND_6GHZ 146 #define CHAN_ENUM_SIXG_2 CHAN_ENUM_5935 147 #else 148 #define CHAN_ENUM_SIXG_2 INVALID_CHANNEL 149 #endif 150 151 /* The eirp power values are in 0.01dBm units */ 152 #define EIRP_PWR_SCALE 100 153 154 extern const struct chan_map *channel_map; 155 extern const struct chan_map channel_map_us[]; 156 extern const struct chan_map channel_map_eu[]; 157 extern const struct chan_map channel_map_jp[]; 158 extern const struct chan_map channel_map_china[]; 159 extern const struct chan_map channel_map_global[]; 160 161 #ifdef WLAN_FEATURE_11BE 162 #define ALL_SCHANS_PUNC 0xFFFF /* all subchannels punctured */ 163 #endif 164 165 #define CHAN_FREQ_5660 5660 166 #define CHAN_FREQ_5720 5720 167 168 #define PRIM_SEG_IEEE_CENTER_240MHZ_5G_CHAN 146 169 #define PRIM_SEG_FREQ_CENTER_240MHZ_5G_CHAN 5730 170 171 #ifdef CONFIG_AFC_SUPPORT 172 /** 173 * struct afc_cb_handler - defines structure for afc request received event 174 * handler call back function and argument 175 * @func: handler function pointer 176 * @arg: argument to handler function 177 */ 178 struct afc_cb_handler { 179 afc_req_rx_evt_handler func; 180 void *arg; 181 }; 182 183 /** 184 * struct afc_pow_evt_cb_handler - defines structure for afc power received 185 * event handler call back function and argument 186 * @func: handler function pointer 187 * @arg: argument to handler function 188 */ 189 struct afc_pow_evt_cb_handler { 190 afc_power_tx_evt_handler func; 191 void *arg; 192 }; 193 194 /** 195 * reg_init_freq_range() - Initialize a freq_range object 196 * @left: The left frequency range 197 * @right: The right frequency range 198 * 199 * Return: The initialized freq_range object 200 */ 201 struct freq_range 202 reg_init_freq_range(qdf_freq_t left, qdf_freq_t right); 203 #endif 204 /** 205 * get_next_lower_bandwidth() - Get next lower bandwidth 206 * @ch_width: Channel width 207 * 208 * Return: Channel width 209 */ 210 enum phy_ch_width get_next_lower_bandwidth(enum phy_ch_width ch_width); 211 212 /** 213 * reg_read_default_country() - Get the default regulatory country 214 * @psoc: The physical SoC to get default country from 215 * @country_code: the buffer to populate the country code into 216 * 217 * Return: QDF_STATUS 218 */ 219 QDF_STATUS reg_read_default_country(struct wlan_objmgr_psoc *psoc, 220 uint8_t *country_code); 221 222 /** 223 * reg_get_ctry_idx_max_bw_from_country_code() - Get the max 5G bandwidth 224 * from country code 225 * @pdev: Pointer to pdev 226 * @cc: Country Code 227 * @max_bw_5g: Max 5G bandwidth supported by the country 228 * 229 * Return: QDF_STATUS 230 */ 231 232 QDF_STATUS reg_get_max_5g_bw_from_country_code(struct wlan_objmgr_pdev *pdev, 233 uint16_t cc, 234 uint16_t *max_bw_5g); 235 236 /** 237 * reg_get_max_5g_bw_from_regdomain() - Get the max 5G bandwidth 238 * supported by the regdomain 239 * @pdev: Pointer to pdev 240 * @orig_regdmn: Regdomain pair value 241 * @max_bw_5g: Max 5G bandwidth supported by the country 242 * 243 * Return: QDF_STATUS 244 */ 245 246 QDF_STATUS reg_get_max_5g_bw_from_regdomain(struct wlan_objmgr_pdev *pdev, 247 uint16_t regdmn, 248 uint16_t *max_bw_5g); 249 250 /** 251 * reg_get_current_dfs_region () - Get the current dfs region 252 * @pdev: Pointer to pdev 253 * @dfs_reg: pointer to dfs region 254 * 255 * Return: None 256 */ 257 void reg_get_current_dfs_region(struct wlan_objmgr_pdev *pdev, 258 enum dfs_reg *dfs_reg); 259 260 /** 261 * reg_get_bw_value() - give bandwidth value 262 * bw: bandwidth enum 263 * 264 * Return: uint16_t 265 */ 266 uint16_t reg_get_bw_value(enum phy_ch_width bw); 267 268 /** 269 * reg_set_dfs_region () - Set the current dfs region 270 * @pdev: Pointer to pdev 271 * @dfs_reg: pointer to dfs region 272 * 273 * Return: None 274 */ 275 void reg_set_dfs_region(struct wlan_objmgr_pdev *pdev, 276 enum dfs_reg dfs_reg); 277 278 /** 279 * reg_program_chan_list() - Set user country code and populate the channel list 280 * @pdev: Pointer to pdev 281 * @rd: Pointer to cc_regdmn_s structure 282 * 283 * Return: QDF_STATUS 284 */ 285 QDF_STATUS reg_program_chan_list(struct wlan_objmgr_pdev *pdev, 286 struct cc_regdmn_s *rd); 287 288 /** 289 * reg_freq_to_chan() - Get channel number from frequency. 290 * @pdev: Pointer to pdev 291 * @freq: Channel frequency 292 * 293 * Return: Channel number if success, otherwise 0 294 */ 295 uint8_t reg_freq_to_chan(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 296 297 /** 298 * reg_legacy_chan_to_freq() - Get freq from chan noumber, for 2G and 5G 299 * @pdev: Pointer to pdev 300 * @chan_num: Channel number 301 * 302 * Return: Channel frequency if success, otherwise 0 303 */ 304 uint16_t reg_legacy_chan_to_freq(struct wlan_objmgr_pdev *pdev, 305 uint8_t chan_num); 306 307 /** 308 * reg_get_current_cc() - Get current country code 309 * @pdev: Pdev pointer 310 * @regdmn: Pointer to get current country values 311 * 312 * Return: QDF_STATUS 313 */ 314 QDF_STATUS reg_get_current_cc(struct wlan_objmgr_pdev *pdev, 315 struct cc_regdmn_s *rd); 316 317 /** 318 * reg_set_regdb_offloaded() - set/clear regulatory offloaded flag 319 * 320 * @psoc: psoc pointer 321 * Return: Success or Failure 322 */ 323 QDF_STATUS reg_set_regdb_offloaded(struct wlan_objmgr_psoc *psoc, bool val); 324 325 /** 326 * reg_get_curr_regdomain() - Get current regdomain in use 327 * @pdev: pdev pointer 328 * @cur_regdmn: Current regdomain info 329 * 330 * Return: QDF status 331 */ 332 QDF_STATUS reg_get_curr_regdomain(struct wlan_objmgr_pdev *pdev, 333 struct cur_regdmn_info *cur_regdmn); 334 335 /** 336 * reg_modify_chan_144() - Enable/Disable channel 144 337 * @pdev: pdev pointer 338 * @en_chan_144: flag to disable/enable channel 144 339 * 340 * Return: Success or Failure 341 */ 342 QDF_STATUS reg_modify_chan_144(struct wlan_objmgr_pdev *pdev, bool en_chan_144); 343 344 /** 345 * reg_get_en_chan_144() - get en_chan_144 flag value 346 * @pdev: pdev pointer 347 * 348 * Return: en_chan_144 flag value 349 */ 350 bool reg_get_en_chan_144(struct wlan_objmgr_pdev *pdev); 351 352 /** 353 * reg_get_hal_reg_cap() - Get HAL REG capabilities 354 * @psoc: psoc for country information 355 * 356 * Return: hal reg cap pointer 357 */ 358 struct wlan_psoc_host_hal_reg_capabilities_ext *reg_get_hal_reg_cap( 359 struct wlan_objmgr_psoc *psoc); 360 361 /** 362 * reg_set_hal_reg_cap() - Set HAL REG capabilities 363 * @psoc: psoc for country information 364 * @reg_cap: Regulatory caps pointer 365 * @phy_cnt: number of phy 366 * 367 * Return: hal reg cap pointer 368 */ 369 QDF_STATUS reg_set_hal_reg_cap( 370 struct wlan_objmgr_psoc *psoc, 371 struct wlan_psoc_host_hal_reg_capabilities_ext *reg_cap, 372 uint16_t phy_cnt); 373 374 /** 375 * reg_update_hal_reg_cap() - Update HAL REG capabilities 376 * @psoc: psoc pointer 377 * @wireless_modes: 11AX wireless modes 378 * @phy_id: phy id 379 * 380 * Return: QDF_STATUS 381 */ 382 QDF_STATUS reg_update_hal_reg_cap(struct wlan_objmgr_psoc *psoc, 383 uint64_t wireless_modes, uint8_t phy_id); 384 385 /** 386 * reg_chan_in_range() - Check if the given channel is in pdev's channel range 387 * @chan_list: Pointer to regulatory channel list. 388 * @low_freq_2g: Low frequency 2G. 389 * @high_freq_2g: High frequency 2G. 390 * @low_freq_5g: Low frequency 5G. 391 * @high_freq_5g: High frequency 5G. 392 * @ch_enum: Channel enum. 393 * 394 * Return: true if ch_enum is with in pdev's channel range, else false. 395 */ 396 bool reg_chan_in_range(struct regulatory_channel *chan_list, 397 qdf_freq_t low_freq_2g, qdf_freq_t high_freq_2g, 398 qdf_freq_t low_freq_5g, qdf_freq_t high_freq_5g, 399 enum channel_enum ch_enum); 400 401 /** 402 * reg_init_channel_map() - Initialize the channel list based on the dfs region. 403 * @dfs_region: Dfs region 404 */ 405 void reg_init_channel_map(enum dfs_reg dfs_region); 406 407 /** 408 * reg_get_psoc_tx_ops() - Get regdb tx ops 409 * @psoc: Pointer to psoc structure 410 */ 411 struct wlan_lmac_if_reg_tx_ops *reg_get_psoc_tx_ops( 412 struct wlan_objmgr_psoc *psoc); 413 414 /** 415 * reg_is_24ghz_ch_freq() - Check if the given channel frequency is 2.4GHz 416 * @freq: Channel frequency 417 * 418 * Return: true if channel frequency is 2.4GHz, else false 419 */ 420 bool reg_is_24ghz_ch_freq(uint32_t freq); 421 422 /** 423 * reg_is_5ghz_ch_freq() - Check if the given channel frequency is 5GHz 424 * @freq: Channel frequency 425 * 426 * Return: true if channel frequency is 5GHz, else false 427 */ 428 bool reg_is_5ghz_ch_freq(uint32_t freq); 429 430 /** 431 * reg_is_range_overlap_2g() - Check if the given low_freq and high_freq 432 * is in the 2G range. 433 * 434 * @low_freq - Low frequency. 435 * @high_freq - High frequency. 436 * 437 * Return: Return true if given low_freq and high_freq overlaps 2G range, 438 * else false. 439 */ 440 bool reg_is_range_overlap_2g(qdf_freq_t low_freq, qdf_freq_t high_freq); 441 442 /** 443 * reg_is_range_overlap_5g() - Check if the given low_freq and high_freq 444 * is in the 5G range. 445 * 446 * @low_freq - Low frequency. 447 * @high_freq - High frequency. 448 * 449 * Return: Return true if given low_freq and high_freq overlaps 5G range, 450 * else false. 451 */ 452 bool reg_is_range_overlap_5g(qdf_freq_t low_freq, qdf_freq_t high_freq); 453 454 /** 455 * reg_is_freq_indoor() - Check if the input frequency is an indoor frequency. 456 * @pdev: Pointer to pdev. 457 * @freq: Channel frequency. 458 * 459 * Return: Return true if the input frequency is indoor, else false. 460 */ 461 bool reg_is_freq_indoor(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 462 463 /** 464 * reg_get_min_chwidth() - Return min chanwidth supported by freq. 465 * @pdev: Pointer to pdev. 466 * @freq: Channel frequency. 467 * 468 * Return: Min chwidth supported by freq as per regulatory DB. 469 */ 470 uint16_t reg_get_min_chwidth(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 471 472 /** 473 * reg_get_max_chwidth() - Return max chanwidth supported by freq. 474 * @pdev: Pointer to pdev. 475 * @freq: Channel frequency. 476 * 477 * Return: Max chwidth supported by freq as per regulatory DB. 478 */ 479 uint16_t reg_get_max_chwidth(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 480 481 #ifdef CONFIG_REG_CLIENT 482 /** 483 * reg_is_freq_indoor_in_secondary_list() - Check if the input frequency is 484 * an indoor frequency in the secondary channel list 485 * @pdev: Pointer to pdev. 486 * @freq: Channel frequency. 487 * 488 * Return: Return true if the input frequency is indoor, else false. 489 */ 490 bool reg_is_freq_indoor_in_secondary_list(struct wlan_objmgr_pdev *pdev, 491 qdf_freq_t freq); 492 #endif 493 494 #ifdef CONFIG_BAND_6GHZ 495 /** 496 * reg_is_6ghz_chan_freq() - Check if the given channel frequency is 6GHz 497 * @freq: Channel frequency 498 * 499 * Return: true if channel frequency is 6GHz, else false 500 */ 501 bool reg_is_6ghz_chan_freq(uint16_t freq); 502 503 #ifdef CONFIG_6G_FREQ_OVERLAP 504 /** 505 * reg_is_range_only6g() - Check if the given low_freq and high_freq is only in 506 * the 6G range. 507 * 508 * @low_freq - Low frequency. 509 * @high_freq - High frequency. 510 * 511 * Return: Return true if given low_freq and high_freq overlaps only the 6G 512 * range, else false. 513 */ 514 bool reg_is_range_only6g(qdf_freq_t low_freq, qdf_freq_t high_freq); 515 516 /** 517 * reg_is_range_overlap_6g() - Check if the given low_freq and high_freq 518 * is in the 6G range. 519 * 520 * @low_freq - Low frequency. 521 * @high_freq - High frequency. 522 * 523 * Return: Return true if given low_freq and high_freq overlaps 6G range, 524 * else false. 525 */ 526 bool reg_is_range_overlap_6g(qdf_freq_t low_freq, qdf_freq_t high_freq); 527 #endif 528 529 /** 530 * REG_IS_6GHZ_FREQ() - Check if the given channel frequency is 6GHz 531 * @freq: Channel frequency 532 * 533 * Return: true if channel frequency is 6GHz, else false 534 */ 535 static inline bool REG_IS_6GHZ_FREQ(uint16_t freq) 536 { 537 return ((freq >= REG_MIN_6GHZ_CHAN_FREQ) && 538 (freq <= REG_MAX_6GHZ_CHAN_FREQ)); 539 } 540 541 /** 542 * reg_is_6ghz_psc_chan_freq() - Check if the given 6GHz channel frequency is 543 * preferred scanning channel frequency. 544 * @freq: Channel frequency 545 * 546 * Return: true if given 6GHz channel frequency is preferred scanning channel 547 * frequency, else false 548 */ 549 bool reg_is_6ghz_psc_chan_freq(uint16_t freq); 550 551 /** 552 * reg_is_6g_freq_indoor() - Check if a 6GHz frequency is indoor. 553 * @pdev: Pointer to pdev. 554 * @freq: Channel frequency. 555 * 556 * Return: Return true if a 6GHz frequency is indoor, else false. 557 */ 558 bool reg_is_6g_freq_indoor(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 559 560 /** 561 * reg_get_max_txpower_for_6g_tpe() - Get max txpower for 6G TPE IE. 562 * @pdev: Pointer to pdev. 563 * @freq: Channel frequency. 564 * @bw: Channel bandwidth. 565 * @reg_ap: Regulatory 6G AP type. 566 * @reg_client: Regulatory 6G client type. 567 * @is_psd: True if txpower is needed in PSD format, and false if needed in EIRP 568 * format. 569 * @tx_power: Pointer to tx-power. 570 * 571 * Return: Return QDF_STATUS_SUCCESS, if tx_power is filled for 6G TPE IE 572 * else return QDF_STATUS_E_FAILURE. 573 */ 574 QDF_STATUS reg_get_max_txpower_for_6g_tpe(struct wlan_objmgr_pdev *pdev, 575 qdf_freq_t freq, uint8_t bw, 576 enum reg_6g_ap_type reg_ap, 577 enum reg_6g_client_type reg_client, 578 bool is_psd, 579 uint8_t *tx_power); 580 581 /** 582 * reg_min_6ghz_chan_freq() - Get minimum 6GHz channel center frequency 583 * 584 * Return: Minimum 6GHz channel center frequency 585 */ 586 uint16_t reg_min_6ghz_chan_freq(void); 587 588 /** 589 * reg_max_6ghz_chan_freq() - Get maximum 6GHz channel center frequency 590 * 591 * Return: Maximum 6GHz channel center frequency 592 */ 593 uint16_t reg_max_6ghz_chan_freq(void); 594 #else 595 static inline bool reg_is_6ghz_chan_freq(uint16_t freq) 596 { 597 return false; 598 } 599 600 static inline bool 601 reg_is_6g_freq_indoor(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq) 602 { 603 return false; 604 } 605 606 static inline QDF_STATUS 607 reg_get_max_txpower_for_6g_tpe(struct wlan_objmgr_pdev *pdev, 608 qdf_freq_t freq, uint8_t bw, 609 enum reg_6g_ap_type reg_ap, 610 enum reg_6g_client_type reg_client, 611 bool is_psd, 612 uint8_t *tx_power) 613 { 614 return QDF_STATUS_E_FAILURE; 615 } 616 617 #ifdef CONFIG_6G_FREQ_OVERLAP 618 static inline bool reg_is_range_overlap_6g(qdf_freq_t low_freq, 619 qdf_freq_t high_freq) 620 { 621 return false; 622 } 623 624 static inline bool reg_is_range_only6g(qdf_freq_t low_freq, 625 qdf_freq_t high_freq) 626 { 627 return false; 628 } 629 #endif 630 631 static inline bool REG_IS_6GHZ_FREQ(uint16_t freq) 632 { 633 return false; 634 } 635 636 static inline bool reg_is_6ghz_psc_chan_freq(uint16_t freq) 637 { 638 return false; 639 } 640 641 static inline uint16_t reg_min_6ghz_chan_freq(void) 642 { 643 return 0; 644 } 645 646 static inline uint16_t reg_max_6ghz_chan_freq(void) 647 { 648 return 0; 649 } 650 #endif /* CONFIG_BAND_6GHZ */ 651 652 /** 653 * reg_get_band_channel_list() - Caller function to 654 * reg_get_band_from_cur_chan_list with primary current channel list 655 * @pdev: pdev ptr 656 * @band_mask: Input bitmap with band set 657 * @channel_list: Pointer to Channel List 658 * 659 * Caller function to reg_get_band_from_cur_chan_listto get the primary channel 660 * list and number of channels (for non-beaconing entities). 661 * 662 * Return: Number of channels, else 0 to indicate error 663 */ 664 uint16_t reg_get_band_channel_list(struct wlan_objmgr_pdev *pdev, 665 uint8_t band_mask, 666 struct regulatory_channel *channel_list); 667 668 #ifdef CONFIG_REG_6G_PWRMODE 669 /** 670 * reg_get_band_channel_list() - Caller function to 671 * reg_get_band_from_cur_chan_list with primary current channel list 672 * @pdev: pdev ptr 673 * @band_mask: Input bitmap with band set 674 * @channel_list: Pointer to Channel List 675 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 676 * 677 * Caller function to reg_get_band_from_cur_chan_listto get the primary channel 678 * list and number of channels (for non-beaconing entities). 679 * 680 * Return: Number of channels, else 0 to indicate error 681 */ 682 uint16_t reg_get_band_channel_list_for_pwrmode(struct wlan_objmgr_pdev *pdev, 683 uint8_t band_mask, 684 struct regulatory_channel 685 *channel_list, 686 enum supported_6g_pwr_types 687 in_6g_pwr_type); 688 #endif 689 690 #ifdef CONFIG_REG_CLIENT 691 /** 692 * reg_get_secondary_band_channel_list() - Caller function to 693 * reg_get_band_from_cur_chan_list with secondary current channel list 694 * @pdev: pdev ptr 695 * @band_mask: Input bitmap with band set 696 * @channel_list: Pointer to Channel List 697 * 698 * Caller function to reg_get_band_from_cur_chan_list to get the secondary 699 * channel list and number of channels (for beaconing entities). 700 * 701 * Return: Number of channels, else 0 to indicate error 702 */ 703 uint16_t reg_get_secondary_band_channel_list(struct wlan_objmgr_pdev *pdev, 704 uint8_t band_mask, 705 struct regulatory_channel 706 *channel_list); 707 #endif 708 709 /** 710 * reg_chan_band_to_freq - Return channel frequency based on the channel number 711 * and band. 712 * @pdev: pdev ptr 713 * @chan: Channel Number 714 * @band_mask: Bitmap for bands 715 * 716 * Return: Return channel frequency or return 0, if the channel is disabled or 717 * if the input channel number or band_mask is invalid. Composite bands are 718 * supported only for 2.4Ghz and 5Ghz bands. For other bands the following 719 * priority is given: 1) 6Ghz 2) 5Ghz 3) 2.4Ghz. 720 */ 721 qdf_freq_t reg_chan_band_to_freq(struct wlan_objmgr_pdev *pdev, 722 uint8_t chan, 723 uint8_t band_mask); 724 725 /** 726 * reg_is_49ghz_freq() - Check if the given channel frequency is 4.9GHz 727 * @freq: Channel frequency 728 * 729 * Return: true if channel frequency is 4.9GHz, else false 730 */ 731 bool reg_is_49ghz_freq(qdf_freq_t freq); 732 733 /** 734 * reg_ch_num() - Get channel number from channel enum 735 * @ch_enum: Channel enum 736 * 737 * Return: channel number 738 */ 739 qdf_freq_t reg_ch_num(uint32_t ch_enum); 740 741 /** 742 * reg_ch_to_freq() - Get channel frequency from channel enum 743 * @ch_enum: Channel enum 744 * 745 * Return: channel frequency 746 */ 747 qdf_freq_t reg_ch_to_freq(uint32_t ch_enum); 748 749 /** 750 * reg_max_5ghz_ch_num() - Get maximum 5GHz channel number 751 * 752 * Return: Maximum 5GHz channel number 753 */ 754 uint8_t reg_max_5ghz_ch_num(void); 755 756 #ifdef CONFIG_CHAN_FREQ_API 757 /** 758 * reg_min_24ghz_chan_freq() - Get minimum 2.4GHz channel frequency 759 * 760 * Return: Minimum 2.4GHz channel frequency 761 */ 762 qdf_freq_t reg_min_24ghz_chan_freq(void); 763 764 /** 765 * reg_max_24ghz_chan_freq() - Get maximum 2.4GHz channel frequency 766 * 767 * Return: Maximum 2.4GHz channel frequency 768 */ 769 qdf_freq_t reg_max_24ghz_chan_freq(void); 770 771 /** 772 * reg_min_5ghz_chan_freq() - Get minimum 5GHz channel frequency 773 * 774 * Return: Minimum 5GHz channel frequency 775 */ 776 qdf_freq_t reg_min_5ghz_chan_freq(void); 777 778 /** 779 * reg_max_5ghz_chan_freq() - Get maximum 5GHz channel frequency 780 * 781 * Return: Maximum 5GHz channel frequency 782 */ 783 qdf_freq_t reg_max_5ghz_chan_freq(void); 784 #endif /* CONFIG_CHAN_FREQ_API */ 785 786 /** 787 * reg_enable_dfs_channels() - Enable the use of DFS channels 788 * @pdev: The physical dev to enable/disable DFS channels for 789 * 790 * Return: QDF_STATUS 791 */ 792 QDF_STATUS reg_enable_dfs_channels(struct wlan_objmgr_pdev *pdev, bool enable); 793 794 #ifdef WLAN_REG_PARTIAL_OFFLOAD 795 /** 796 * reg_program_default_cc() - Program default country code 797 * @pdev: Pdev pointer 798 * @regdmn: Regdomain value 799 * 800 * Return: QDF_STATUS 801 */ 802 QDF_STATUS reg_program_default_cc(struct wlan_objmgr_pdev *pdev, 803 uint16_t regdmn); 804 805 /** 806 * reg_is_regdmn_en302502_applicable() - Find if ETSI EN302_502 radar pattern 807 * is applicable in current regulatory domain. 808 * @pdev: Pdev object pointer. 809 * 810 * Return: True if en302_502 is applicable, else false. 811 */ 812 bool reg_is_regdmn_en302502_applicable(struct wlan_objmgr_pdev *pdev); 813 #endif 814 815 /** 816 * reg_update_channel_ranges() - Update the channel ranges with the new 817 * phy capabilities. 818 * @pdev: The physical dev for which channel ranges are to be updated. 819 * 820 * Return: QDF_STATUS. 821 */ 822 QDF_STATUS reg_update_channel_ranges(struct wlan_objmgr_pdev *pdev); 823 824 /** 825 * reg_modify_pdev_chan_range() - Compute current channel list 826 * in accordance with the modified reg caps. 827 * @pdev: The physical dev for which channel list must be built. 828 * 829 * Return: QDF_STATUS 830 */ 831 QDF_STATUS reg_modify_pdev_chan_range(struct wlan_objmgr_pdev *pdev); 832 833 /** 834 * reg_update_pdev_wireless_modes() - Update the wireless_modes in the 835 * pdev_priv_obj with the input wireless_modes 836 * @pdev: pointer to wlan_objmgr_pdev. 837 * @wireless_modes: Wireless modes. 838 * 839 * Return : QDF_STATUS 840 */ 841 QDF_STATUS reg_update_pdev_wireless_modes(struct wlan_objmgr_pdev *pdev, 842 uint64_t wireless_modes); 843 844 /** 845 * reg_get_phybitmap() - Get phybitmap from regulatory pdev_priv_obj 846 * @pdev: pdev pointer 847 * @phybitmap: pointer to phybitmap 848 * 849 * Return: QDF STATUS 850 */ 851 QDF_STATUS reg_get_phybitmap(struct wlan_objmgr_pdev *pdev, 852 uint16_t *phybitmap); 853 #ifdef DISABLE_UNII_SHARED_BANDS 854 /** 855 * reg_disable_chan_coex() - Disable Coexisting channels based on the input 856 * bitmask. 857 * @pdev: pointer to wlan_objmgr_pdev. 858 * unii_5g_bitmap: UNII 5G bitmap. 859 * 860 * Return : QDF_STATUS 861 */ 862 QDF_STATUS reg_disable_chan_coex(struct wlan_objmgr_pdev *pdev, 863 uint8_t unii_5g_bitmap); 864 #endif 865 866 #ifdef CONFIG_CHAN_FREQ_API 867 /** 868 * reg_is_freq_present_in_cur_chan_list() - Check the input frequency 869 * @pdev: Pointer to pdev 870 * @freq: Channel center frequency in MHz 871 * 872 * Check if the input channel center frequency is present in the current 873 * channel list 874 * 875 * Return: Return true if channel center frequency is present in the current 876 * channel list, else return false. 877 */ 878 bool 879 reg_is_freq_present_in_cur_chan_list(struct wlan_objmgr_pdev *pdev, 880 qdf_freq_t freq); 881 882 /** 883 * reg_get_chan_enum_for_freq() - Get channel enum for given channel frequency 884 * @freq: Channel Frequency 885 * 886 * Return: Channel enum 887 */ 888 enum channel_enum reg_get_chan_enum_for_freq(qdf_freq_t freq); 889 890 /** 891 * reg_get_channel_list_with_power_for_freq() - Provides the channel list with 892 * power 893 * @pdev: Pointer to pdev 894 * @ch_list: Pointer to the channel list. 895 * @num_chan: Pointer to save number of channels 896 * 897 * Return: QDF_STATUS 898 */ 899 QDF_STATUS 900 reg_get_channel_list_with_power_for_freq(struct wlan_objmgr_pdev *pdev, 901 struct channel_power *ch_list, 902 uint8_t *num_chan); 903 904 /** 905 * reg_get_channel_state_for_freq() - Get channel state from regulatory 906 * @pdev: Pointer to pdev 907 * @freq: channel center frequency. 908 * 909 * Return: channel state 910 */ 911 enum channel_state 912 reg_get_channel_state_for_freq(struct wlan_objmgr_pdev *pdev, 913 qdf_freq_t freq); 914 915 #ifdef CONFIG_REG_6G_PWRMODE 916 /** 917 * reg_get_channel_state_for_freq() - Get channel state from regulatory 918 * @pdev: Pointer to pdev 919 * @freq: channel center frequency. 920 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 921 * 922 * Return: channel state 923 */ 924 enum channel_state 925 reg_get_channel_state_for_pwrmode(struct wlan_objmgr_pdev *pdev, 926 qdf_freq_t freq, 927 enum supported_6g_pwr_types in_6g_pwr_type); 928 #endif 929 930 #ifdef CONFIG_REG_CLIENT 931 /** 932 * reg_get_channel_state_from_secondary_list_for_freq() - Get channel state 933 * from secondary regulatory current channel list 934 * @pdev: Pointer to pdev 935 * @freq: channel center frequency. 936 * 937 * Return: channel state 938 */ 939 enum channel_state reg_get_channel_state_from_secondary_list_for_freq( 940 struct wlan_objmgr_pdev *pdev, 941 qdf_freq_t freq); 942 943 /** 944 * reg_get_channel_list_with_power() - Provides the channel list with power 945 * @pdev: Pointer to pdev 946 * @ch_list: Pointer to the channel list. 947 * @num_chan: Pointer to save number of channels 948 * @in_6g_pwr_type: 6G power type corresponding to which 6G channel list is 949 * required 950 * 951 * Return: QDF_STATUS 952 */ 953 QDF_STATUS reg_get_channel_list_with_power( 954 struct wlan_objmgr_pdev *pdev, 955 struct channel_power *ch_list, 956 uint8_t *num_chan, 957 enum supported_6g_pwr_types in_6g_pwr_type); 958 #endif 959 960 /** 961 * reg_get_5g_bonded_channel_state_for_freq() - Get channel state for 962 * 5G bonded channel using the channel frequency 963 * @pdev: Pointer to pdev 964 * @freq: channel center frequency. 965 * @ch_params: channel parameters 966 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 967 * 968 * Return: channel state 969 */ 970 enum channel_state 971 reg_get_5g_bonded_channel_state_for_freq(struct wlan_objmgr_pdev *pdev, 972 qdf_freq_t freq, 973 struct ch_params *ch_params); 974 975 #ifdef CONFIG_REG_6G_PWRMODE 976 enum channel_state 977 reg_get_5g_bonded_channel_state_for_pwrmode(struct wlan_objmgr_pdev *pdev, 978 qdf_freq_t freq, 979 struct ch_params *ch_params, 980 enum supported_6g_pwr_types 981 in_6g_pwr_mode); 982 #endif 983 984 /** 985 * reg_get_2g_bonded_channel_state_for_freq() - Get channel state for 2G 986 * bonded channel 987 * @freq: channel center frequency. 988 * @pdev: Pointer to pdev 989 * @oper_ch_freq: Primary channel center frequency 990 * @sec_ch_freq: Secondary channel center frequency 991 * @bw: channel band width 992 * 993 * Return: channel state 994 */ 995 enum channel_state 996 reg_get_2g_bonded_channel_state_for_freq(struct wlan_objmgr_pdev *pdev, 997 qdf_freq_t oper_ch_freq, 998 qdf_freq_t sec_ch_freq, 999 enum phy_ch_width bw); 1000 1001 /** 1002 * reg_set_channel_params_for_freq () - Sets channel parameteres for given 1003 * bandwidth 1004 * @pdev: Pointer to pdev 1005 * @freq: Channel center frequency. 1006 * @sec_ch_2g_freq: Secondary 2G channel frequency 1007 * @ch_params: pointer to the channel parameters. 1008 * @treat_nol_chan_as_disabled: bool to treat nol channel as enabled or 1009 * disabled. If set to true, nol chan is considered as disabled in chan search. 1010 * 1011 * Return: None 1012 */ 1013 void reg_set_channel_params_for_freq(struct wlan_objmgr_pdev *pdev, 1014 qdf_freq_t freq, 1015 qdf_freq_t sec_ch_2g_freq, 1016 struct ch_params *ch_params, 1017 bool treat_nol_chan_as_disabled); 1018 1019 #ifdef CONFIG_REG_6G_PWRMODE 1020 /** 1021 * reg_set_channel_params_for_pwrmode () - Sets channel parameteres for given 1022 * bandwidth 1023 * @pdev: Pointer to pdev 1024 * @freq: Channel center frequency. 1025 * @sec_ch_2g_freq: Secondary 2G channel frequency 1026 * @ch_params: pointer to the channel parameters. 1027 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1028 * @treat_nol_chan_as_disabled: bool to treat nol channel as enabled or 1029 * disabled. If set to true, nol chan is considered as disabled in chan search. 1030 * 1031 * Return: None 1032 */ 1033 void reg_set_channel_params_for_pwrmode(struct wlan_objmgr_pdev *pdev, 1034 qdf_freq_t freq, 1035 qdf_freq_t sec_ch_2g_freq, 1036 struct ch_params *ch_params, 1037 enum supported_6g_pwr_types 1038 in_6g_pwr_mode, 1039 bool treat_nol_chan_as_disabled); 1040 #endif 1041 1042 #ifdef WLAN_FEATURE_11BE 1043 /** 1044 * reg_fill_channel_list() - Fills an array of ch_params (list of 1045 * channels) for the given channel width and primary freq. 1046 * If 320 band_center is given, ch_params corresponding to the 1047 * given band_center is filled. 1048 * 1049 * @pdev: Pointer to pdev 1050 * @freq: Center frequency of the primary channel in MHz 1051 * @sec_ch_2g_freq: Secondary 2G channel frequency in MHZ 1052 * @ch_width: Input channel width. 1053 * @band_center: Center frequency of the 320MHZ channel. 1054 * @chan_list: Pointer to struct reg_channel_list to be filled (Output). 1055 * The caller is supposed to provide enough storage for the elements 1056 * in the list. 1057 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1058 * @treat_nol_chan_as_disabled: bool to treat nol channel as enabled or 1059 * disabled. If set to true, nol chan is considered as disabled in chan search. 1060 * 1061 * Return: None 1062 */ 1063 void 1064 reg_fill_channel_list(struct wlan_objmgr_pdev *pdev, 1065 qdf_freq_t freq, 1066 qdf_freq_t sec_ch_2g_freq, 1067 enum phy_ch_width ch_width, 1068 qdf_freq_t band_center_320, 1069 struct reg_channel_list *chan_list, 1070 bool treat_nol_chan_as_disabled); 1071 1072 #ifdef CONFIG_REG_6G_PWRMODE 1073 /** 1074 * reg_fill_channel_list_for_pwrmode() - Fills an array of ch_params (list of 1075 * channels) for the given channel width and primary freq. 1076 * If 320 band_center is given, ch_params corresponding to the 1077 * given band_center is filled. 1078 * 1079 * @pdev: Pointer to pdev 1080 * @freq: Center frequency of the primary channel in MHz 1081 * @sec_ch_2g_freq: Secondary 2G channel frequency in MHZ 1082 * @ch_width: Input channel width. 1083 * @band_center: Center frequency of the 320MHZ channel. 1084 * @chan_list: Pointer to struct reg_channel_list to be filled (Output). 1085 * The caller is supposed to provide enough storage for the elements 1086 * in the list. 1087 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1088 * @treat_nol_chan_as_disabled: bool to treat nol channel as enabled or 1089 * disabled. If set to true, nol chan is considered as disabled in chan search. 1090 * 1091 * Return: None 1092 */ 1093 void 1094 reg_fill_channel_list_for_pwrmode(struct wlan_objmgr_pdev *pdev, 1095 qdf_freq_t freq, 1096 qdf_freq_t sec_ch_2g_freq, 1097 enum phy_ch_width ch_width, 1098 qdf_freq_t band_center_320, 1099 struct reg_channel_list *chan_list, 1100 enum supported_6g_pwr_types in_6g_pwr_mode, 1101 bool treat_nol_chan_as_disabled); 1102 #endif 1103 1104 /** 1105 * reg_is_punc_bitmap_valid() - is puncture bitmap valid or not 1106 * @bw: Input channel width. 1107 * @puncture_bitmap Input puncture bitmap. 1108 * 1109 * Return: true if given puncture bitmap is valid 1110 */ 1111 bool reg_is_punc_bitmap_valid(enum phy_ch_width bw, uint16_t puncture_bitmap); 1112 1113 /** 1114 * reg_extract_puncture_by_bw() - generate new puncture bitmap from original 1115 * puncture bitmap and bandwidth based on new 1116 * bandwidth 1117 * @ori_bw: original bandwidth 1118 * @ori_puncture_bitmap: original puncture bitmap 1119 * @freq: frequency of primary channel 1120 * @cen320_freq: center frequency of 320 MHZ if channel width is 320 1121 * @new_bw new bandwidth. It should be smaller than original bandwidth 1122 * @new_puncture_bitmap: output of puncture bitmap 1123 * 1124 * Example 1: ori_bw = CH_WIDTH_320MHZ (center 320 = 6105{IEEE31}) 1125 * freq = 6075 ( Primary chan location: 0000_000P_0000_0000) 1126 * ori_puncture_bitmap = B1111 0000 0011 0000(binary) 1127 * If new_bw = CH_WIDTH_160MHZ, then new_puncture_bitmap = B0011 0000(binary) 1128 * If new_bw = CH_WIDTH_80MHZ, then new_puncture_bitmap = B0011(binary) 1129 * 1130 * Example 2: ori_bw = CH_WIDTH_320MHZ (center 320 = 6105{IEEE31}) 1131 * freq = 6135 ( Primary chan location: 0000_0000_0P00_0000) 1132 * ori_puncture_bitmap = B1111 0000 0011 0000(binary) 1133 * If new_bw = CH_WIDTH_160MHZ, then new_puncture_bitmap = B1111 0000(binary) 1134 * If new_bw = CH_WIDTH_80MHZ, then new_puncture_bitmap = B0000(binary) 1135 * 1136 * Return: QDF_STATUS 1137 */ 1138 QDF_STATUS reg_extract_puncture_by_bw(enum phy_ch_width ori_bw, 1139 uint16_t ori_puncture_bitmap, 1140 qdf_freq_t freq, 1141 qdf_freq_t cen320_freq, 1142 enum phy_ch_width new_bw, 1143 uint16_t *new_puncture_bitmap); 1144 1145 /** 1146 * reg_set_create_punc_bitmap() - set is_create_punc_bitmap of ch_params 1147 * @ch_params: ch_params to set 1148 * @is_create_punc_bitmap: is create punc bitmap 1149 * 1150 * Return: NULL 1151 */ 1152 void reg_set_create_punc_bitmap(struct ch_params *ch_params, 1153 bool is_create_punc_bitmap); 1154 #else 1155 static inline 1156 QDF_STATUS reg_extract_puncture_by_bw(enum phy_ch_width ori_bw, 1157 uint16_t ori_puncture_bitmap, 1158 qdf_freq_t freq, 1159 qdf_freq_t cen320_freq, 1160 enum phy_ch_width new_bw, 1161 uint16_t *new_puncture_bitmap) 1162 { 1163 return QDF_STATUS_SUCCESS; 1164 } 1165 1166 static inline void reg_set_create_punc_bitmap(struct ch_params *ch_params, 1167 bool is_create_punc_bitmap) 1168 { 1169 } 1170 #endif 1171 /** 1172 * reg_get_channel_reg_power_for_freq() - Get the txpower for the given channel 1173 * @pdev: Pointer to pdev 1174 * @freq: Channel frequency 1175 * 1176 * Return: txpower 1177 */ 1178 uint8_t reg_get_channel_reg_power_for_freq(struct wlan_objmgr_pdev *pdev, 1179 qdf_freq_t freq); 1180 1181 /** 1182 * reg_update_nol_ch_for_freq () - Updates NOL channels in current channel list 1183 * @pdev: pointer to pdev object 1184 * @chan_freq_list: pointer to NOL channel list 1185 * @num_ch: No.of channels in list 1186 * @update_nol: set/reset the NOL status 1187 * 1188 * Return: None 1189 */ 1190 void reg_update_nol_ch_for_freq(struct wlan_objmgr_pdev *pdev, 1191 uint16_t *chan_freq_list, 1192 uint8_t num_chan, 1193 bool nol_chan); 1194 /** 1195 * reg_is_dfs_for_freq () - Checks the channel state for DFS 1196 * @pdev: pdev ptr 1197 * @freq: Channel center frequency 1198 * 1199 * Return: true or false 1200 */ 1201 bool reg_is_dfs_for_freq(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 1202 1203 #ifdef CONFIG_REG_CLIENT 1204 /** 1205 * reg_is_dfs_in_secondary_list_for_freq() - Checks the channel state for DFS 1206 * from the secondary channel list 1207 * @pdev: pdev ptr 1208 * @freq: Channel center frequency 1209 * 1210 * Return: true or false 1211 */ 1212 bool reg_is_dfs_in_secondary_list_for_freq(struct wlan_objmgr_pdev *pdev, 1213 qdf_freq_t freq); 1214 #endif 1215 1216 /** 1217 * reg_chan_freq_is_49ghz() - Check if the input channel center frequency is 1218 * 4.9GHz 1219 * @pdev: Pdev pointer 1220 * @chan_num: Input channel center frequency 1221 * 1222 * Return: true if the frequency is 4.9GHz else false. 1223 */ 1224 bool reg_chan_freq_is_49ghz(qdf_freq_t freq); 1225 1226 /** 1227 * reg_update_nol_history_ch_for_freq() - Set nol-history flag for the channels 1228 * in the list. 1229 * @pdev: Pdev ptr. 1230 * @chan_list: Input channel freqeuncy list. 1231 * @num_ch: Number of channels. 1232 * @nol_history_ch: NOL-History flag. 1233 * 1234 * Return: void 1235 */ 1236 void reg_update_nol_history_ch_for_freq(struct wlan_objmgr_pdev *pdev, 1237 uint16_t *chan_list, 1238 uint8_t num_chan, 1239 bool nol_history_chan); 1240 1241 /** 1242 * reg_is_same_5g_band_freqs() - Check if given channel center 1243 * frequencies have same band 1244 * @freq1: Channel Center Frequency 1 1245 * @freq2: Channel Center Frequency 2 1246 * 1247 * Return: true if both the frequencies has the same band. 1248 */ 1249 bool reg_is_same_band_freqs(qdf_freq_t freq1, qdf_freq_t freq2); 1250 1251 /** 1252 * reg_freq_to_band() - Get band from channel frequency 1253 * @chan_num: channel frequency 1254 * 1255 * Return: wifi band 1256 */ 1257 enum reg_wifi_band reg_freq_to_band(qdf_freq_t freq); 1258 1259 /** 1260 * reg_min_chan_freq() - minimum channel frequency supported 1261 * 1262 * Return: channel frequency 1263 */ 1264 qdf_freq_t reg_min_chan_freq(void); 1265 1266 /** 1267 * reg_max_chan_freq() - maximum channel frequency supported 1268 * 1269 * Return: channel frequency 1270 */ 1271 qdf_freq_t reg_max_chan_freq(void); 1272 1273 /** 1274 * reg_get_5g_bonded_channel_for_freq()- Return the channel state for a 1275 * 5G or 6G channel frequency based on the channel width and bonded channel 1276 * @pdev: Pointer to pdev. 1277 * @freq: Channel center frequency. 1278 * @ch_width: Channel Width. 1279 * @bonded_chan_ptr_ptr: Pointer to bonded_channel_freq. 1280 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1281 * 1282 * Return: Channel State 1283 */ 1284 enum channel_state 1285 reg_get_5g_bonded_channel_for_freq(struct wlan_objmgr_pdev *pdev, 1286 uint16_t freq, 1287 enum phy_ch_width ch_width, 1288 const struct bonded_channel_freq 1289 **bonded_chan_ptr_ptr); 1290 1291 #ifdef CONFIG_REG_6G_PWRMODE 1292 /** 1293 * reg_get_5g_bonded_channel_for_pwrmode()- Return the channel state for a 1294 * 5G or 6G channel frequency based on the channel width and bonded channel 1295 * @pdev: Pointer to pdev. 1296 * @freq: Channel center frequency. 1297 * @ch_width: Channel Width. 1298 * @bonded_chan_ptr_ptr: Pointer to bonded_channel_freq. 1299 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1300 * 1301 * Return: Channel State 1302 */ 1303 enum channel_state 1304 reg_get_5g_bonded_channel_for_pwrmode(struct wlan_objmgr_pdev *pdev, 1305 uint16_t freq, 1306 enum phy_ch_width ch_width, 1307 const struct bonded_channel_freq 1308 **bonded_chan_ptr_ptr, 1309 enum supported_6g_pwr_types 1310 in_6g_pwr_mode); 1311 #endif 1312 1313 /** 1314 * reg_is_disable_for_freq() - Check if the given channel frequency in 1315 * disable state 1316 * @pdev: Pointer to pdev 1317 * @freq: Channel frequency 1318 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1319 * 1320 * Return: True if channel state is disabled, else false 1321 */ 1322 bool reg_is_disable_for_freq(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 1323 1324 #ifdef CONFIG_REG_6G_PWRMODE 1325 /** 1326 * reg_is_disable_for_pwrmode() - Check if the given channel frequency in 1327 * disable state 1328 * @pdev: Pointer to pdev 1329 * @freq: Channel frequency 1330 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1331 * 1332 * Return: True if channel state is disabled, else false 1333 */ 1334 bool reg_is_disable_for_pwrmode(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq, 1335 enum supported_6g_pwr_types in_6g_pwr_mode); 1336 #endif 1337 1338 #ifdef CONFIG_REG_CLIENT 1339 /** 1340 * reg_is_disable_in_secondary_list_for_freq() - Check if the given channel 1341 * frequency is in disable state 1342 * @pdev: Pointer to pdev 1343 * @freq: Channel frequency 1344 * 1345 * Return: True if channel state is disabled, else false 1346 */ 1347 bool reg_is_disable_in_secondary_list_for_freq(struct wlan_objmgr_pdev *pdev, 1348 qdf_freq_t freq); 1349 1350 /** 1351 * reg_is_enable_in_secondary_list_for_freq() - Check if the given channel 1352 * frequency is in enable state 1353 * @pdev: Pointer to pdev 1354 * @freq: Channel frequency 1355 * 1356 * Return: True if channel state is enabled, else false 1357 */ 1358 bool reg_is_enable_in_secondary_list_for_freq(struct wlan_objmgr_pdev *pdev, 1359 qdf_freq_t freq); 1360 1361 /** 1362 * reg_get_max_tx_power_for_pwr_mode() - Get maximum tx power 1363 * @pdev: Pointer to pdev 1364 * @in_6g_pwr_type: 6 GHz power type for which 6GHz frequencies needs to be 1365 * considered while getting the max power 1366 * 1367 * Return: return the value of the maximum tx power for 2GHz/5GHz channels 1368 * from current channel list and for 6GHz channels from the super channel list 1369 * for the specified power mode 1370 * 1371 */ 1372 uint8_t reg_get_max_tx_power_for_pwr_mode( 1373 struct wlan_objmgr_pdev *pdev, 1374 enum supported_6g_pwr_types in_6g_pwr_type); 1375 #endif 1376 1377 /** 1378 * reg_is_passive_for_freq() - Check if the given channel frequency is in 1379 * passive state 1380 * @pdev: Pointer to pdev 1381 * @freq: Channel frequency 1382 * 1383 * Return: True if channel state is passive, else false 1384 */ 1385 bool reg_is_passive_for_freq(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 1386 #endif /* CONFIG_CHAN_FREQ_API */ 1387 1388 /** 1389 * reg_get_max_tx_power() - Get maximum tx power from the current channel list 1390 * @pdev: Pointer to pdev 1391 * 1392 * Return: return the value of the maximum tx power in the current channel list 1393 * 1394 */ 1395 uint8_t reg_get_max_tx_power(struct wlan_objmgr_pdev *pdev); 1396 1397 /** 1398 * reg_set_ignore_fw_reg_offload_ind() - Set if regdb offload indication 1399 * needs to be ignored 1400 * @psoc: Pointer to psoc 1401 * 1402 * Return: QDF_STATUS 1403 */ 1404 QDF_STATUS reg_set_ignore_fw_reg_offload_ind(struct wlan_objmgr_psoc *psoc); 1405 1406 /** 1407 * reg_get_ignore_fw_reg_offload_ind() - Check whether regdb offload indication 1408 * needs to be ignored 1409 * 1410 * @psoc: Pointer to psoc 1411 */ 1412 bool reg_get_ignore_fw_reg_offload_ind(struct wlan_objmgr_psoc *psoc); 1413 1414 /** 1415 * reg_set_6ghz_supported() - Set if 6ghz is supported 1416 * 1417 * @psoc: Pointer to psoc 1418 * @val: value 1419 */ 1420 QDF_STATUS reg_set_6ghz_supported(struct wlan_objmgr_psoc *psoc, 1421 bool val); 1422 1423 /** 1424 * reg_set_5dot9_ghz_supported() - Set if 5.9ghz is supported 1425 * 1426 * @psoc: Pointer to psoc 1427 * @val: value 1428 */ 1429 QDF_STATUS reg_set_5dot9_ghz_supported(struct wlan_objmgr_psoc *psoc, 1430 bool val); 1431 1432 /** 1433 * reg_is_6ghz_op_class() - Check whether 6ghz oper class 1434 * 1435 * @pdev: Pointer to pdev 1436 * @op_class: oper class 1437 */ 1438 bool reg_is_6ghz_op_class(struct wlan_objmgr_pdev *pdev, 1439 uint8_t op_class); 1440 1441 #ifdef CONFIG_REG_CLIENT 1442 /** 1443 * reg_is_6ghz_supported() - Whether 6ghz is supported 1444 * 1445 * @psoc: pointer to psoc 1446 */ 1447 bool reg_is_6ghz_supported(struct wlan_objmgr_psoc *psoc); 1448 #endif 1449 1450 /** 1451 * reg_is_5dot9_ghz_supported() - Whether 5.9ghz is supported 1452 * 1453 * @psoc: pointer to psoc 1454 */ 1455 bool reg_is_5dot9_ghz_supported(struct wlan_objmgr_psoc *psoc); 1456 1457 /** 1458 * reg_is_fcc_regdmn () - Checks if the current reg domain is FCC3/FCC8/FCC15/ 1459 * FCC16 or not 1460 * @pdev: pdev ptr 1461 * 1462 * Return: true or false 1463 */ 1464 bool reg_is_fcc_regdmn(struct wlan_objmgr_pdev *pdev); 1465 1466 /** 1467 * reg_is_5dot9_ghz_freq () - Checks if the frequency is 5.9 GHz freq or not 1468 * @freq: frequency 1469 * @pdev: pdev ptr 1470 * 1471 * Return: true or false 1472 */ 1473 bool reg_is_5dot9_ghz_freq(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 1474 1475 /** 1476 * reg_is_5dot9_ghz_chan_allowed_master_mode () - Checks if 5.9 GHz channels 1477 * are allowed in master mode or not. 1478 * 1479 * @pdev: pdev ptr 1480 * 1481 * Return: true or false 1482 */ 1483 bool reg_is_5dot9_ghz_chan_allowed_master_mode(struct wlan_objmgr_pdev *pdev); 1484 1485 /** 1486 * reg_get_unii_5g_bitmap() - get unii_5g_bitmap value 1487 * @pdev: pdev pointer 1488 * @bitmap: Pointer to retrieve the unii_5g_bitmap of enum reg_unii_band 1489 * 1490 * Return: QDF_STATUS 1491 */ 1492 #ifdef DISABLE_UNII_SHARED_BANDS 1493 QDF_STATUS 1494 reg_get_unii_5g_bitmap(struct wlan_objmgr_pdev *pdev, uint8_t *bitmap); 1495 #endif 1496 1497 #ifdef CHECK_REG_PHYMODE 1498 /** 1499 * reg_get_max_phymode() - Recursively find the best possible phymode given a 1500 * phymode, a frequency, and per-country regulations 1501 * @pdev: pdev pointer 1502 * @phy_in: phymode that the user requested 1503 * @freq: current operating center frequency 1504 * 1505 * Return: maximum phymode allowed in current country that is <= phy_in 1506 */ 1507 enum reg_phymode reg_get_max_phymode(struct wlan_objmgr_pdev *pdev, 1508 enum reg_phymode phy_in, 1509 qdf_freq_t freq); 1510 #else 1511 static inline enum reg_phymode 1512 reg_get_max_phymode(struct wlan_objmgr_pdev *pdev, 1513 enum reg_phymode phy_in, 1514 qdf_freq_t freq) 1515 { 1516 return REG_PHYMODE_INVALID; 1517 } 1518 #endif /* CHECK_REG_PHYMODE */ 1519 1520 #ifdef CONFIG_REG_CLIENT 1521 /** 1522 * reg_band_bitmap_to_band_info() - Convert the band_bitmap to a band_info enum. 1523 * Since band_info enum only has combinations for 2G and 5G, 6G is not 1524 * considered in this function. 1525 * @band_bitmap: bitmap on top of reg_wifi_band of bands enabled 1526 * 1527 * Return: BAND_ALL if both 2G and 5G band is enabled 1528 * BAND_2G if 2G is enabled but 5G isn't 1529 * BAND_5G if 5G is enabled but 2G isn't 1530 */ 1531 enum band_info reg_band_bitmap_to_band_info(uint32_t band_bitmap); 1532 #endif 1533 1534 #if defined(CONFIG_BAND_6GHZ) 1535 /** 1536 * reg_set_cur_6g_ap_pwr_type() - Set the current 6G regulatory AP power type. 1537 * @pdev: Pointer to PDEV object. 1538 * @reg_6g_ap_type: Regulatory 6G AP type ie VLPI/LPI/SP. 1539 * 1540 * Return: QDF_STATUS_E_INVAL if unable to set and QDF_STATUS_SUCCESS is set. 1541 */ 1542 QDF_STATUS 1543 reg_set_cur_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev, 1544 enum reg_6g_ap_type reg_cur_6g_ap_pwr_type); 1545 1546 /** 1547 * reg_get_cur_6g_ap_pwr_type() - Get the current 6G regulatory AP power type. 1548 * @reg_6g_ap_pwr_type: The current regulatory 6G AP type ie VLPI/LPI/SP. 1549 * subordinate. 1550 * 1551 * Return: QDF_STATUS. 1552 */ 1553 QDF_STATUS 1554 reg_get_cur_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev, 1555 enum reg_6g_ap_type *reg_cur_6g_ap_pwr_type); 1556 1557 #ifdef CONFIG_AFC_SUPPORT 1558 /** 1559 * reg_afc_start() - Start the AFC request from regulatory. This finally 1560 * sends the request to registered callbacks 1561 * @pdev: Pointer to pdev 1562 * @req_id: The AFC request ID 1563 * 1564 * Return: QDF_STATUS 1565 */ 1566 QDF_STATUS reg_afc_start(struct wlan_objmgr_pdev *pdev, uint64_t req_id); 1567 1568 /** 1569 * reg_get_partial_afc_req_info() - Get the AFC partial request information 1570 * @pdev: Pointer to pdev 1571 * @afc_req: Address of AFC request pointer 1572 * 1573 * NOTE:- The memory for AFC request is allocated by the function must be 1574 * freed by the caller. 1575 * Return: QDF_STATUS 1576 */ 1577 QDF_STATUS 1578 reg_get_partial_afc_req_info(struct wlan_objmgr_pdev *pdev, 1579 struct wlan_afc_host_partial_request **afc_req); 1580 1581 /** 1582 * reg_print_partial_afc_req_info() - Print the AFC partial request 1583 * information 1584 * @pdev: Pointer to pdev 1585 * @afc_req: Pointer to AFC request 1586 * 1587 * Return: Void 1588 */ 1589 void 1590 reg_print_partial_afc_req_info(struct wlan_objmgr_pdev *pdev, 1591 struct wlan_afc_host_partial_request *afc_req); 1592 1593 /** 1594 * reg_register_afc_req_rx_callback () - add AFC request received callback 1595 * @pdev: Pointer to pdev 1596 * @cbf: Pointer to callback handler 1597 * @arg: Pointer to opaque argument 1598 * 1599 * Return: QDF_STATUS 1600 */ 1601 QDF_STATUS reg_register_afc_req_rx_callback(struct wlan_objmgr_pdev *pdev, 1602 afc_req_rx_evt_handler cbf, 1603 void *arg); 1604 1605 /** 1606 * reg_unregister_afc_req_rx_callback () - remove AFC request received 1607 * callback 1608 * @pdev: Pointer to pdev 1609 * @cbf: Pointer to callback handler 1610 * 1611 * Return: QDF_STATUS 1612 */ 1613 QDF_STATUS reg_unregister_afc_req_rx_callback(struct wlan_objmgr_pdev *pdev, 1614 afc_req_rx_evt_handler cbf); 1615 1616 /** 1617 * reg_register_afc_power_event_callback() - add AFC power event received 1618 * @pdev: Pointer to pdev 1619 * @cbf: Pointer to callback function 1620 * @arg: Pointer to opaque argument 1621 * 1622 * Return: QDF_STATUS 1623 */ 1624 QDF_STATUS 1625 reg_register_afc_power_event_callback(struct wlan_objmgr_pdev *pdev, 1626 afc_power_tx_evt_handler cbf, 1627 void *arg); 1628 /** 1629 * reg_unregister_afc_power_event_callback() - remove AFC power event received 1630 * callback 1631 * @pdev: Pointer to pdev 1632 * @cbf: Pointer to callback function 1633 * 1634 * Return: QDF_STATUS 1635 */ 1636 QDF_STATUS 1637 reg_unregister_afc_power_event_callback(struct wlan_objmgr_pdev *pdev, 1638 afc_power_tx_evt_handler cbf); 1639 1640 /** 1641 * reg_send_afc_power_event() - Send AFC power event to registered 1642 * recipient 1643 * @pdev: Pointer to pdev 1644 * @power_info: Pointer to afc power info 1645 * 1646 * Return: QDF_STATUS 1647 */ 1648 QDF_STATUS reg_send_afc_power_event(struct wlan_objmgr_pdev *pdev, 1649 struct reg_fw_afc_power_event *power_info); 1650 1651 /** 1652 * reg_get_afc_dev_deploy_type() - Get AFC device deployment type 1653 * @pdev: Pointer to pdev 1654 * @reg_afc_dev_type: Pointer to afc device deployment type 1655 * 1656 * Return: QDF_STATUS 1657 */ 1658 QDF_STATUS 1659 reg_get_afc_dev_deploy_type(struct wlan_objmgr_pdev *pdev, 1660 enum reg_afc_dev_deploy_type *reg_afc_dev_type); 1661 1662 /** 1663 * reg_set_afc_soc_dev_deploy_type() - Set AFC soc device deployment type 1664 * @pdev: Pointer to psoc 1665 * @reg_afc_dev_type: afc device deployment type 1666 * 1667 * Return: QDF_STATUS 1668 */ 1669 QDF_STATUS 1670 reg_set_afc_soc_dev_type(struct wlan_objmgr_psoc *psoc, 1671 enum reg_afc_dev_deploy_type reg_afc_dev_type); 1672 1673 /** 1674 * reg_is_sta_connect_allowed() - Check if STA connection is allowed. 1675 * @pdev: Pointer to pdev 1676 * @root_ap_pwr_mode: power mode of the Root AP. 1677 * 1678 * Return: True if STA Vap is allowed to connect. 1679 */ 1680 bool 1681 reg_is_sta_connect_allowed(struct wlan_objmgr_pdev *pdev, 1682 enum reg_6g_ap_type root_ap_pwr_mode); 1683 1684 /** 1685 * reg_get_afc_soc_dev_deploy_type() - Get AFC soc device deployment type 1686 * @pdev: Pointer to psoc 1687 * @reg_afc_dev_type: Pointer to afc device deployment type 1688 * 1689 * Return: QDF_STATUS 1690 */ 1691 QDF_STATUS 1692 reg_get_afc_soc_dev_type(struct wlan_objmgr_psoc *psoc, 1693 enum reg_afc_dev_deploy_type *reg_afc_dev_type); 1694 #endif /* CONFIG_AFC_SUPPORT */ 1695 1696 /** 1697 * reg_get_cur_6g_client_type() - Get the current 6G regulatory client Type. 1698 * @pdev: Pointer to PDEV object. 1699 * @reg_cur_6g_client_mobility_type: The current regulatory 6G client type ie. 1700 * default/subordinate. 1701 * 1702 * Return: QDF_STATUS. 1703 */ 1704 QDF_STATUS 1705 reg_get_cur_6g_client_type(struct wlan_objmgr_pdev *pdev, 1706 enum reg_6g_client_type 1707 *reg_cur_6g_client_mobility_type); 1708 1709 /** 1710 * reg_get_rnr_tpe_usable() - Tells if RNR IE is applicable for current domain. 1711 * @pdev: Pointer to PDEV object. 1712 * @reg_rnr_tpe_usable: Pointer to hold the bool value, true if RNR IE is 1713 * applicable, else false. 1714 * 1715 * Return: QDF_STATUS. 1716 */ 1717 QDF_STATUS reg_get_rnr_tpe_usable(struct wlan_objmgr_pdev *pdev, 1718 bool *reg_rnr_tpe_usable); 1719 1720 /** 1721 * reg_get_unspecified_ap_usable() - Tells if AP type unspecified by 802.11 can 1722 * be used or not. 1723 * @pdev: Pointer to PDEV object. 1724 * @reg_unspecified_ap_usable: Pointer to hold the bool value, true if 1725 * unspecified AP types can be used in the IE, else false. 1726 * 1727 * Return: QDF_STATUS. 1728 */ 1729 QDF_STATUS reg_get_unspecified_ap_usable(struct wlan_objmgr_pdev *pdev, 1730 bool *reg_unspecified_ap_usable); 1731 1732 /** 1733 * reg_is_6g_psd_power() - Checks if pdev has PSD power 1734 * 1735 * @pdev: pdev ptr 1736 * 1737 * Return: true if PSD power or false otherwise 1738 */ 1739 bool reg_is_6g_psd_power(struct wlan_objmgr_pdev *pdev); 1740 1741 /** 1742 * reg_get_6g_chan_ap_power() - Finds the TX power for the given channel 1743 * frequency, taking the AP's current power level into account 1744 * 1745 * @pdev: pdev ptr 1746 * @chan_freq: channel frequency 1747 * @is_psd: is channel PSD or not 1748 * @tx_power: transmit power to fill for chan_freq 1749 * @eirp_psd_power: EIRP PSD power, will only be filled if is_psd is true 1750 * 1751 * Return: QDF_STATUS 1752 */ 1753 QDF_STATUS reg_get_6g_chan_ap_power(struct wlan_objmgr_pdev *pdev, 1754 qdf_freq_t chan_freq, bool *is_psd, 1755 uint16_t *tx_power, 1756 uint16_t *eirp_psd_power); 1757 1758 /** 1759 * reg_get_client_power_for_connecting_ap() - Find the channel information when 1760 * device is operating as a client 1761 * 1762 * @pdev: pdev ptr 1763 * @ap_type: type of AP that device is connected to 1764 * @chan_freq: channel frequency 1765 * @is_psd: is channel PSD or not 1766 * @tx_power: transmit power to fill for chan_freq 1767 * @eirp_psd_power: EIRP power, will only be filled if is_psd is true 1768 * 1769 * This function is meant to be called to find the channel frequency power 1770 * information for a client when the device is operating as a client. It will 1771 * fill in the parameter is_psd, tx_power, and eirp_psd_power. eirp_psd_power 1772 * will only be filled if the channel is PSD. 1773 * 1774 * Return: QDF_STATUS 1775 */ 1776 QDF_STATUS reg_get_client_power_for_connecting_ap(struct wlan_objmgr_pdev *pdev, 1777 enum reg_6g_ap_type ap_type, 1778 qdf_freq_t chan_freq, 1779 bool *is_psd, 1780 uint16_t *tx_power, 1781 uint16_t *eirp_psd_power); 1782 1783 /** 1784 * reg_get_client_power_for_6ghz_ap() - Find the channel information when 1785 * device is operating as a 6GHz AP 1786 * 1787 * @pdev: pdev ptr 1788 * @client_type: type of client that is connected to our AP 1789 * @chan_freq: channel frequency 1790 * @is_psd: is channel PSD or not 1791 * @tx_power: transmit power to fill for chan_freq 1792 * @eirp_psd_power: EIRP power, will only be filled if is_psd is true 1793 * 1794 * This function is meant to be called to find the channel frequency power 1795 * information for a client when the device is operating as an AP. It will fill 1796 * in the parameter is_psd, tx_power, and eirp_psd_power. eirp_psd_power will 1797 * only be filled if the channel is PSD. 1798 * 1799 * Return: QDF_STATUS 1800 */ 1801 QDF_STATUS reg_get_client_power_for_6ghz_ap(struct wlan_objmgr_pdev *pdev, 1802 enum reg_6g_client_type client_type, 1803 qdf_freq_t chan_freq, 1804 bool *is_psd, uint16_t *tx_power, 1805 uint16_t *eirp_psd_power); 1806 1807 /** 1808 * reg_set_ap_pwr_and_update_chan_list() - Set the AP power mode and recompute 1809 * the current channel list 1810 * 1811 * @pdev: pdev ptr 1812 * @ap_pwr_type: the AP power type to update to 1813 * 1814 * Return: QDF_STATUS 1815 */ 1816 QDF_STATUS reg_set_ap_pwr_and_update_chan_list(struct wlan_objmgr_pdev *pdev, 1817 enum reg_6g_ap_type ap_pwr_type); 1818 1819 /** 1820 * reg_get_6g_chan_psd_eirp_power() - For a given frequency, get the max PSD 1821 * from the mas_chan_list 1822 * @freq: Channel frequency 1823 * @mas_chan_list: Pointer to mas_chan_list 1824 * @reg_psd: Pointer to reg_psd 1825 * 1826 * Return: QDF_STATUS 1827 */ 1828 QDF_STATUS 1829 reg_get_6g_chan_psd_eirp_power(qdf_freq_t freq, 1830 struct regulatory_channel *mas_chan_list, 1831 uint16_t *reg_psd); 1832 1833 /** 1834 * reg_find_txpower_from_6g_list() - For a given frequency, get the max EIRP 1835 * from the mas_chan_list 1836 * @freq: Channel frequency 1837 * @mas_chan_list: Pointer to mas_chan_list 1838 * @reg_eirp: Pointer to reg_eirp 1839 * 1840 * Return: QDF_STATUS 1841 */ 1842 QDF_STATUS 1843 reg_find_txpower_from_6g_list(qdf_freq_t freq, 1844 struct regulatory_channel *chan_list, 1845 uint16_t *reg_eirp); 1846 #else 1847 static inline QDF_STATUS 1848 reg_set_cur_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev, 1849 enum reg_6g_ap_type reg_cur_6g_ap_pwr_type) 1850 { 1851 return QDF_STATUS_E_NOSUPPORT; 1852 } 1853 1854 static inline QDF_STATUS 1855 reg_get_cur_6g_ap_pwr_type(struct wlan_objmgr_pdev *pdev, 1856 enum reg_6g_ap_type *reg_cur_6g_ap_pwr_type) 1857 { 1858 *reg_cur_6g_ap_pwr_type = REG_MAX_AP_TYPE; 1859 return QDF_STATUS_E_NOSUPPORT; 1860 } 1861 1862 static inline QDF_STATUS 1863 reg_get_cur_6g_client_type(struct wlan_objmgr_pdev *pdev, 1864 enum reg_6g_client_type 1865 *reg_cur_6g_client_mobility_type) 1866 { 1867 *reg_cur_6g_client_mobility_type = REG_SUBORDINATE_CLIENT; 1868 return QDF_STATUS_E_NOSUPPORT; 1869 } 1870 1871 static inline 1872 QDF_STATUS reg_get_rnr_tpe_usable(struct wlan_objmgr_pdev *pdev, 1873 bool *reg_rnr_tpe_usable) 1874 { 1875 *reg_rnr_tpe_usable = false; 1876 return QDF_STATUS_E_NOSUPPORT; 1877 } 1878 1879 static inline 1880 QDF_STATUS reg_get_unspecified_ap_usable(struct wlan_objmgr_pdev *pdev, 1881 bool *reg_unspecified_ap_usable) 1882 { 1883 *reg_unspecified_ap_usable = false; 1884 return QDF_STATUS_E_NOSUPPORT; 1885 } 1886 1887 static inline 1888 bool reg_is_6g_psd_power(struct wlan_objmgr_pdev *pdev) 1889 { 1890 return false; 1891 } 1892 1893 static inline 1894 QDF_STATUS reg_get_6g_chan_ap_power(struct wlan_objmgr_pdev *pdev, 1895 qdf_freq_t chan_freq, bool *is_psd, 1896 uint16_t *tx_power, 1897 uint16_t *eirp_psd_power) 1898 { 1899 *is_psd = false; 1900 *eirp_psd_power = 0; 1901 *tx_power = 0; 1902 return QDF_STATUS_E_NOSUPPORT; 1903 } 1904 1905 static inline 1906 QDF_STATUS reg_get_client_power_for_connecting_ap(struct wlan_objmgr_pdev *pdev, 1907 enum reg_6g_ap_type ap_type, 1908 qdf_freq_t chan_freq, 1909 bool *is_psd, 1910 uint16_t *tx_power, 1911 uint16_t *eirp_psd_power) 1912 { 1913 *is_psd = false; 1914 *tx_power = 0; 1915 *eirp_psd_power = 0; 1916 return QDF_STATUS_E_NOSUPPORT; 1917 } 1918 1919 static inline 1920 QDF_STATUS reg_get_client_power_for_6ghz_ap(struct wlan_objmgr_pdev *pdev, 1921 enum reg_6g_client_type client_type, 1922 qdf_freq_t chan_freq, 1923 bool *is_psd, uint16_t *tx_power, 1924 uint16_t *eirp_psd_power) 1925 { 1926 *is_psd = false; 1927 *tx_power = 0; 1928 *eirp_psd_power = 0; 1929 return QDF_STATUS_E_NOSUPPORT; 1930 } 1931 1932 static inline 1933 QDF_STATUS reg_set_ap_pwr_and_update_chan_list(struct wlan_objmgr_pdev *pdev, 1934 enum reg_6g_ap_type ap_pwr_type) 1935 { 1936 return QDF_STATUS_E_NOSUPPORT; 1937 } 1938 1939 static inline QDF_STATUS 1940 reg_get_6g_chan_psd_eirp_power(qdf_freq_t freq, 1941 struct regulatory_channel *mas_chan_list, 1942 uint16_t *eirp_psd_power) 1943 { 1944 *eirp_psd_power = 0; 1945 return QDF_STATUS_E_NOSUPPORT; 1946 } 1947 1948 static inline QDF_STATUS 1949 reg_find_txpower_from_6g_list(qdf_freq_t freq, 1950 struct regulatory_channel *chan_list, 1951 uint16_t *reg_eirp) 1952 { 1953 *reg_eirp = 0; 1954 return QDF_STATUS_E_NOSUPPORT; 1955 } 1956 #endif 1957 1958 #ifdef CONFIG_HOST_FIND_CHAN 1959 /** 1960 * reg_update_max_phymode_chwidth_for_pdev() - Update the maximum phymode 1961 * and the corresponding chwidth for the pdev. 1962 * @pdev: Pointer to PDEV object. 1963 * 1964 */ 1965 void reg_update_max_phymode_chwidth_for_pdev(struct wlan_objmgr_pdev *pdev); 1966 1967 /** 1968 * reg_modify_chan_list_for_max_chwidth_for_pwrmode() - Update the maximum 1969 * bandwidth for 1970 * each channel in the current channel list. 1971 * @pdev: Pointer to PDEV object. 1972 * @cur_chan_list: Pointer to the pdev current channel list. 1973 * @in_6g_pwr_type: 6g power type which decides 6G channel list lookup. 1974 * 1975 * In countries like DK, the channel 144 is not supported by the regulatory. 1976 * When we get the regulatory rules, the entire UNII-2E's max bandwidth is set 1977 * to 160MHz but this is only true for channel 100 to 128. Channels 132 and 1978 * and 136 will have maximum bandwidth of 40MHz and channel 140 will have a 1979 * max bandwidth value of 20MHz (since 144 is not available). 1980 * These values in the current channel list are not updated based on the 1981 * bonded channels and hence will have an incorrect value for particular 1982 * channels. 1983 * Use this API to update the maximum bandwidth based on the device 1984 * capabilities and the availability of adjacent channels. 1985 */ 1986 void 1987 reg_modify_chan_list_for_max_chwidth_for_pwrmode(struct wlan_objmgr_pdev *pdev, 1988 struct regulatory_channel 1989 *cur_chan_list, 1990 enum supported_6g_pwr_types 1991 in_6g_pwr_mode); 1992 1993 #else 1994 static inline void 1995 reg_update_max_phymode_chwidth_for_pdev(struct wlan_objmgr_pdev *pdev) 1996 { 1997 } 1998 1999 static inline void 2000 reg_modify_chan_list_for_max_chwidth_for_pwrmode(struct wlan_objmgr_pdev *pdev, 2001 struct regulatory_channel 2002 *cur_chan_list, 2003 enum supported_6g_pwr_types 2004 in_6g_pwr_mode) 2005 { 2006 } 2007 #endif /* CONFIG_HOST_FIND_CHAN */ 2008 2009 /** 2010 * reg_is_phymode_unallowed() - Check if requested phymode is unallowed 2011 * @phy_in: phymode that the user requested 2012 * @phymode_bitmap: bitmap of unallowed phymodes for specific country 2013 * 2014 * Return: true if phymode is not allowed, else false 2015 */ 2016 bool reg_is_phymode_unallowed(enum reg_phymode phy_in, uint32_t phymode_bitmap); 2017 2018 /* 2019 * reg_is_regdb_offloaded() - is regdb offloaded 2020 * @psoc: Pointer to psoc object 2021 * 2022 * Return: true if regdb is offloaded, else false 2023 */ 2024 bool reg_is_regdb_offloaded(struct wlan_objmgr_psoc *psoc); 2025 2026 /** 2027 * reg_set_ext_tpc_supported() - Set if FW supports new WMI command for TPC 2028 * @psoc: Pointer to psoc 2029 * @val: value 2030 * 2031 * Return: QDF_STATUS 2032 */ 2033 QDF_STATUS reg_set_ext_tpc_supported(struct wlan_objmgr_psoc *psoc, 2034 bool val); 2035 2036 /** 2037 * reg_is_ext_tpc_supported() - Whether FW supports new WMI command for TPC 2038 * 2039 * @psoc: pointer to psoc 2040 * 2041 * Return: true if FW supports the new TPC command, else false 2042 */ 2043 bool reg_is_ext_tpc_supported(struct wlan_objmgr_psoc *psoc); 2044 2045 /** 2046 * reg_get_bonded_chan_entry() - Fetch the bonded channel pointer given a 2047 * frequency and channel width. 2048 * @freq: Input frequency. 2049 * @chwidth: Input channel width. 2050 * @cen320_freq: center frequency of 320. In 6G band 320Mhz channel are 2051 * overlapping. The exact band should be therefore identified 2052 * by the center frequency of the 320Mhz channel. 2053 * For example: Primary channel 6135 (IEEE37) can be part of either channel 2054 * (A) the 320Mhz channel with center 6105(IEEE31) or 2055 * (B) the 320Mhz channel with center 6265(IEEE63) 2056 * For (A) the start frequency is 5955(IEEE1) whereas for (B) the start 2057 * frequency is 6115(IEEE33) 2058 * 2059 * Return: A valid bonded channel pointer if found, else NULL. 2060 */ 2061 const struct bonded_channel_freq * 2062 reg_get_bonded_chan_entry(qdf_freq_t freq, enum phy_ch_width chwidth, 2063 qdf_freq_t cen320_freq); 2064 2065 /** 2066 * reg_set_2g_channel_params_for_freq() - set the 2.4G bonded channel parameters 2067 * @oper_freq: operating channel 2068 * @ch_params: channel parameters 2069 * @sec_ch_2g_freq: 2.4G secondary channel 2070 * 2071 * Return: void 2072 */ 2073 void reg_set_2g_channel_params_for_freq(struct wlan_objmgr_pdev *pdev, 2074 uint16_t oper_freq, 2075 struct ch_params *ch_params, 2076 uint16_t sec_ch_2g_freq); 2077 2078 /** 2079 * reg_combine_channel_states() - Get minimum of channel state1 and state2 2080 * @chan_state1: Channel state1 2081 * @chan_state2: Channel state2 2082 * 2083 * Return: Channel state 2084 */ 2085 enum channel_state reg_combine_channel_states(enum channel_state chan_state1, 2086 enum channel_state chan_state2); 2087 2088 #if defined(CONFIG_BAND_6GHZ) 2089 /** 2090 * reg_set_lower_6g_edge_ch_supp() - Set if lower 6ghz edge channel is 2091 * supported by FW 2092 * 2093 * @psoc: Pointer to psoc 2094 * @val: value 2095 */ 2096 QDF_STATUS reg_set_lower_6g_edge_ch_supp(struct wlan_objmgr_psoc *psoc, 2097 bool val); 2098 2099 /** 2100 * reg_set_disable_upper_6g_edge_ch_supp() - Set if upper 6ghz edge channel is 2101 * disabled by FW 2102 * 2103 * @psoc: Pointer to psoc 2104 * @val: value 2105 */ 2106 QDF_STATUS 2107 reg_set_disable_upper_6g_edge_ch_supp(struct wlan_objmgr_psoc *psoc, 2108 bool val); 2109 2110 /** 2111 * reg_is_lower_6g_edge_ch_supp() - Check whether 6GHz lower edge channel 2112 * (5935 MHz) is supported. 2113 * @psoc: pointer to psoc 2114 * 2115 * Return: true if edge channels are supported, else false 2116 */ 2117 bool reg_is_lower_6g_edge_ch_supp(struct wlan_objmgr_psoc *psoc); 2118 2119 /** 2120 * reg_is_upper_6g_edge_ch_disabled() - Check whether 6GHz upper edge 2121 * channel (7115 MHz) is disabled. 2122 * @psoc: pointer to psoc 2123 * 2124 * Return: true if edge channels are supported, else false 2125 */ 2126 bool reg_is_upper_6g_edge_ch_disabled(struct wlan_objmgr_psoc *psoc); 2127 2128 /** 2129 * reg_convert_enum_to_6g_idx() - Convert a channel enum between 2130 * MIN_6GHZ_CHANNEL and MAX_6GHZ_CHANNEL, to an index between 0 and 2131 * NUM_6GHZ_CHANNELS 2132 * @ch_idx: Channel index 2133 * 2134 * Return: enum channel_enum 2135 */ 2136 uint16_t reg_convert_enum_to_6g_idx(enum channel_enum ch_idx); 2137 2138 /** 2139 * reg_get_superchan_entry() - Get the address of the super channel list 2140 * entry for a given input channel index. 2141 * 2142 * @pdev: pdev ptr 2143 * @chan_enum: Channel enum 2144 * @p_sup_chan_entry: Pointer to address of *p_sup_chan_entry 2145 * 2146 * Return: QDF_STATUS_SUCCESS if super channel entry is available for the input 2147 * chan_enum else QDF_STATUS_E_FAILURE 2148 */ 2149 QDF_STATUS 2150 reg_get_superchan_entry(struct wlan_objmgr_pdev *pdev, 2151 enum channel_enum chan_enum, 2152 const struct super_chan_info **p_sup_chan_entry); 2153 #else 2154 static inline QDF_STATUS 2155 reg_set_lower_6g_edge_ch_supp(struct wlan_objmgr_psoc *psoc, bool val) 2156 { 2157 return QDF_STATUS_E_NOSUPPORT; 2158 } 2159 2160 static inline QDF_STATUS 2161 reg_set_disable_upper_6g_edge_ch_supp(struct wlan_objmgr_psoc *psoc, 2162 bool val) 2163 { 2164 return QDF_STATUS_E_NOSUPPORT; 2165 } 2166 2167 static inline bool reg_is_lower_6g_edge_ch_supp(struct wlan_objmgr_psoc *psoc) 2168 { 2169 return false; 2170 } 2171 2172 static inline bool 2173 reg_is_upper_6g_edge_ch_disabled(struct wlan_objmgr_psoc *psoc) 2174 { 2175 return false; 2176 } 2177 2178 static inline QDF_STATUS 2179 reg_get_superchan_entry(struct wlan_objmgr_pdev *pdev, 2180 enum channel_enum chan_enum, 2181 const struct super_chan_info **p_sup_chan_entry) 2182 { 2183 return QDF_STATUS_E_NOSUPPORT; 2184 } 2185 2186 static inline uint16_t reg_convert_enum_to_6g_idx(enum channel_enum ch_idx) 2187 { 2188 return INVALID_CHANNEL; 2189 } 2190 #endif 2191 2192 #ifdef FEATURE_WLAN_CH_AVOID_EXT 2193 /** 2194 * reg_process_ch_avoid_ext_event() - Process channel avoid extended event 2195 * @psoc: psoc for country information 2196 * @ch_avoid_event: channel avoid extended event buffer 2197 * 2198 * Return: QDF_STATUS 2199 */ 2200 2201 QDF_STATUS 2202 reg_process_ch_avoid_ext_event(struct wlan_objmgr_psoc *psoc, 2203 struct ch_avoid_ind_type *ch_avoid_event); 2204 /** 2205 * reg_check_coex_unsafe_nb_user_prefer() - get coex unsafe nb 2206 * user prefer ini 2207 * @psoc: pointer to psoc 2208 * 2209 * Return: bool 2210 */ 2211 2212 bool reg_check_coex_unsafe_nb_user_prefer(struct wlan_objmgr_psoc *psoc); 2213 2214 /** 2215 * reg_disable_coex_unsafe_channel() - get reg channel disable for 2216 * for coex unsafe channels 2217 * @psoc: pointer to psoc 2218 * 2219 * Return: bool 2220 */ 2221 2222 bool reg_check_coex_unsafe_chan_reg_disable(struct wlan_objmgr_psoc *psoc); 2223 #else 2224 static inline QDF_STATUS 2225 reg_process_ch_avoid_ext_event(struct wlan_objmgr_psoc *psoc, 2226 struct ch_avoid_ind_type *ch_avoid_event) 2227 { 2228 return QDF_STATUS_SUCCESS; 2229 } 2230 2231 static inline 2232 bool reg_check_coex_unsafe_nb_user_prefer(struct wlan_objmgr_psoc *psoc) 2233 { 2234 return false; 2235 } 2236 2237 static inline 2238 bool reg_check_coex_unsafe_chan_reg_disable(struct wlan_objmgr_psoc *psoc) 2239 { 2240 return false; 2241 } 2242 #endif 2243 2244 #if defined(CONFIG_AFC_SUPPORT) && defined(CONFIG_BAND_6GHZ) 2245 /** 2246 * reg_send_afc_cmd() - Send AFC cmd to the FW 2247 * @pdev: pdev ptr 2248 * @afc_ind_obj: Pointer to hold AFC indication 2249 * 2250 * Return: QDF_STATUS_SUCCESS if the WMI command is sent or QDF_STATUS_E_FAILURE 2251 * otherwise 2252 */ 2253 QDF_STATUS reg_send_afc_cmd(struct wlan_objmgr_pdev *pdev, 2254 struct reg_afc_resp_rx_ind_info *afc_ind_obj); 2255 2256 /** 2257 * reg_is_afc_power_event_received() - Checks if AFC power event is 2258 * received from the FW. 2259 * 2260 * @pdev: pdev ptr 2261 * 2262 * Return: true if AFC power event is received from the FW or false otherwise 2263 */ 2264 bool reg_is_afc_power_event_received(struct wlan_objmgr_pdev *pdev); 2265 2266 /** 2267 * reg_is_afc_done() - Check is AFC response has been received enabling 2268 * the given frequency. 2269 * @pdev: pdev ptr 2270 * @freq: given frequency 2271 * 2272 * Return: True if frequency is enabled, false otherwise 2273 */ 2274 bool reg_is_afc_done(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 2275 2276 /** 2277 * reg_get_afc_req_id() - Get the AFC request ID 2278 * @pdev: pdev pointer 2279 * @req_id: Pointer to request id 2280 * 2281 * Return: QDF_STATUS 2282 */ 2283 QDF_STATUS reg_get_afc_req_id(struct wlan_objmgr_pdev *pdev, uint64_t *req_id); 2284 2285 /** 2286 * reg_is_afc_expiry_event_received() - Checks if AFC power event is 2287 * received from the FW. 2288 * 2289 * @pdev: pdev ptr 2290 * 2291 * Return: true if AFC expiry event is received from the FW or false otherwise 2292 */ 2293 bool reg_is_afc_expiry_event_received(struct wlan_objmgr_pdev *pdev); 2294 2295 /** 2296 * reg_is_noaction_on_afc_pwr_evt() - Checks if the regulatory module 2297 * needs to take action when AFC power event is received. 2298 * 2299 * @pdev: pdev ptr 2300 * 2301 * Return: true if regulatory should not take any action or false otherwise 2302 */ 2303 bool reg_is_noaction_on_afc_pwr_evt(struct wlan_objmgr_pdev *pdev); 2304 2305 /** 2306 * reg_dmn_set_afc_req_id() - Set the request ID in the AFC partial request 2307 * object 2308 * @afc_req: pointer to AFC partial request 2309 * @req_id: AFC request ID 2310 * 2311 * Return: Void 2312 */ 2313 void reg_dmn_set_afc_req_id(struct wlan_afc_host_partial_request *afc_req, 2314 uint64_t req_id); 2315 #endif 2316 2317 /** 2318 * reg_is_chwidth_supported() - Check if given channel width is supported 2319 * on a given pdev 2320 * @pdev: pdev pointer 2321 * @ch_width: channel width. 2322 * @is_supported: whether the channel width is supported 2323 * 2324 * Return QDF_STATUS_SUCCESS of operation 2325 */ 2326 QDF_STATUS reg_is_chwidth_supported(struct wlan_objmgr_pdev *pdev, 2327 enum phy_ch_width ch_width, 2328 bool *is_supported); 2329 2330 /** 2331 * reg_is_state_allowed() - Check the state of the regulatory channel if it 2332 * is invalid or disabled. 2333 * @chan_state: Channel state. 2334 * 2335 * Return bool: true if the channel is not an invalid channel or disabled 2336 * channel. 2337 */ 2338 bool reg_is_state_allowed(enum channel_state chan_state); 2339 2340 /** 2341 * reg_is_freq_enabled() - Checks if the given frequency is enabled on the given 2342 * power mode or not. If the frequency is not a 6G frequency then the input 2343 * power mode is ignored and only current channel list is searched. 2344 * 2345 * @pdev: pdev pointer. 2346 * @freq: input frequency. 2347 * @in_6g_pwr_mode: Power mode on which the freq is enabled or not is to be 2348 * checked. 2349 * 2350 * Return: True if the frequency is present in the given power mode channel 2351 * list. 2352 */ 2353 bool reg_is_freq_enabled(struct wlan_objmgr_pdev *pdev, 2354 qdf_freq_t freq, 2355 enum supported_6g_pwr_types in_6g_pwr_mode); 2356 2357 /** 2358 * reg_is_freq_idx_enabled() - Checks if the given frequency index is enabled on 2359 * the given power mode or not. If the frequency index is not a 6G frequency 2360 * then the input power mode is ignored and only current channel list is 2361 * searched. 2362 * 2363 * @pdev: pdev pointer. 2364 * @freq_idx: input frequency index. 2365 * @in_6g_pwr_mode: Power mode on which the frequency index is enabled or not 2366 * is to be checked. 2367 * 2368 * Return: True if the frequency index is present in the given power mode 2369 * channel list. 2370 */ 2371 bool reg_is_freq_idx_enabled(struct wlan_objmgr_pdev *pdev, 2372 enum channel_enum freq_idx, 2373 enum supported_6g_pwr_types in_6g_pwr_mode); 2374 2375 /** 2376 * reg_get_best_6g_pwr_type() - Returns the best 6g power type supported for 2377 * a given frequency. 2378 * @pdev: pdev pointer 2379 * @freq: input frequency. 2380 * 2381 * Return: supported_6g_pwr_types enum. 2382 */ 2383 enum supported_6g_pwr_types 2384 reg_get_best_6g_pwr_type(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq); 2385 2386 /** 2387 * reg_conv_6g_ap_type_to_supported_6g_pwr_types() - Converts the 6G AP power 2388 * type to 6g supported power type enum. 2389 * @ap_pwr_type: input 6G AP power type. 2390 * 2391 * Return: supported_6g_pwr_types enum. 2392 */ 2393 enum supported_6g_pwr_types 2394 reg_conv_6g_ap_type_to_supported_6g_pwr_types(enum reg_6g_ap_type ap_pwr_type); 2395 2396 /** 2397 * reg_find_chwidth_from_bw () - Gets channel width for given 2398 * bandwidth 2399 * @bw: Bandwidth 2400 * 2401 * Return: phy_ch_width 2402 */ 2403 enum phy_ch_width reg_find_chwidth_from_bw(uint16_t bw); 2404 2405 #ifdef CONFIG_BAND_6GHZ 2406 /** 2407 * reg_get_thresh_priority_freq() - Get the prioritized frequency value 2408 * @pdev: pdev pointer 2409 */ 2410 qdf_freq_t reg_get_thresh_priority_freq(struct wlan_objmgr_pdev *pdev); 2411 2412 /** 2413 * reg_get_best_pwr_mode() - Get the AP's primary channel center frequency and 2414 * AP's operating bandwidth to return the best power mode, which is calculated 2415 * based on the maximum EIRP power among the 3 AP types, i.e, LPI, SP and VLP 2416 * @pdev: Pointer to pdev 2417 * @freq: Primary channel center frequency in MHz 2418 * @cen320: Band center of 320 MHz. (For other BW, this param is ignored during 2419 * processing) 2420 * @bw: AP's operating bandwidth in mhz 2421 * 2422 * Return: Best power mode 2423 */ 2424 enum reg_6g_ap_type reg_get_best_pwr_mode(struct wlan_objmgr_pdev *pdev, 2425 qdf_freq_t freq, 2426 qdf_freq_t cen320, 2427 uint16_t bw); 2428 2429 /** 2430 * reg_get_eirp_pwr() - Get eirp power based on the AP power mode 2431 * @pdev: Pointer to pdev 2432 * @freq: Frequency in MHz 2433 * @cen320: 320 MHz Band center frequency 2434 * @bw: Bandwidth in MHz 2435 * @ap_pwr_type: AP power type 2436 * 2437 * Return: EIRP power 2438 */ 2439 uint8_t reg_get_eirp_pwr(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq, 2440 qdf_freq_t cen320, 2441 uint16_t bw, enum reg_6g_ap_type ap_pwr_type); 2442 #endif /* CONFIG_BAND_6GHZ */ 2443 2444 /** 2445 * reg_get_5g_chan_state() - Get channel state for 2446 * 5G bonded channel using the channel frequency 2447 * @pdev: Pointer to pdev 2448 * @freq: channel center frequency. 2449 * @bw: channel band width 2450 * @in_6g_pwr_mode: Input power mode which decides the 6G channel list to be 2451 * used. 2452 * 2453 * Return: channel state 2454 */ 2455 enum channel_state 2456 reg_get_5g_chan_state(struct wlan_objmgr_pdev *pdev, qdf_freq_t freq, 2457 enum phy_ch_width bw, 2458 enum supported_6g_pwr_types in_6g_pwr_mode); 2459 2460 /** 2461 * reg_get_320_bonded_channel_state_for_pwrmode() - Given a bonded channel 2462 * pointer and freq, determine if the subchannels of the bonded pair 2463 * are valid and supported by the current regulatory. 2464 * 2465 * @pdev: Pointer to struct wlan_objmgr_pdev. 2466 * @freq: Frequency in MHZ. 2467 * @bonded_chan_ptr: Pointer to const struct bonded_channel_freq. 2468 * @bw: channel bandwidth 2469 * @out_punc_bitmap: Output puncturing bitmap 2470 * @in_6g_pwr_type: Input 6g power type 2471 * @treat_nol_chan_as_disabled: Bool to treat nol as enabled/disabled 2472 * 2473 * Return - The channel state of the bonded pair. 2474 */ 2475 #ifdef WLAN_FEATURE_11BE 2476 enum channel_state 2477 reg_get_320_bonded_channel_state_for_pwrmode(struct wlan_objmgr_pdev *pdev, 2478 qdf_freq_t freq, 2479 const struct bonded_channel_freq 2480 *bonded_chan_ptr, 2481 enum phy_ch_width bw, 2482 uint16_t *out_punc_bitmap, 2483 enum supported_6g_pwr_types 2484 in_6g_pwr_type, 2485 bool treat_nol_chan_as_disabled); 2486 #endif 2487 2488 /** 2489 * reg_is_ch_width_320() - Given a channel width, find out if it is 320MHZ. 2490 * @ch_width: Channel width 2491 * Return - True if ch_width is 320, false otherwise. 2492 */ 2493 bool reg_is_ch_width_320(enum phy_ch_width ch_width); 2494 2495 /** 2496 * reg_get_ch_state_based_on_nol_flag() - Given a channel, find out the 2497 * state of the channel. If "treat_nol_chan_as_disabled" flag is set, nol channels 2498 * are considered disabled, else nol channels are considered enabled. 2499 * @pdev: Pointer to struct wlan_objmgr_pdev 2500 * @freq: Primary frequency 2501 * @treat_nol_chan_as_disabled: Flag to consider nol chan as enabled/disabled. 2502 * @ch_param: pointer to struct ch_params 2503 * @in_6g_pwr_mode: Input 6g power type 2504 * 2505 * Return - Channel state 2506 */ 2507 enum channel_state 2508 reg_get_ch_state_based_on_nol_flag(struct wlan_objmgr_pdev *pdev, 2509 qdf_freq_t freq, 2510 struct ch_params *ch_param, 2511 enum supported_6g_pwr_types 2512 in_6g_pwr_mode, 2513 bool treat_nol_chan_as_disabled); 2514 2515 /** 2516 * reg_get_min_max_bw_reg_chan_list() - Given a frequency index, find out the 2517 * min/max bw of the channel. 2518 * 2519 * @pdev: pdev pointer. 2520 * @freq_idx: input frequency index. 2521 * @in_6g_pwr_mode: Input 6g power type. 2522 * @min_bw: Min bandwidth. 2523 * @max_bw: Max bandwidth 2524 * 2525 * Return: true/false. 2526 */ 2527 QDF_STATUS reg_get_min_max_bw_reg_chan_list(struct wlan_objmgr_pdev *pdev, 2528 enum channel_enum freq_idx, 2529 enum supported_6g_pwr_types 2530 in_6g_pwr_mode, 2531 uint16_t *min_bw, 2532 uint16_t *max_bw); 2533 2534 /** 2535 * reg_get_chan_state() - Given a frequency index, find out the 2536 * state of the channel. 2537 * 2538 * @pdev: pdev pointer. 2539 * @freq_idx: input frequency index. 2540 * @in_6g_pwr_mode: Input 6g power type 2541 * @treat_nol_chan_as_disabled: Bool to treat NOL channels as 2542 * disabled/enabled. 2543 * 2544 * Return: Channel state. 2545 */ 2546 enum channel_state reg_get_chan_state(struct wlan_objmgr_pdev *pdev, 2547 enum channel_enum freq_idx, 2548 enum supported_6g_pwr_types 2549 in_6g_pwr_mode, 2550 bool treat_nol_chan_as_disabled); 2551 2552 /** 2553 * reg_is_chan_disabled() - Check if a chanel is disabled or not 2554 * 2555 * @chan_flags: Channel flags 2556 * @chan_state: Channel state 2557 * 2558 * Return: True if channel is disabled else false. 2559 */ 2560 bool reg_is_chan_disabled(uint32_t chan_flags, enum channel_state chan_state); 2561 2562 /** 2563 * reg_get_chan_state_for_320() - Get the channel state of a 320 MHz 2564 * bonded channel. 2565 * @pdev: Pointer to wlan_objmgr_pdev 2566 * @freq: Primary frequency 2567 * @center_320: Band center of 320 MHz 2568 * @ch_width: Channel width 2569 * @bonded_chan_ptr_ptr: Pointer to bonded channel pointer 2570 * @treat_nol_chan_as_disabled: Bool to treat nol chan as enabled/disabled 2571 * @in_pwr_type: Input 6g power type 2572 * 2573 * Return: Channel state 2574 */ 2575 #ifdef WLAN_FEATURE_11BE 2576 enum channel_state 2577 reg_get_chan_state_for_320(struct wlan_objmgr_pdev *pdev, 2578 uint16_t freq, 2579 qdf_freq_t center_320, 2580 enum phy_ch_width ch_width, 2581 const struct bonded_channel_freq 2582 **bonded_chan_ptr_ptr, 2583 enum supported_6g_pwr_types in_pwr_type, 2584 bool treat_nol_chan_as_disabled); 2585 #else 2586 static inline enum channel_state 2587 reg_get_chan_state_for_320(struct wlan_objmgr_pdev *pdev, 2588 uint16_t freq, 2589 qdf_freq_t center_320, 2590 enum phy_ch_width ch_width, 2591 const struct bonded_channel_freq 2592 **bonded_chan_ptr_ptr, 2593 enum supported_6g_pwr_types in_pwr_type, 2594 bool treat_nol_chan_as_disabled) 2595 { 2596 return CHANNEL_STATE_INVALID; 2597 } 2598 #endif 2599 2600 /** 2601 * reg_get_regd_rules() - provides the reg domain rules info 2602 * @pdev: pdev pointer 2603 * @reg_rules: regulatory rules 2604 * 2605 * Return: QDF_STATUS 2606 */ 2607 QDF_STATUS reg_get_regd_rules(struct wlan_objmgr_pdev *pdev, 2608 struct reg_rule_info *reg_rules); 2609 2610 #if defined(CONFIG_AFC_SUPPORT) && defined(CONFIG_BAND_6GHZ) 2611 /** 2612 * reg_is_sup_chan_entry_afc_done() - Checks if the super chan entry of given 2613 * channel idx and power mode has REGULATORY_CHAN_AFC_NOT_DONE flag cleared. 2614 * 2615 * @pdev: pdev pointer. 2616 * @freq: input channel idx. 2617 * @in_6g_pwr_mode: input power mode 2618 * 2619 * Return: True if REGULATORY_CHAN_AFC_NOT_DONE flag is clear for the super 2620 * chan entry. 2621 */ 2622 bool reg_is_sup_chan_entry_afc_done(struct wlan_objmgr_pdev *pdev, 2623 enum channel_enum chan_idx, 2624 enum supported_6g_pwr_types in_6g_pwr_mode); 2625 #else 2626 static inline bool 2627 reg_is_sup_chan_entry_afc_done(struct wlan_objmgr_pdev *pdev, 2628 enum channel_enum chan_idx, 2629 enum supported_6g_pwr_types in_6g_pwr_mode) 2630 { 2631 return false; 2632 } 2633 #endif 2634 /** 2635 * reg_get_max_bw_5G_for_fo() - get max bw 2636 * @pdev: PDEV object 2637 * 2638 * API to get max bw from pdev. 2639 * 2640 * Return: max bw 2641 */ 2642 uint16_t reg_get_max_bw_5G_for_fo(struct wlan_objmgr_pdev *pdev); 2643 #endif 2644