drivers/net/wireless/b43legacy/phy.h

   1 /*
   2
   3   Broadcom B43legacy wireless driver
   4
   5   Copyright (c) 2005 Martin Langer <martin-langer@gmx.de>,
   6                      Stefano Brivio <stefano.brivio@polimi.it>
   7                      Michael Buesch <m@bues.ch>
   8                      Danny van Dyk <kugelfang@gentoo.org>
   9                      Andreas Jaggi <andreas.jaggi@waterwave.ch>
  10   Copyright (c) 2007 Larry Finger <Larry.Finger@lwfinger.net>
  11
  12   Some parts of the code in this file are derived from the ipw2200
  13   driver  Copyright(c) 2003 - 2004 Intel Corporation.
  14
  15   This program is free software; you can redistribute it and/or modify
  16   it under the terms of the GNU General Public License as published by
  17   the Free Software Foundation; either version 2 of the License, or
  18   (at your option) any later version.
  19
  20   This program is distributed in the hope that it will be useful,
  21   but WITHOUT ANY WARRANTY; without even the implied warranty of
  22   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  23   GNU General Public License for more details.
  24
  25   You should have received a copy of the GNU General Public License
  26   along with this program; see the file COPYING.  If not, write to
  27   the Free Software Foundation, Inc., 51 Franklin Steet, Fifth Floor,
  28   Boston, MA 02110-1301, USA.
  29
  30 */
  31
  32 #ifndef B43legacy_PHY_H_
  33 #define B43legacy_PHY_H_
  34
  35 #include <linux/types.h>
  36
  37 enum {
  38         B43legacy_ANTENNA0,       /* Antenna 0 */
  39         B43legacy_ANTENNA1,       /* Antenna 0 */
  40         B43legacy_ANTENNA_AUTO1,  /* Automatic, starting with antenna 1 */
  41         B43legacy_ANTENNA_AUTO0,  /* Automatic, starting with antenna 0 */
  42
  43         B43legacy_ANTENNA_AUTO  = B43legacy_ANTENNA_AUTO0,
  44         B43legacy_ANTENNA_DEFAULT = B43legacy_ANTENNA_AUTO,
  45 };
  46
  47 enum {
  48         B43legacy_INTERFMODE_NONE,
  49         B43legacy_INTERFMODE_NONWLAN,
  50         B43legacy_INTERFMODE_MANUALWLAN,
  51         B43legacy_INTERFMODE_AUTOWLAN,
  52 };
  53
  54 /*** PHY Registers ***/
  55
  56 /* Routing */
  57 #define B43legacy_PHYROUTE_OFDM_GPHY    0x400
  58 #define B43legacy_PHYROUTE_EXT_GPHY     0x800
  59
  60 /* Base registers. */
  61 #define B43legacy_PHY_BASE(reg) (reg)
  62 /* OFDM (A) registers of a G-PHY */
  63 #define B43legacy_PHY_OFDM(reg) ((reg) | B43legacy_PHYROUTE_OFDM_GPHY)
  64 /* Extended G-PHY registers */
  65 #define B43legacy_PHY_EXTG(reg) ((reg) | B43legacy_PHYROUTE_EXT_GPHY)
  66
  67
  68 /* Extended G-PHY Registers */
  69 #define B43legacy_PHY_CLASSCTL          B43legacy_PHY_EXTG(0x02)        /* Classify control */
  70 #define B43legacy_PHY_GTABCTL           B43legacy_PHY_EXTG(0x03)        /* G-PHY table control (see below) */
  71 #define  B43legacy_PHY_GTABOFF          0x03FF                  /* G-PHY table offset (see below) */
  72 #define  B43legacy_PHY_GTABNR           0xFC00                  /* G-PHY table number (see below) */
  73 #define  B43legacy_PHY_GTABNR_SHIFT     10
  74 #define B43legacy_PHY_GTABDATA          B43legacy_PHY_EXTG(0x04)        /* G-PHY table data */
  75 #define B43legacy_PHY_LO_MASK           B43legacy_PHY_EXTG(0x0F)        /* Local Oscillator control mask */
  76 #define B43legacy_PHY_LO_CTL            B43legacy_PHY_EXTG(0x10)        /* Local Oscillator control */
  77 #define B43legacy_PHY_RFOVER            B43legacy_PHY_EXTG(0x11)        /* RF override */
  78 #define B43legacy_PHY_RFOVERVAL         B43legacy_PHY_EXTG(0x12)        /* RF override value */
  79 /*** OFDM table numbers ***/
  80 #define B43legacy_OFDMTAB(number, offset)                               \
  81                           (((number) << B43legacy_PHY_OTABLENR_SHIFT)   \
  82                           | (offset))
  83 #define B43legacy_OFDMTAB_AGC1          B43legacy_OFDMTAB(0x00, 0)
  84 #define B43legacy_OFDMTAB_GAIN0         B43legacy_OFDMTAB(0x00, 0)
  85 #define B43legacy_OFDMTAB_GAINX         B43legacy_OFDMTAB(0x01, 0)
  86 #define B43legacy_OFDMTAB_GAIN1         B43legacy_OFDMTAB(0x01, 4)
  87 #define B43legacy_OFDMTAB_AGC3          B43legacy_OFDMTAB(0x02, 0)
  88 #define B43legacy_OFDMTAB_GAIN2         B43legacy_OFDMTAB(0x02, 3)
  89 #define B43legacy_OFDMTAB_LNAHPFGAIN1   B43legacy_OFDMTAB(0x03, 0)
  90 #define B43legacy_OFDMTAB_WRSSI         B43legacy_OFDMTAB(0x04, 0)
  91 #define B43legacy_OFDMTAB_LNAHPFGAIN2   B43legacy_OFDMTAB(0x04, 0)
  92 #define B43legacy_OFDMTAB_NOISESCALE    B43legacy_OFDMTAB(0x05, 0)
  93 #define B43legacy_OFDMTAB_AGC2          B43legacy_OFDMTAB(0x06, 0)
  94 #define B43legacy_OFDMTAB_ROTOR         B43legacy_OFDMTAB(0x08, 0)
  95 #define B43legacy_OFDMTAB_ADVRETARD     B43legacy_OFDMTAB(0x09, 0)
  96 #define B43legacy_OFDMTAB_DAC           B43legacy_OFDMTAB(0x0C, 0)
  97 #define B43legacy_OFDMTAB_DC            B43legacy_OFDMTAB(0x0E, 7)
  98 #define B43legacy_OFDMTAB_PWRDYN2       B43legacy_OFDMTAB(0x0E, 12)
  99 #define B43legacy_OFDMTAB_LNAGAIN       B43legacy_OFDMTAB(0x0E, 13)
 100
 101 #define B43legacy_OFDMTAB_LPFGAIN       B43legacy_OFDMTAB(0x0F, 12)
 102 #define B43legacy_OFDMTAB_RSSI          B43legacy_OFDMTAB(0x10, 0)
 103
 104 #define B43legacy_OFDMTAB_AGC1_R1       B43legacy_OFDMTAB(0x13, 0)
 105 #define B43legacy_OFDMTAB_GAINX_R1      B43legacy_OFDMTAB(0x14, 0)
 106 #define B43legacy_OFDMTAB_MINSIGSQ      B43legacy_OFDMTAB(0x14, 1)
 107 #define B43legacy_OFDMTAB_AGC3_R1       B43legacy_OFDMTAB(0x15, 0)
 108 #define B43legacy_OFDMTAB_WRSSI_R1      B43legacy_OFDMTAB(0x15, 4)
 109 #define B43legacy_OFDMTAB_TSSI          B43legacy_OFDMTAB(0x15, 0)
 110 #define B43legacy_OFDMTAB_DACRFPABB     B43legacy_OFDMTAB(0x16, 0)
 111 #define B43legacy_OFDMTAB_DACOFF        B43legacy_OFDMTAB(0x17, 0)
 112 #define B43legacy_OFDMTAB_DCBIAS        B43legacy_OFDMTAB(0x18, 0)
 113
 114 void b43legacy_put_attenuation_into_ranges(int *_bbatt, int *_rfatt);
 115
 116 /* OFDM (A) PHY Registers */
 117 #define B43legacy_PHY_VERSION_OFDM      B43legacy_PHY_OFDM(0x00)        /* Versioning register for A-PHY */
 118 #define B43legacy_PHY_BBANDCFG          B43legacy_PHY_OFDM(0x01)        /* Baseband config */
 119 #define  B43legacy_PHY_BBANDCFG_RXANT   0x180                   /* RX Antenna selection */
 120 #define  B43legacy_PHY_BBANDCFG_RXANT_SHIFT     7
 121 #define B43legacy_PHY_PWRDOWN           B43legacy_PHY_OFDM(0x03)        /* Powerdown */
 122 #define B43legacy_PHY_CRSTHRES1         B43legacy_PHY_OFDM(0x06)        /* CRS Threshold 1 */
 123 #define B43legacy_PHY_LNAHPFCTL         B43legacy_PHY_OFDM(0x1C)        /* LNA/HPF control */
 124 #define B43legacy_PHY_ADIVRELATED       B43legacy_PHY_OFDM(0x27)        /* FIXME rename */
 125 #define B43legacy_PHY_CRS0              B43legacy_PHY_OFDM(0x29)
 126 #define B43legacy_PHY_ANTDWELL          B43legacy_PHY_OFDM(0x2B)        /* Antenna dwell */
 127 #define  B43legacy_PHY_ANTDWELL_AUTODIV1        0x0100                  /* Automatic RX diversity start antenna */
 128 #define B43legacy_PHY_ENCORE            B43legacy_PHY_OFDM(0x49)        /* "Encore" (RangeMax / BroadRange) */
 129 #define  B43legacy_PHY_ENCORE_EN        0x0200                          /* Encore enable */
 130 #define B43legacy_PHY_LMS               B43legacy_PHY_OFDM(0x55)
 131 #define B43legacy_PHY_OFDM61            B43legacy_PHY_OFDM(0x61)        /* FIXME rename */
 132 #define  B43legacy_PHY_OFDM61_10        0x0010                          /* FIXME rename */
 133 #define B43legacy_PHY_IQBAL             B43legacy_PHY_OFDM(0x69)        /* I/Q balance */
 134 #define B43legacy_PHY_OTABLECTL         B43legacy_PHY_OFDM(0x72)        /* OFDM table control (see below) */
 135 #define  B43legacy_PHY_OTABLEOFF        0x03FF                          /* OFDM table offset (see below) */
 136 #define  B43legacy_PHY_OTABLENR         0xFC00                          /* OFDM table number (see below) */
 137 #define  B43legacy_PHY_OTABLENR_SHIFT   10
 138 #define B43legacy_PHY_OTABLEI           B43legacy_PHY_OFDM(0x73)        /* OFDM table data I */
 139 #define B43legacy_PHY_OTABLEQ           B43legacy_PHY_OFDM(0x74)        /* OFDM table data Q */
 140 #define B43legacy_PHY_HPWR_TSSICTL      B43legacy_PHY_OFDM(0x78)        /* Hardware power TSSI control */
 141 #define B43legacy_PHY_NRSSITHRES        B43legacy_PHY_OFDM(0x8A)        /* NRSSI threshold */
 142 #define B43legacy_PHY_ANTWRSETT         B43legacy_PHY_OFDM(0x8C)        /* Antenna WR settle */
 143 #define  B43legacy_PHY_ANTWRSETT_ARXDIV 0x2000                          /* Automatic RX diversity enabled */
 144 #define B43legacy_PHY_CLIPPWRDOWNT      B43legacy_PHY_OFDM(0x93)        /* Clip powerdown threshold */
 145 #define B43legacy_PHY_OFDM9B            B43legacy_PHY_OFDM(0x9B)        /* FIXME rename */
 146 #define B43legacy_PHY_N1P1GAIN          B43legacy_PHY_OFDM(0xA0)
 147 #define B43legacy_PHY_P1P2GAIN          B43legacy_PHY_OFDM(0xA1)
 148 #define B43legacy_PHY_N1N2GAIN          B43legacy_PHY_OFDM(0xA2)
 149 #define B43legacy_PHY_CLIPTHRES         B43legacy_PHY_OFDM(0xA3)
 150 #define B43legacy_PHY_CLIPN1P2THRES     B43legacy_PHY_OFDM(0xA4)
 151 #define B43legacy_PHY_DIVSRCHIDX        B43legacy_PHY_OFDM(0xA8)        /* Divider search gain/index */
 152 #define B43legacy_PHY_CLIPP2THRES       B43legacy_PHY_OFDM(0xA9)
 153 #define B43legacy_PHY_CLIPP3THRES       B43legacy_PHY_OFDM(0xAA)
 154 #define B43legacy_PHY_DIVP1P2GAIN       B43legacy_PHY_OFDM(0xAB)
 155 #define B43legacy_PHY_DIVSRCHGAINBACK   B43legacy_PHY_OFDM(0xAD)        /* Divider search gain back */
 156 #define B43legacy_PHY_DIVSRCHGAINCHNG   B43legacy_PHY_OFDM(0xAE)        /* Divider search gain change */
 157 #define B43legacy_PHY_CRSTHRES1_R1      B43legacy_PHY_OFDM(0xC0)        /* CRS Threshold 1 (rev 1 only) */
 158 #define B43legacy_PHY_CRSTHRES2_R1      B43legacy_PHY_OFDM(0xC1)        /* CRS Threshold 2 (rev 1 only) */
 159 #define B43legacy_PHY_TSSIP_LTBASE      B43legacy_PHY_OFDM(0x380)       /* TSSI power lookup table base */
 160 #define B43legacy_PHY_DC_LTBASE         B43legacy_PHY_OFDM(0x3A0)       /* DC lookup table base */
 161 #define B43legacy_PHY_GAIN_LTBASE       B43legacy_PHY_OFDM(0x3C0)       /* Gain lookup table base */
 162
 163 void b43legacy_put_attenuation_into_ranges(int *_bbatt, int *_rfatt);
 164
 165 /* Masks for the different PHY versioning registers. */
 166 #define B43legacy_PHYVER_ANALOG         0xF000
 167 #define B43legacy_PHYVER_ANALOG_SHIFT   12
 168 #define B43legacy_PHYVER_TYPE           0x0F00
 169 #define B43legacy_PHYVER_TYPE_SHIFT     8
 170 #define B43legacy_PHYVER_VERSION        0x00FF
 171
 172 struct b43legacy_wldev;
 173
 174 void b43legacy_phy_lock(struct b43legacy_wldev *dev);
 175 void b43legacy_phy_unlock(struct b43legacy_wldev *dev);
 176
 177 /* Card uses the loopback gain stuff */
 178 #define has_loopback_gain(phy)                   \
 179         (((phy)->rev > 1) || ((phy)->gmode))
 180
 181 u16 b43legacy_phy_read(struct b43legacy_wldev *dev, u16 offset);
 182 void b43legacy_phy_write(struct b43legacy_wldev *dev, u16 offset, u16 val);
 183
 184 int b43legacy_phy_init_tssi2dbm_table(struct b43legacy_wldev *dev);
 185 int b43legacy_phy_init(struct b43legacy_wldev *dev);
 186
 187 void b43legacy_set_rx_antenna(struct b43legacy_wldev *dev, int antenna);
 188
 189 void b43legacy_phy_set_antenna_diversity(struct b43legacy_wldev *dev);
 190 void b43legacy_phy_calibrate(struct b43legacy_wldev *dev);
 191 int b43legacy_phy_connect(struct b43legacy_wldev *dev, int connect);
 192
 193 void b43legacy_phy_lo_b_measure(struct b43legacy_wldev *dev);
 194 void b43legacy_phy_lo_g_measure(struct b43legacy_wldev *dev);
 195 void b43legacy_phy_xmitpower(struct b43legacy_wldev *dev);
 196
 197 /* Adjust the LocalOscillator to the saved values.
 198  * "fixed" is only set to 1 once in initialization. Set to 0 otherwise.
 199  */
 200 void b43legacy_phy_lo_adjust(struct b43legacy_wldev *dev, int fixed);
 201 void b43legacy_phy_lo_mark_all_unused(struct b43legacy_wldev *dev);
 202
 203 void b43legacy_phy_set_baseband_attenuation(struct b43legacy_wldev *dev,
 204                                             u16 baseband_attenuation);
 205
 206 void b43legacy_power_saving_ctl_bits(struct b43legacy_wldev *dev,
 207                                      int bit25, int bit26);
 208
 209 #endif /* B43legacy_PHY_H_ */