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