| 1 |
/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */ |
| 2 |
/* Copyright(c) 2018-2019 Realtek Corporation |
| 3 |
*/ |
| 4 |
|
| 5 |
#ifndef __RTW_PHY_H_ |
| 6 |
#define __RTW_PHY_H_ |
| 7 |
|
| 8 |
#include "debug.h" |
| 9 |
|
| 10 |
extern const u8 rtw_cck_rates[]; |
| 11 |
extern const u8 rtw_ofdm_rates[]; |
| 12 |
extern const u8 rtw_ht_1s_rates[]; |
| 13 |
extern const u8 rtw_ht_2s_rates[]; |
| 14 |
extern const u8 rtw_vht_1s_rates[]; |
| 15 |
extern const u8 rtw_vht_2s_rates[]; |
| 16 |
extern const u8 rtw_ht_3s_rates[]; |
| 17 |
extern const u8 rtw_ht_4s_rates[]; |
| 18 |
extern const u8 rtw_vht_3s_rates[]; |
| 19 |
extern const u8 rtw_vht_4s_rates[]; |
| 20 |
extern const u8 * const rtw_rate_section[]; |
| 21 |
extern const u8 rtw_rate_size[]; |
| 22 |
|
| 23 |
void rtw_phy_init(struct rtw_dev *rtwdev); |
| 24 |
void rtw_phy_dynamic_mechanism(struct rtw_dev *rtwdev); |
| 25 |
u8 rtw_phy_rf_power_2_rssi(s8 *rf_power, u8 path_num); |
| 26 |
u32 rtw_phy_read_rf(struct rtw_dev *rtwdev, enum rtw_rf_path rf_path, |
| 27 |
u32 addr, u32 mask); |
| 28 |
u32 rtw_phy_read_rf_sipi(struct rtw_dev *rtwdev, enum rtw_rf_path rf_path, |
| 29 |
u32 addr, u32 mask); |
| 30 |
bool rtw_phy_write_rf_reg_sipi(struct rtw_dev *rtwdev, enum rtw_rf_path rf_path, |
| 31 |
u32 addr, u32 mask, u32 data); |
| 32 |
bool rtw_phy_write_rf_reg(struct rtw_dev *rtwdev, enum rtw_rf_path rf_path, |
| 33 |
u32 addr, u32 mask, u32 data); |
| 34 |
bool rtw_phy_write_rf_reg_mix(struct rtw_dev *rtwdev, enum rtw_rf_path rf_path, |
| 35 |
u32 addr, u32 mask, u32 data); |
| 36 |
void rtw_phy_setup_phy_cond(struct rtw_dev *rtwdev, u32 pkg); |
| 37 |
void rtw_parse_tbl_phy_cond(struct rtw_dev *rtwdev, const struct rtw_table *tbl); |
| 38 |
void rtw_parse_tbl_bb_pg(struct rtw_dev *rtwdev, const struct rtw_table *tbl); |
| 39 |
void rtw_parse_tbl_txpwr_lmt(struct rtw_dev *rtwdev, const struct rtw_table *tbl); |
| 40 |
void rtw_phy_cfg_mac(struct rtw_dev *rtwdev, const struct rtw_table *tbl, |
| 41 |
u32 addr, u32 data); |
| 42 |
void rtw_phy_cfg_agc(struct rtw_dev *rtwdev, const struct rtw_table *tbl, |
| 43 |
u32 addr, u32 data); |
| 44 |
void rtw_phy_cfg_bb(struct rtw_dev *rtwdev, const struct rtw_table *tbl, |
| 45 |
u32 addr, u32 data); |
| 46 |
void rtw_phy_cfg_rf(struct rtw_dev *rtwdev, const struct rtw_table *tbl, |
| 47 |
u32 addr, u32 data); |
| 48 |
void rtw_phy_init_tx_power(struct rtw_dev *rtwdev); |
| 49 |
void rtw_phy_load_tables(struct rtw_dev *rtwdev); |
| 50 |
u8 rtw_phy_get_tx_power_index(struct rtw_dev *rtwdev, u8 rf_path, u8 rate, |
| 51 |
enum rtw_bandwidth bw, u8 channel, u8 regd); |
| 52 |
void rtw_phy_set_tx_power_level(struct rtw_dev *rtwdev, u8 channel); |
| 53 |
void rtw_phy_tx_power_by_rate_config(struct rtw_hal *hal); |
| 54 |
void rtw_phy_tx_power_limit_config(struct rtw_hal *hal); |
| 55 |
void rtw_phy_pwrtrack_avg(struct rtw_dev *rtwdev, u8 thermal, u8 path); |
| 56 |
bool rtw_phy_pwrtrack_thermal_changed(struct rtw_dev *rtwdev, u8 thermal, |
| 57 |
u8 path); |
| 58 |
u8 rtw_phy_pwrtrack_get_delta(struct rtw_dev *rtwdev, u8 path); |
| 59 |
s8 rtw_phy_pwrtrack_get_pwridx(struct rtw_dev *rtwdev, |
| 60 |
struct rtw_swing_table *swing_table, |
| 61 |
u8 tbl_path, u8 therm_path, u8 delta); |
| 62 |
bool rtw_phy_pwrtrack_need_lck(struct rtw_dev *rtwdev); |
| 63 |
bool rtw_phy_pwrtrack_need_iqk(struct rtw_dev *rtwdev); |
| 64 |
void rtw_phy_config_swing_table(struct rtw_dev *rtwdev, |
| 65 |
struct rtw_swing_table *swing_table); |
| 66 |
void rtw_phy_set_edcca_th(struct rtw_dev *rtwdev, u8 l2h, u8 h2l); |
| 67 |
void rtw_phy_adaptivity_set_mode(struct rtw_dev *rtwdev); |
| 68 |
void rtw_phy_parsing_cfo(struct rtw_dev *rtwdev, |
| 69 |
struct rtw_rx_pkt_stat *pkt_stat); |
| 70 |
void rtw_phy_tx_path_diversity(struct rtw_dev *rtwdev); |
| 71 |
|
| 72 |
struct rtw_txpwr_lmt_cfg_pair { |
| 73 |
u8 regd; |
| 74 |
u8 band; |
| 75 |
u8 bw; |
| 76 |
u8 rs; |
| 77 |
u8 ch; |
| 78 |
s8 txpwr_lmt; |
| 79 |
}; |
| 80 |
|
| 81 |
struct rtw_phy_pg_cfg_pair { |
| 82 |
u32 band; |
| 83 |
u32 rf_path; |
| 84 |
u32 tx_num; |
| 85 |
u32 addr; |
| 86 |
u32 bitmask; |
| 87 |
u32 data; |
| 88 |
}; |
| 89 |
|
| 90 |
#define RTW_DECL_TABLE_PHY_COND_CORE(name, cfg, path) \ |
| 91 |
const struct rtw_table name ## _tbl = { \ |
| 92 |
.data = name, \ |
| 93 |
.size = ARRAY_SIZE(name), \ |
| 94 |
.parse = rtw_parse_tbl_phy_cond, \ |
| 95 |
.do_cfg = cfg, \ |
| 96 |
.rf_path = path, \ |
| 97 |
} |
| 98 |
|
| 99 |
#define RTW_DECL_TABLE_PHY_COND(name, cfg) \ |
| 100 |
RTW_DECL_TABLE_PHY_COND_CORE(name, cfg, 0) |
| 101 |
|
| 102 |
#define RTW_DECL_TABLE_RF_RADIO(name, path) \ |
| 103 |
RTW_DECL_TABLE_PHY_COND_CORE(name, rtw_phy_cfg_rf, RF_PATH_ ## path) |
| 104 |
|
| 105 |
#define RTW_DECL_TABLE_BB_PG(name) \ |
| 106 |
const struct rtw_table name ## _tbl = { \ |
| 107 |
.data = name, \ |
| 108 |
.size = ARRAY_SIZE(name), \ |
| 109 |
.parse = rtw_parse_tbl_bb_pg, \ |
| 110 |
} |
| 111 |
|
| 112 |
#define RTW_DECL_TABLE_TXPWR_LMT(name) \ |
| 113 |
const struct rtw_table name ## _tbl = { \ |
| 114 |
.data = name, \ |
| 115 |
.size = ARRAY_SIZE(name), \ |
| 116 |
.parse = rtw_parse_tbl_txpwr_lmt, \ |
| 117 |
} |
| 118 |
|
| 119 |
static inline const struct rtw_rfe_def *rtw_get_rfe_def(struct rtw_dev *rtwdev) |
| 120 |
{ |
| 121 |
const struct rtw_chip_info *chip = rtwdev->chip; |
| 122 |
struct rtw_efuse *efuse = &rtwdev->efuse; |
| 123 |
const struct rtw_rfe_def *rfe_def = NULL; |
| 124 |
|
| 125 |
if (chip->rfe_defs_size == 0) |
| 126 |
return NULL; |
| 127 |
|
| 128 |
if (efuse->rfe_option < chip->rfe_defs_size) |
| 129 |
rfe_def = &chip->rfe_defs[efuse->rfe_option]; |
| 130 |
|
| 131 |
rtw_dbg(rtwdev, RTW_DBG_PHY, "use rfe_def[%d]\n", efuse->rfe_option); |
| 132 |
return rfe_def; |
| 133 |
} |
| 134 |
|
| 135 |
static inline int rtw_check_supported_rfe(struct rtw_dev *rtwdev) |
| 136 |
{ |
| 137 |
const struct rtw_rfe_def *rfe_def = rtw_get_rfe_def(rtwdev); |
| 138 |
|
| 139 |
if (!rfe_def || !rfe_def->phy_pg_tbl || !rfe_def->txpwr_lmt_tbl) { |
| 140 |
rtw_err(rtwdev, "rfe %d isn't supported\n", |
| 141 |
rtwdev->efuse.rfe_option); |
| 142 |
return -ENODEV; |
| 143 |
} |
| 144 |
|
| 145 |
return 0; |
| 146 |
} |
| 147 |
|
| 148 |
void rtw_phy_dig_write(struct rtw_dev *rtwdev, u8 igi); |
| 149 |
void rtw_phy_dig_reset(struct rtw_dev *rtwdev); |
| 150 |
void rtw_phy_dig_set_max_coverage(struct rtw_dev *rtwdev); |
| 151 |
|
| 152 |
struct rtw_power_params { |
| 153 |
u8 pwr_base; |
| 154 |
s8 pwr_offset; |
| 155 |
s8 pwr_limit; |
| 156 |
s8 pwr_remnant; |
| 157 |
s8 pwr_sar; |
| 158 |
}; |
| 159 |
|
| 160 |
void |
| 161 |
rtw_get_tx_power_params(struct rtw_dev *rtwdev, u8 path, |
| 162 |
u8 rate, u8 bw, u8 ch, u8 regd, |
| 163 |
struct rtw_power_params *pwr_param); |
| 164 |
|
| 165 |
enum rtw_phy_cck_pd_lv { |
| 166 |
CCK_PD_LV0, |
| 167 |
CCK_PD_LV1, |
| 168 |
CCK_PD_LV2, |
| 169 |
CCK_PD_LV3, |
| 170 |
CCK_PD_LV4, |
| 171 |
CCK_PD_LV_MAX, |
| 172 |
}; |
| 173 |
|
| 174 |
#define MASKBYTE0 0xff |
| 175 |
#define MASKBYTE1 0xff00 |
| 176 |
#define MASKBYTE2 0xff0000 |
| 177 |
#define MASKBYTE3 0xff000000 |
| 178 |
#define MASKHWORD 0xffff0000 |
| 179 |
#define MASKLWORD 0x0000ffff |
| 180 |
#define MASKDWORD 0xffffffff |
| 181 |
#define RFREG_MASK 0xfffff |
| 182 |
|
| 183 |
#define MASK7BITS 0x7f |
| 184 |
#define MASK12BITS 0xfff |
| 185 |
#define MASKH4BITS 0xf0000000 |
| 186 |
#define MASK20BITS 0xfffff |
| 187 |
#define MASK24BITS 0xffffff |
| 188 |
|
| 189 |
#define MASKH3BYTES 0xffffff00 |
| 190 |
#define MASKL3BYTES 0x00ffffff |
| 191 |
#define MASKBYTE2HIGHNIBBLE 0x00f00000 |
| 192 |
#define MASKBYTE3LOWNIBBLE 0x0f000000 |
| 193 |
#define MASKL3BYTES 0x00ffffff |
| 194 |
|
| 195 |
#define CCK_FA_AVG_RESET 0xffffffff |
| 196 |
|
| 197 |
#define LSSI_READ_ADDR_MASK 0x7f800000 |
| 198 |
#define LSSI_READ_EDGE_MASK 0x80000000 |
| 199 |
#define LSSI_READ_DATA_MASK 0xfffff |
| 200 |
|
| 201 |
#define RRSR_RATE_ORDER_MAX 0xfffff |
| 202 |
#define RRSR_RATE_ORDER_CCK_LEN 4 |
| 203 |
|
| 204 |
#endif |