sys/dev/netif/ath/hal/ath_hal/ah_eeprom_v4k.h

   1 /*
   2  * Copyright (c) 2009 Rui Paulo <rpaulo@FreeBSD.org>
   3  * Copyright (c) 2008 Sam Leffler, Errno Consulting
   4  * Copyright (c) 2008 Atheros Communications, Inc.
   5  *
   6  * Permission to use, copy, modify, and/or distribute this software for any
   7  * purpose with or without fee is hereby granted, provided that the above
   8  * copyright notice and this permission notice appear in all copies.
   9  *
  10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17  *
  18  * $FreeBSD: head/sys/dev/ath/ath_hal/ah_eeprom_v4k.h 203159 2010-01-29 10:10:14Z rpaulo $
  19  * $DragonFly$
  20  */
  21 #ifndef _AH_EEPROM_V4K_H_
  22 #define _AH_EEPROM_V4K_H_
  23
  24 #include "ah_eeprom.h"
  25 #include "ah_eeprom_v14.h"
  26
  27 #undef owl_eep_start_loc
  28 #ifdef __LINUX_ARM_ARCH__ /* AP71 */
  29 #define owl_eep_start_loc               0
  30 #else
  31 #define owl_eep_start_loc               64
  32 #endif
  33
  34 // 16-bit offset location start of calibration struct
  35 #define AR5416_4K_EEP_START_LOC         64
  36 #define AR5416_4K_NUM_2G_CAL_PIERS      3
  37 #define AR5416_4K_NUM_2G_CCK_TARGET_POWERS 3
  38 #define AR5416_4K_NUM_2G_20_TARGET_POWERS  3
  39 #define AR5416_4K_NUM_2G_40_TARGET_POWERS  3
  40 #define AR5416_4K_NUM_CTLS              12
  41 #define AR5416_4K_NUM_BAND_EDGES        4
  42 #define AR5416_4K_NUM_PD_GAINS          2
  43 #define AR5416_4K_MAX_CHAINS            1
  44
  45 /*
  46  * NB: The format in EEPROM has words 0 and 2 swapped (i.e. version
  47  * and length are swapped).  We reverse their position after reading
  48  * the data into host memory so the version field is at the same
  49  * offset as in previous EEPROM layouts.  This makes utilities that
  50  * inspect the EEPROM contents work without looking at the PCI device
  51  * id which may or may not be reliable.
  52  */
  53 typedef struct BaseEepHeader4k {
  54         uint16_t        version;        /* NB: length in EEPROM */
  55         uint16_t        checksum;
  56         uint16_t        length;         /* NB: version in EEPROM */
  57         uint8_t         opCapFlags;
  58         uint8_t         eepMisc;
  59         uint16_t        regDmn[2];
  60         uint8_t         macAddr[6];
  61         uint8_t         rxMask;
  62         uint8_t         txMask;
  63         uint16_t        rfSilent;
  64         uint16_t        blueToothOptions;
  65         uint16_t        deviceCap;
  66         uint32_t        binBuildNumber;
  67         uint8_t         deviceType;
  68         uint8_t         txGainType;     /* high power tx gain table support */
  69 } __packed BASE_EEP4K_HEADER; // 32 B
  70
  71 typedef struct ModalEepHeader4k {
  72         uint32_t        antCtrlChain[AR5416_4K_MAX_CHAINS];     // 12
  73         uint32_t        antCtrlCommon;                          // 4
  74         int8_t          antennaGainCh[AR5416_4K_MAX_CHAINS];    // 1
  75         uint8_t         switchSettling;                         // 1
  76         uint8_t         txRxAttenCh[AR5416_4K_MAX_CHAINS];              // 1
  77         uint8_t         rxTxMarginCh[AR5416_4K_MAX_CHAINS];     // 1
  78         uint8_t         adcDesiredSize;                         // 1
  79         int8_t          pgaDesiredSize;                         // 1
  80         uint8_t         xlnaGainCh[AR5416_4K_MAX_CHAINS];               // 1
  81         uint8_t         txEndToXpaOff;                          // 1
  82         uint8_t         txEndToRxOn;                            // 1
  83         uint8_t         txFrameToXpaOn;                         // 1
  84         uint8_t         thresh62;                               // 1
  85         uint8_t         noiseFloorThreshCh[AR5416_4K_MAX_CHAINS];       // 1
  86         uint8_t         xpdGain;                                // 1
  87         uint8_t         xpd;                                    // 1
  88         int8_t          iqCalICh[AR5416_4K_MAX_CHAINS];         // 1
  89         int8_t          iqCalQCh[AR5416_4K_MAX_CHAINS];         // 1
  90         uint8_t         pdGainOverlap;                          // 1
  91         uint8_t         ob;                                     // 1
  92         uint8_t         db;                                     // 1
  93         uint8_t         xpaBiasLvl;                             // 1
  94 #if 0
  95         uint8_t         pwrDecreaseFor2Chain;                   // 1
  96         uint8_t         pwrDecreaseFor3Chain;                   // 1 -> 48 B
  97 #endif
  98         uint8_t         txFrameToDataStart;                     // 1
  99         uint8_t         txFrameToPaOn;                          // 1
 100         uint8_t         ht40PowerIncForPdadc;                   // 1
 101         uint8_t         bswAtten[AR5416_4K_MAX_CHAINS];         // 1
 102         uint8_t         bswMargin[AR5416_4K_MAX_CHAINS];        // 1
 103         uint8_t         swSettleHt40;                           // 1
 104         uint8_t         xatten2Db[AR5416_4K_MAX_CHAINS];        // 1
 105         uint8_t         xatten2Margin[AR5416_4K_MAX_CHAINS];    // 1
 106         uint8_t         ob_ch1;                         // 1 -> ob and db become chain specific from AR9280
 107         uint8_t         db_ch1;                         // 1
 108         uint8_t         flagBits;                       // 1
 109 #define AR5416_EEP_FLAG_USEANT1         0x01    /* +1 configured antenna */
 110 #define AR5416_EEP_FLAG_FORCEXPAON      0x02    /* force XPA bit for 5G */
 111 #define AR5416_EEP_FLAG_LOCALBIAS       0x04    /* enable local bias */
 112 #define AR5416_EEP_FLAG_FEMBANDSELECT   0x08    /* FEM band select used */
 113 #define AR5416_EEP_FLAG_XLNABUFIN       0x10
 114 #define AR5416_EEP_FLAG_XLNAISEL        0x60
 115 #define AR5416_EEP_FLAG_XLNAISEL_S      5
 116 #define AR5416_EEP_FLAG_XLNABUFMODE     0x80
 117         uint8_t         miscBits;                       // [0..1]: bb_tx_dac_scale_cck
 118         uint16_t        xpaBiasLvlFreq[3];              // 6
 119         uint8_t         futureModal[2];                 // 2
 120
 121         SPUR_CHAN spurChans[AR5416_EEPROM_MODAL_SPURS]; // 20 B
 122 } __packed MODAL_EEP4K_HEADER;                          // == 68 B
 123
 124 typedef struct CalCtlData4k {
 125         CAL_CTL_EDGES           ctlEdges[AR5416_4K_MAX_CHAINS][AR5416_4K_NUM_BAND_EDGES];
 126 } __packed CAL_CTL_DATA_4K;
 127
 128 typedef struct calDataPerFreq4k {
 129         uint8_t         pwrPdg[AR5416_4K_NUM_PD_GAINS][AR5416_PD_GAIN_ICEPTS];
 130         uint8_t         vpdPdg[AR5416_4K_NUM_PD_GAINS][AR5416_PD_GAIN_ICEPTS];
 131 } __packed CAL_DATA_PER_FREQ_4K;
 132
 133 struct ar5416eeprom_4k {
 134         BASE_EEP4K_HEADER       baseEepHeader;         // 32 B
 135         uint8_t                 custData[20];          // 20 B
 136         MODAL_EEP4K_HEADER      modalHeader;           // 68 B
 137         uint8_t                 calFreqPier2G[AR5416_4K_NUM_2G_CAL_PIERS];
 138         CAL_DATA_PER_FREQ_4K    calPierData2G[AR5416_4K_MAX_CHAINS][AR5416_4K_NUM_2G_CAL_PIERS];
 139         CAL_TARGET_POWER_LEG    calTargetPowerCck[AR5416_4K_NUM_2G_CCK_TARGET_POWERS];
 140         CAL_TARGET_POWER_LEG    calTargetPower2G[AR5416_4K_NUM_2G_20_TARGET_POWERS];
 141         CAL_TARGET_POWER_HT     calTargetPower2GHT20[AR5416_4K_NUM_2G_20_TARGET_POWERS];
 142         CAL_TARGET_POWER_HT     calTargetPower2GHT40[AR5416_4K_NUM_2G_40_TARGET_POWERS];
 143         uint8_t                 ctlIndex[AR5416_4K_NUM_CTLS];
 144         CAL_CTL_DATA_4K         ctlData[AR5416_4K_NUM_CTLS];
 145         uint8_t                 padding;
 146 } __packed;
 147
 148 typedef struct {
 149         struct ar5416eeprom_4k ee_base;
 150 #define NUM_EDGES        8
 151         uint16_t        ee_numCtls;
 152         RD_EDGES_POWER  ee_rdEdgesPower[NUM_EDGES*AR5416_4K_NUM_CTLS];
 153         /* XXX these are dynamically calculated for use by shared code */
 154         int8_t          ee_antennaGainMax[2];
 155 } HAL_EEPROM_v4k;
 156 #endif /* _AH_EEPROM_V4K_H_ */