1*4882a593Smuzhiyun /* SPDX-License-Identifier: GPL-2.0 */ 2*4882a593Smuzhiyun #ifndef B43_LO_H_ 3*4882a593Smuzhiyun #define B43_LO_H_ 4*4882a593Smuzhiyun 5*4882a593Smuzhiyun /* G-PHY Local Oscillator */ 6*4882a593Smuzhiyun 7*4882a593Smuzhiyun #include "phy_g.h" 8*4882a593Smuzhiyun 9*4882a593Smuzhiyun struct b43_wldev; 10*4882a593Smuzhiyun 11*4882a593Smuzhiyun /* Local Oscillator control value-pair. */ 12*4882a593Smuzhiyun struct b43_loctl { 13*4882a593Smuzhiyun /* Control values. */ 14*4882a593Smuzhiyun s8 i; 15*4882a593Smuzhiyun s8 q; 16*4882a593Smuzhiyun }; 17*4882a593Smuzhiyun /* Debugging: Poison value for i and q values. */ 18*4882a593Smuzhiyun #define B43_LOCTL_POISON 111 19*4882a593Smuzhiyun 20*4882a593Smuzhiyun /* This struct holds calibrated LO settings for a set of 21*4882a593Smuzhiyun * Baseband and RF attenuation settings. */ 22*4882a593Smuzhiyun struct b43_lo_calib { 23*4882a593Smuzhiyun /* The set of attenuation values this set of LO 24*4882a593Smuzhiyun * control values is calibrated for. */ 25*4882a593Smuzhiyun struct b43_bbatt bbatt; 26*4882a593Smuzhiyun struct b43_rfatt rfatt; 27*4882a593Smuzhiyun /* The set of control values for the LO. */ 28*4882a593Smuzhiyun struct b43_loctl ctl; 29*4882a593Smuzhiyun /* The time when these settings were calibrated (in jiffies) */ 30*4882a593Smuzhiyun unsigned long calib_time; 31*4882a593Smuzhiyun /* List. */ 32*4882a593Smuzhiyun struct list_head list; 33*4882a593Smuzhiyun }; 34*4882a593Smuzhiyun 35*4882a593Smuzhiyun /* Size of the DC Lookup Table in 16bit words. */ 36*4882a593Smuzhiyun #define B43_DC_LT_SIZE 32 37*4882a593Smuzhiyun 38*4882a593Smuzhiyun /* Local Oscillator calibration information */ 39*4882a593Smuzhiyun struct b43_txpower_lo_control { 40*4882a593Smuzhiyun /* Lists of RF and BB attenuation values for this device. 41*4882a593Smuzhiyun * Used for building hardware power control tables. */ 42*4882a593Smuzhiyun struct b43_rfatt_list rfatt_list; 43*4882a593Smuzhiyun struct b43_bbatt_list bbatt_list; 44*4882a593Smuzhiyun 45*4882a593Smuzhiyun /* The DC Lookup Table is cached in memory here. 46*4882a593Smuzhiyun * Note that this is only used for Hardware Power Control. */ 47*4882a593Smuzhiyun u16 dc_lt[B43_DC_LT_SIZE]; 48*4882a593Smuzhiyun 49*4882a593Smuzhiyun /* List of calibrated control values (struct b43_lo_calib). */ 50*4882a593Smuzhiyun struct list_head calib_list; 51*4882a593Smuzhiyun /* Last time the power vector was read (jiffies). */ 52*4882a593Smuzhiyun unsigned long pwr_vec_read_time; 53*4882a593Smuzhiyun /* Last time the txctl values were measured (jiffies). */ 54*4882a593Smuzhiyun unsigned long txctl_measured_time; 55*4882a593Smuzhiyun 56*4882a593Smuzhiyun /* Current TX Bias value */ 57*4882a593Smuzhiyun u8 tx_bias; 58*4882a593Smuzhiyun /* Current TX Magnification Value (if used by the device) */ 59*4882a593Smuzhiyun u8 tx_magn; 60*4882a593Smuzhiyun 61*4882a593Smuzhiyun /* Saved device PowerVector */ 62*4882a593Smuzhiyun u64 power_vector; 63*4882a593Smuzhiyun }; 64*4882a593Smuzhiyun 65*4882a593Smuzhiyun /* Calibration expire timeouts. 66*4882a593Smuzhiyun * Timeouts must be multiple of 15 seconds. To make sure 67*4882a593Smuzhiyun * the item really expired when the 15 second timer hits, we 68*4882a593Smuzhiyun * subtract two additional seconds from the timeout. */ 69*4882a593Smuzhiyun #define B43_LO_CALIB_EXPIRE (HZ * (30 - 2)) 70*4882a593Smuzhiyun #define B43_LO_PWRVEC_EXPIRE (HZ * (30 - 2)) 71*4882a593Smuzhiyun #define B43_LO_TXCTL_EXPIRE (HZ * (180 - 4)) 72*4882a593Smuzhiyun 73*4882a593Smuzhiyun 74*4882a593Smuzhiyun /* Adjust the Local Oscillator to the saved attenuation 75*4882a593Smuzhiyun * and txctl values. 76*4882a593Smuzhiyun */ 77*4882a593Smuzhiyun void b43_lo_g_adjust(struct b43_wldev *dev); 78*4882a593Smuzhiyun /* Adjust to specific values. */ 79*4882a593Smuzhiyun void b43_lo_g_adjust_to(struct b43_wldev *dev, 80*4882a593Smuzhiyun u16 rfatt, u16 bbatt, u16 tx_control); 81*4882a593Smuzhiyun 82*4882a593Smuzhiyun void b43_gphy_dc_lt_init(struct b43_wldev *dev, bool update_all); 83*4882a593Smuzhiyun 84*4882a593Smuzhiyun void b43_lo_g_maintenance_work(struct b43_wldev *dev); 85*4882a593Smuzhiyun void b43_lo_g_cleanup(struct b43_wldev *dev); 86*4882a593Smuzhiyun void b43_lo_g_init(struct b43_wldev *dev); 87*4882a593Smuzhiyun 88*4882a593Smuzhiyun #endif /* B43_LO_H_ */ 89