drivers/net/wireless/broadcom/b43/lo.h

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