| 1 |
// SPDX-License-Identifier: ISC |
| 2 |
/* |
| 3 |
* Copyright (c) 2010 Broadcom Corporation |
| 4 |
*/ |
| 5 |
|
| 6 |
/* |
| 7 |
* phy_hal.h: functionality exported from the phy to higher layers |
| 8 |
*/ |
| 9 |
|
| 10 |
#ifndef _BRCM_PHY_HAL_H_ |
| 11 |
#define _BRCM_PHY_HAL_H_ |
| 12 |
|
| 13 |
#include <brcmu_utils.h> |
| 14 |
#include <brcmu_wifi.h> |
| 15 |
#include <phy_shim.h> |
| 16 |
|
| 17 |
#define IDCODE_VER_MASK 0x0000000f |
| 18 |
#define IDCODE_VER_SHIFT 0 |
| 19 |
#define IDCODE_MFG_MASK 0x00000fff |
| 20 |
#define IDCODE_MFG_SHIFT 0 |
| 21 |
#define IDCODE_ID_MASK 0x0ffff000 |
| 22 |
#define IDCODE_ID_SHIFT 12 |
| 23 |
#define IDCODE_REV_MASK 0xf0000000 |
| 24 |
#define IDCODE_REV_SHIFT 28 |
| 25 |
|
| 26 |
#define NORADIO_ID 0xe4f5 |
| 27 |
#define NORADIO_IDCODE 0x4e4f5246 |
| 28 |
|
| 29 |
#define BCM2055_ID 0x2055 |
| 30 |
#define BCM2055_IDCODE 0x02055000 |
| 31 |
#define BCM2055A0_IDCODE 0x1205517f |
| 32 |
|
| 33 |
#define BCM2056_ID 0x2056 |
| 34 |
#define BCM2056_IDCODE 0x02056000 |
| 35 |
#define BCM2056A0_IDCODE 0x1205617f |
| 36 |
|
| 37 |
#define BCM2057_ID 0x2057 |
| 38 |
#define BCM2057_IDCODE 0x02057000 |
| 39 |
#define BCM2057A0_IDCODE 0x1205717f |
| 40 |
|
| 41 |
#define BCM2064_ID 0x2064 |
| 42 |
#define BCM2064_IDCODE 0x02064000 |
| 43 |
#define BCM2064A0_IDCODE 0x0206417f |
| 44 |
|
| 45 |
#define PHY_TPC_HW_OFF false |
| 46 |
#define PHY_TPC_HW_ON true |
| 47 |
|
| 48 |
#define PHY_PERICAL_DRIVERUP 1 |
| 49 |
#define PHY_PERICAL_WATCHDOG 2 |
| 50 |
#define PHY_PERICAL_PHYINIT 3 |
| 51 |
#define PHY_PERICAL_JOIN_BSS 4 |
| 52 |
#define PHY_PERICAL_START_IBSS 5 |
| 53 |
#define PHY_PERICAL_UP_BSS 6 |
| 54 |
#define PHY_PERICAL_CHAN 7 |
| 55 |
#define PHY_FULLCAL 8 |
| 56 |
|
| 57 |
#define PHY_PERICAL_DISABLE 0 |
| 58 |
#define PHY_PERICAL_SPHASE 1 |
| 59 |
#define PHY_PERICAL_MPHASE 2 |
| 60 |
#define PHY_PERICAL_MANUAL 3 |
| 61 |
|
| 62 |
#define PHY_HOLD_FOR_ASSOC 1 |
| 63 |
#define PHY_HOLD_FOR_SCAN 2 |
| 64 |
#define PHY_HOLD_FOR_RM 4 |
| 65 |
#define PHY_HOLD_FOR_PLT 8 |
| 66 |
#define PHY_HOLD_FOR_MUTE 16 |
| 67 |
#define PHY_HOLD_FOR_NOT_ASSOC 0x20 |
| 68 |
|
| 69 |
#define PHY_MUTE_FOR_PREISM 1 |
| 70 |
#define PHY_MUTE_ALL 0xffffffff |
| 71 |
|
| 72 |
#define PHY_NOISE_FIXED_VAL (-95) |
| 73 |
#define PHY_NOISE_FIXED_VAL_NPHY (-92) |
| 74 |
#define PHY_NOISE_FIXED_VAL_LCNPHY (-92) |
| 75 |
|
| 76 |
#define PHY_MODE_CAL 0x0002 |
| 77 |
#define PHY_MODE_NOISEM 0x0004 |
| 78 |
|
| 79 |
#define BRCMS_TXPWR_DB_FACTOR 4 |
| 80 |
|
| 81 |
/* a large TX Power as an init value to factor out of min() calculations, |
| 82 |
* keep low enough to fit in an s8, units are .25 dBm |
| 83 |
*/ |
| 84 |
#define BRCMS_TXPWR_MAX (127) /* ~32 dBm = 1,500 mW */ |
| 85 |
|
| 86 |
#define BRCMS_NUM_RATES_CCK 4 |
| 87 |
#define BRCMS_NUM_RATES_OFDM 8 |
| 88 |
#define BRCMS_NUM_RATES_MCS_1_STREAM 8 |
| 89 |
#define BRCMS_NUM_RATES_MCS_2_STREAM 8 |
| 90 |
#define BRCMS_NUM_RATES_MCS_3_STREAM 8 |
| 91 |
#define BRCMS_NUM_RATES_MCS_4_STREAM 8 |
| 92 |
|
| 93 |
#define BRCMS_RSSI_INVALID 0 /* invalid RSSI value */ |
| 94 |
|
| 95 |
struct d11regs; |
| 96 |
struct phy_shim_info; |
| 97 |
|
| 98 |
struct txpwr_limits { |
| 99 |
u8 cck[BRCMS_NUM_RATES_CCK]; |
| 100 |
u8 ofdm[BRCMS_NUM_RATES_OFDM]; |
| 101 |
|
| 102 |
u8 ofdm_cdd[BRCMS_NUM_RATES_OFDM]; |
| 103 |
|
| 104 |
u8 ofdm_40_siso[BRCMS_NUM_RATES_OFDM]; |
| 105 |
u8 ofdm_40_cdd[BRCMS_NUM_RATES_OFDM]; |
| 106 |
|
| 107 |
u8 mcs_20_siso[BRCMS_NUM_RATES_MCS_1_STREAM]; |
| 108 |
u8 mcs_20_cdd[BRCMS_NUM_RATES_MCS_1_STREAM]; |
| 109 |
u8 mcs_20_stbc[BRCMS_NUM_RATES_MCS_1_STREAM]; |
| 110 |
u8 mcs_20_mimo[BRCMS_NUM_RATES_MCS_2_STREAM]; |
| 111 |
|
| 112 |
u8 mcs_40_siso[BRCMS_NUM_RATES_MCS_1_STREAM]; |
| 113 |
u8 mcs_40_cdd[BRCMS_NUM_RATES_MCS_1_STREAM]; |
| 114 |
u8 mcs_40_stbc[BRCMS_NUM_RATES_MCS_1_STREAM]; |
| 115 |
u8 mcs_40_mimo[BRCMS_NUM_RATES_MCS_2_STREAM]; |
| 116 |
u8 mcs32; |
| 117 |
}; |
| 118 |
|
| 119 |
struct tx_power { |
| 120 |
u32 flags; |
| 121 |
u16 chanspec; /* txpwr report for this channel */ |
| 122 |
u16 local_chanspec; /* channel on which we are associated */ |
| 123 |
u8 local_max; /* local max according to the AP */ |
| 124 |
u8 local_constraint; /* local constraint according to the AP */ |
| 125 |
s8 antgain[2]; /* Ant gain for each band - from SROM */ |
| 126 |
u8 rf_cores; /* count of RF Cores being reported */ |
| 127 |
u8 est_Pout[4]; /* Latest tx power out estimate per RF chain */ |
| 128 |
u8 est_Pout_act[4]; /* Latest tx power out estimate per RF chain |
| 129 |
* without adjustment */ |
| 130 |
u8 est_Pout_cck; /* Latest CCK tx power out estimate */ |
| 131 |
u8 tx_power_max[4]; /* Maximum target power among all rates */ |
| 132 |
/* Index of the rate with the max target power */ |
| 133 |
u8 tx_power_max_rate_ind[4]; |
| 134 |
/* User limit */ |
| 135 |
u8 user_limit[WL_TX_POWER_RATES]; |
| 136 |
/* Regulatory power limit */ |
| 137 |
u8 reg_limit[WL_TX_POWER_RATES]; |
| 138 |
/* Max power board can support (SROM) */ |
| 139 |
u8 board_limit[WL_TX_POWER_RATES]; |
| 140 |
/* Latest target power */ |
| 141 |
u8 target[WL_TX_POWER_RATES]; |
| 142 |
}; |
| 143 |
|
| 144 |
struct brcms_chanvec { |
| 145 |
u8 vec[MAXCHANNEL / NBBY]; |
| 146 |
}; |
| 147 |
|
| 148 |
struct shared_phy_params { |
| 149 |
struct si_pub *sih; |
| 150 |
struct phy_shim_info *physhim; |
| 151 |
uint unit; |
| 152 |
uint corerev; |
| 153 |
u16 vid; |
| 154 |
u16 did; |
| 155 |
uint chip; |
| 156 |
uint chiprev; |
| 157 |
uint chippkg; |
| 158 |
uint sromrev; |
| 159 |
uint boardtype; |
| 160 |
uint boardrev; |
| 161 |
u32 boardflags; |
| 162 |
u32 boardflags2; |
| 163 |
}; |
| 164 |
|
| 165 |
|
| 166 |
struct shared_phy *wlc_phy_shared_attach(struct shared_phy_params *shp); |
| 167 |
struct brcms_phy_pub *wlc_phy_attach(struct shared_phy *sh, |
| 168 |
struct bcma_device *d11core, int bandtype, |
| 169 |
struct wiphy *wiphy); |
| 170 |
void wlc_phy_detach(struct brcms_phy_pub *ppi); |
| 171 |
|
| 172 |
bool wlc_phy_get_phyversion(struct brcms_phy_pub *pih, u16 *phytype, |
| 173 |
u16 *phyrev, u16 *radioid, u16 *radiover); |
| 174 |
bool wlc_phy_get_encore(struct brcms_phy_pub *pih); |
| 175 |
u32 wlc_phy_get_coreflags(struct brcms_phy_pub *pih); |
| 176 |
|
| 177 |
void wlc_phy_hw_clk_state_upd(struct brcms_phy_pub *ppi, bool newstate); |
| 178 |
void wlc_phy_hw_state_upd(struct brcms_phy_pub *ppi, bool newstate); |
| 179 |
void wlc_phy_init(struct brcms_phy_pub *ppi, u16 chanspec); |
| 180 |
void wlc_phy_watchdog(struct brcms_phy_pub *ppi); |
| 181 |
int wlc_phy_down(struct brcms_phy_pub *ppi); |
| 182 |
u32 wlc_phy_clk_bwbits(struct brcms_phy_pub *pih); |
| 183 |
void wlc_phy_cal_init(struct brcms_phy_pub *ppi); |
| 184 |
void wlc_phy_antsel_init(struct brcms_phy_pub *ppi, bool lut_init); |
| 185 |
|
| 186 |
void wlc_phy_chanspec_set(struct brcms_phy_pub *ppi, u16 chanspec); |
| 187 |
u16 wlc_phy_chanspec_get(struct brcms_phy_pub *ppi); |
| 188 |
void wlc_phy_chanspec_radio_set(struct brcms_phy_pub *ppi, u16 newch); |
| 189 |
void wlc_phy_bw_state_set(struct brcms_phy_pub *ppi, u16 bw); |
| 190 |
|
| 191 |
int wlc_phy_rssi_compute(struct brcms_phy_pub *pih, struct d11rxhdr *rxh); |
| 192 |
void wlc_phy_por_inform(struct brcms_phy_pub *ppi); |
| 193 |
void wlc_phy_noise_sample_intr(struct brcms_phy_pub *ppi); |
| 194 |
bool wlc_phy_bist_check_phy(struct brcms_phy_pub *ppi); |
| 195 |
|
| 196 |
void wlc_phy_switch_radio(struct brcms_phy_pub *ppi, bool on); |
| 197 |
void wlc_phy_anacore(struct brcms_phy_pub *ppi, bool on); |
| 198 |
|
| 199 |
void wlc_phy_chanspec_ch14_widefilter_set(struct brcms_phy_pub *ppi, |
| 200 |
bool wide_filter); |
| 201 |
void wlc_phy_chanspec_band_validch(struct brcms_phy_pub *ppi, uint band, |
| 202 |
struct brcms_chanvec *channels); |
| 203 |
|
| 204 |
void wlc_phy_txpower_sromlimit(struct brcms_phy_pub *ppi, uint chan, u8 *_min_, |
| 205 |
u8 *_max_, int rate); |
| 206 |
void wlc_phy_txpower_limit_set(struct brcms_phy_pub *ppi, struct txpwr_limits *, |
| 207 |
u16 chanspec); |
| 208 |
int wlc_phy_txpower_get(struct brcms_phy_pub *ppi, uint *qdbm, bool *override); |
| 209 |
int wlc_phy_txpower_set(struct brcms_phy_pub *ppi, uint qdbm, bool override); |
| 210 |
void wlc_phy_txpower_target_set(struct brcms_phy_pub *ppi, |
| 211 |
struct txpwr_limits *); |
| 212 |
bool wlc_phy_txpower_hw_ctrl_get(struct brcms_phy_pub *ppi); |
| 213 |
|
| 214 |
void wlc_phy_stf_chain_init(struct brcms_phy_pub *pih, u8 txchain, u8 rxchain); |
| 215 |
void wlc_phy_stf_chain_set(struct brcms_phy_pub *pih, u8 txchain, u8 rxchain); |
| 216 |
u8 wlc_phy_stf_chain_active_get(struct brcms_phy_pub *pih); |
| 217 |
void wlc_phy_ldpc_override_set(struct brcms_phy_pub *ppi, bool val); |
| 218 |
|
| 219 |
void wlc_phy_cal_perical(struct brcms_phy_pub *ppi, u8 reason); |
| 220 |
void wlc_phy_cal_papd_recal(struct brcms_phy_pub *ppi); |
| 221 |
|
| 222 |
void wlc_phy_ant_rxdiv_set(struct brcms_phy_pub *ppi, u8 val); |
| 223 |
void wlc_phy_hold_upd(struct brcms_phy_pub *ppi, u32 id, bool val); |
| 224 |
void wlc_phy_mute_upd(struct brcms_phy_pub *ppi, bool val, u32 flags); |
| 225 |
|
| 226 |
void wlc_phy_antsel_type_set(struct brcms_phy_pub *ppi, u8 antsel_type); |
| 227 |
|
| 228 |
void wlc_phy_txpower_get_current(struct brcms_phy_pub *ppi, |
| 229 |
struct tx_power *power, uint channel); |
| 230 |
|
| 231 |
void wlc_phy_initcal_enable(struct brcms_phy_pub *pih, bool initcal); |
| 232 |
void wlc_phy_ofdm_rateset_war(struct brcms_phy_pub *pih, bool war); |
| 233 |
void wlc_phy_bf_preempt_enable(struct brcms_phy_pub *pih, bool bf_preempt); |
| 234 |
void wlc_phy_machwcap_set(struct brcms_phy_pub *ppi, u32 machwcap); |
| 235 |
|
| 236 |
const u8 *wlc_phy_get_ofdm_rate_lookup(void); |
| 237 |
|
| 238 |
s8 wlc_phy_get_tx_power_offset_by_mcs(struct brcms_phy_pub *ppi, |
| 239 |
u8 mcs_offset); |
| 240 |
s8 wlc_phy_get_tx_power_offset(struct brcms_phy_pub *ppi, u8 tbl_offset); |
| 241 |
#endif /* _BRCM_PHY_HAL_H_ */ |