linux/drivers/net/wireless/intel/iwlwifi/fw/regulatory.h

/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
/*
 * Copyright (C) 2023-2024 Intel Corporation
 */

#ifndef __fw_regulatory_h__
#define __fw_regulatory_h__

#include "fw/img.h"
#include "fw/api/commands.h"
#include "fw/api/power.h"
#include "fw/api/phy.h"
#include "fw/api/config.h"
#include "fw/api/nvm-reg.h"
#include "fw/img.h"
#include "iwl-trans.h"

#define BIOS_SAR_MAX_PROFILE_NUM …
/*
 * Each SAR profile has (up to, depends on the table revision) 4 chains:
 * chain A, chain B, chain A when in CDB, chain B when in CDB
 */
#define BIOS_SAR_MAX_CHAINS_PER_PROFILE …
#define BIOS_SAR_NUM_CHAINS …
#define BIOS_SAR_MAX_SUB_BANDS_NUM …

#define BIOS_GEO_NUM_CHAINS …
#define BIOS_GEO_MAX_NUM_BANDS …
#define BIOS_GEO_MAX_PROFILE_NUM …
#define BIOS_GEO_MIN_PROFILE_NUM …

#define IWL_SAR_ENABLE_MSK …

/* PPAG gain value bounds in 1/8 dBm */
#define IWL_PPAG_MIN_LB …
#define IWL_PPAG_MAX_LB …
#define IWL_PPAG_MIN_HB …
#define IWL_PPAG_MAX_HB …

#define IWL_PPAG_ETSI_CHINA_MASK …
#define IWL_PPAG_REV3_MASK …

#define IWL_WTAS_ENABLED_MSK …
#define IWL_WTAS_OVERRIDE_IEC_MSK …
#define IWL_WTAS_ENABLE_IEC_MSK …
#define IWL_WTAS_USA_UHB_MSK …

/*
 * The profile for revision 2 is a superset of revision 1, which is in
 * turn a superset of revision 0.  So we can store all revisions
 * inside revision 2, which is what we represent here.
 */

/*
 * struct iwl_sar_profile_chain - per-chain values of a SAR profile
 * @subbands: the SAR value for each subband
 */
struct iwl_sar_profile_chain { … };

/*
 * struct iwl_sar_profile - SAR profile from SAR tables
 * @enabled: whether the profile is enabled or not
 * @chains: per-chain SAR values
 */
struct iwl_sar_profile { … };

/* Same thing as with SAR, all revisions fit in revision 2 */

/*
 * struct iwl_geo_profile_band - per-band geo SAR offsets
 * @max: the max tx power allowed for the band
 * @chains: SAR offsets values for each chain
 */
struct iwl_geo_profile_band { … };

/*
 * struct iwl_geo_profile - geo profile
 * @bands: per-band table of the SAR offsets
 */
struct iwl_geo_profile { … };

/* Same thing as with SAR, all revisions fit in revision 2 */
struct iwl_ppag_chain { … };

struct iwl_tas_data { … };

/* For DSM revision 0 and 4 */
enum iwl_dsm_funcs { … };

enum iwl_dsm_values_srd { … };

enum iwl_dsm_values_indonesia { … };

enum iwl_dsm_unii4_bitmap { … };

#define DSM_UNII4_ALLOW_BITMAP_CMD_V8 …
#define DSM_UNII4_ALLOW_BITMAP …

enum iwl_dsm_values_rfi { … };

#define DSM_VALUE_RFI_DISABLE …

enum iwl_dsm_masks_reg { … };

struct iwl_fw_runtime;

bool iwl_sar_geo_support(struct iwl_fw_runtime *fwrt);

int iwl_sar_geo_fill_table(struct iwl_fw_runtime *fwrt,
			   struct iwl_per_chain_offset *table,
			   u32 n_bands, u32 n_profiles);

int iwl_sar_fill_profile(struct iwl_fw_runtime *fwrt,
			 __le16 *per_chain, u32 n_tables, u32 n_subbands,
			 int prof_a, int prof_b);

int iwl_fill_ppag_table(struct iwl_fw_runtime *fwrt,
			union iwl_ppag_table_cmd *cmd,
			int *cmd_size);

bool iwl_is_ppag_approved(struct iwl_fw_runtime *fwrt);

bool iwl_is_tas_approved(void);

int iwl_parse_tas_selection(struct iwl_fw_runtime *fwrt,
			    struct iwl_tas_data *tas_data,
			    const u32 tas_selection);

int iwl_bios_get_wrds_table(struct iwl_fw_runtime *fwrt);

int iwl_bios_get_ewrd_table(struct iwl_fw_runtime *fwrt);

int iwl_bios_get_wgds_table(struct iwl_fw_runtime *fwrt);

int iwl_bios_get_ppag_table(struct iwl_fw_runtime *fwrt);

int iwl_bios_get_tas_table(struct iwl_fw_runtime *fwrt,
			   struct iwl_tas_data *data);

int iwl_bios_get_pwr_limit(struct iwl_fw_runtime *fwrt,
			   u64 *dflt_pwr_limit);

int iwl_bios_get_mcc(struct iwl_fw_runtime *fwrt, char *mcc);
int iwl_bios_get_eckv(struct iwl_fw_runtime *fwrt, u32 *ext_clk);
int iwl_bios_get_wbem(struct iwl_fw_runtime *fwrt, u32 *value);

int iwl_fill_lari_config(struct iwl_fw_runtime *fwrt,
			 struct iwl_lari_config_change_cmd *cmd,
			 size_t *cmd_size);

int iwl_bios_get_dsm(struct iwl_fw_runtime *fwrt, enum iwl_dsm_funcs func,
		     u32 *value);

static inline u32 iwl_bios_get_ppag_flags(const u32 ppag_modes,
					  const u8 ppag_ver)
{ … }
#endif /* __fw_regulatory_h__ */