Quelle  rtw8723x.h

/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
/* Copyright 2024 Fiona Klute
 *
 * Based on code originally in rtw8723d.[ch],
 * Copyright(c) 2018-2019  Realtek Corporation
 */

#ifndef __RTW8723X_H__
#define __RTW8723X_H__

#include "main.h"
#include "debug.h"
#include "phy.h"
#include "reg.h"

enum rtw8723x_path {
 PATH_S1,
 PATH_S0,
 PATH_NR,
};

enum rtw8723x_iqk_round {
 IQK_ROUND_0,
 IQK_ROUND_1,
 IQK_ROUND_2,
 IQK_ROUND_HYBRID,
 IQK_ROUND_SIZE,
 IQK_ROUND_INVALID = 0xff,
};

enum rtw8723x_iqk_result {
 IQK_S1_TX_X,
 IQK_S1_TX_Y,
 IQK_S1_RX_X,
 IQK_S1_RX_Y,
 IQK_S0_TX_X,
 IQK_S0_TX_Y,
 IQK_S0_RX_X,
 IQK_S0_RX_Y,
 IQK_NR,
 IQK_SX_NR = IQK_NR / PATH_NR,
};

struct rtw8723xe_efuse {
 u8 mac_addr[ETH_ALEN];  /* 0xd0 */
 u8 vendor_id[2];
 u8 device_id[2];
 u8 sub_vendor_id[2];
 u8 sub_device_id[2];
} __packed;

struct rtw8723xu_efuse {
 u8 res4[48];                    /* 0xd0 */
 u8 vendor_id[2];                /* 0x100 */
 u8 product_id[2];               /* 0x102 */
 u8 usb_option;                  /* 0x104 */
 u8 res5[2];   /* 0x105 */
 u8 mac_addr[ETH_ALEN];          /* 0x107 */
} __packed;

struct rtw8723xs_efuse {
 u8 res4[0x4a];   /* 0xd0 */
 u8 mac_addr[ETH_ALEN];  /* 0x11a */
} __packed;

struct rtw8723x_efuse {
 __le16 rtl_id;
 u8 rsvd[2];
 u8 afe;
 u8 rsvd1[11];

 /* power index for four RF paths */
 struct rtw_txpwr_idx txpwr_idx_table[4];

 u8 channel_plan;  /* 0xb8 */
 u8 xtal_k;
 u8 thermal_meter;
 u8 iqk_lck;
 u8 pa_type;   /* 0xbc */
 u8 lna_type_2g[2];  /* 0xbd */
 u8 lna_type_5g[2];
 u8 rf_board_option;
 u8 rf_feature_option;
 u8 rf_bt_setting;
 u8 eeprom_version;
 u8 eeprom_customer_id;
 u8 tx_bb_swing_setting_2g;
 u8 res_c7;
 u8 tx_pwr_calibrate_rate;
 u8 rf_antenna_option;  /* 0xc9 */
 u8 rfe_option;
 u8 country_code[2];
 u8 res[3];
 union {
  struct rtw8723xe_efuse e;
  struct rtw8723xu_efuse u;
  struct rtw8723xs_efuse s;
 };
} __packed;

#define RTW8723X_IQK_ADDA_REG_NUM 16
#define RTW8723X_IQK_MAC8_REG_NUM 3
#define RTW8723X_IQK_MAC32_REG_NUM 1
#define RTW8723X_IQK_BB_REG_NUM  9

struct rtw8723x_iqk_backup_regs {
 u32 adda[RTW8723X_IQK_ADDA_REG_NUM];
 u8 mac8[RTW8723X_IQK_MAC8_REG_NUM];
 u32 mac32[RTW8723X_IQK_MAC32_REG_NUM];
 u32 bb[RTW8723X_IQK_BB_REG_NUM];

 u32 lte_path;
 u32 lte_gnt;

 u32 bb_sel_btg;
 u8 btg_sel;

 u8 igia;
 u8 igib;
};

struct rtw8723x_common {
 /* registers that must be backed up before IQK and restored after */
 u32 iqk_adda_regs[RTW8723X_IQK_ADDA_REG_NUM];
 u32 iqk_mac8_regs[RTW8723X_IQK_MAC8_REG_NUM];
 u32 iqk_mac32_regs[RTW8723X_IQK_MAC32_REG_NUM];
 u32 iqk_bb_regs[RTW8723X_IQK_BB_REG_NUM];

 /* chip register definitions */
 struct rtw_ltecoex_addr ltecoex_addr;
 struct rtw_rf_sipi_addr rf_sipi_addr[2];
 struct rtw_hw_reg dig[2];
 struct rtw_hw_reg dig_cck[1];
 struct rtw_prioq_addrs prioq_addrs;

 /* common functions */
 void (*lck)(struct rtw_dev *rtwdev);
 int (*read_efuse)(struct rtw_dev *rtwdev, u8 *log_map);
 int (*mac_init)(struct rtw_dev *rtwdev);
 int (*mac_postinit)(struct rtw_dev *rtwdev);
 void (*cfg_ldo25)(struct rtw_dev *rtwdev, bool enable);
 void (*set_tx_power_index)(struct rtw_dev *rtwdev);
 void (*efuse_grant)(struct rtw_dev *rtwdev, bool on);
 void (*false_alarm_statistics)(struct rtw_dev *rtwdev);
 void (*iqk_backup_regs)(struct rtw_dev *rtwdev,
    struct rtw8723x_iqk_backup_regs *backup);
 void (*iqk_restore_regs)(struct rtw_dev *rtwdev,
     const struct rtw8723x_iqk_backup_regs *backup);
 bool (*iqk_similarity_cmp)(struct rtw_dev *rtwdev, s32 result[][IQK_NR],
       u8 c1, u8 c2);
 u8 (*pwrtrack_get_limit_ofdm)(struct rtw_dev *rtwdev);
 void (*pwrtrack_set_xtal)(struct rtw_dev *rtwdev, u8 therm_path,
      u8 delta);
 void (*coex_cfg_init)(struct rtw_dev *rtwdev);
 void (*fill_txdesc_checksum)(struct rtw_dev *rtwdev,
         struct rtw_tx_pkt_info *pkt_info,
         u8 *txdesc);
 void (*debug_txpwr_limit)(struct rtw_dev *rtwdev,
      struct rtw_txpwr_idx *table,
      int tx_path_count);
};

extern const struct rtw8723x_common rtw8723x_common;

#define PATH_IQK_RETRY 2
#define MAX_TOLERANCE 5
#define IQK_TX_X_ERR 0x142
#define IQK_TX_Y_ERR 0x42
#define IQK_RX_X_ERR 0x132
#define IQK_RX_Y_ERR 0x36
#define IQK_RX_X_UPPER 0x11a
#define IQK_RX_X_LOWER 0xe6
#define IQK_RX_Y_LMT 0x1a
#define IQK_TX_OK BIT(0)
#define IQK_RX_OK BIT(1)

#define WLAN_TXQ_RPT_EN  0x1F

#define SPUR_THRES  0x16
#define DIS_3WIRE  0xccf000c0
#define EN_3WIRE  0xccc000c0
#define START_PSD  0x400000
#define FREQ_CH5  0xfccd
#define FREQ_CH6  0xfc4d
#define FREQ_CH7  0xffcd
#define FREQ_CH8  0xff4d
#define FREQ_CH13  0xfccd
#define FREQ_CH14  0xff9a
#define RFCFGCH_CHANNEL_MASK GENMASK(7, 0)
#define RFCFGCH_BW_MASK  (BIT(11) | BIT(10))
#define RFCFGCH_BW_20M  (BIT(11) | BIT(10))
#define RFCFGCH_BW_40M  BIT(10)
#define BIT_MASK_RFMOD  BIT(0)
#define BIT_LCK   BIT(15)

#define REG_GPIO_INTM  0x0048
#define REG_BTG_SEL  0x0067
#define BIT_MASK_BTG_WL  BIT(7)
#define REG_LTECOEX_PATH_CONTROL 0x0070
#define REG_LTECOEX_CTRL 0x07c0
#define REG_LTECOEX_WRITE_DATA 0x07c4
#define REG_LTECOEX_READ_DATA 0x07c8
#define REG_PSDFN  0x0808
#define REG_BB_PWR_SAV1_11N 0x0874
#define REG_ANA_PARAM1  0x0880
#define REG_ANALOG_P4  0x088c
#define REG_PSDRPT  0x08b4
#define REG_FPGA1_RFMOD  0x0900
#define REG_BB_SEL_BTG  0x0948
#define REG_BBRX_DFIR  0x0954
#define BIT_MASK_RXBB_DFIR GENMASK(27, 24)
#define BIT_RXBB_DFIR_EN BIT(19)
#define REG_CCK0_SYS  0x0a00
#define BIT_CCK_SIDE_BAND BIT(4)
#define REG_CCK_ANT_SEL_11N 0x0a04
#define REG_PWRTH  0x0a08
#define REG_CCK_FA_RST_11N 0x0a2c
#define BIT_MASK_CCK_CNT_KEEP BIT(12)
#define BIT_MASK_CCK_CNT_EN BIT(13)
#define BIT_MASK_CCK_CNT_KPEN (BIT_MASK_CCK_CNT_KEEP | BIT_MASK_CCK_CNT_EN)
#define BIT_MASK_CCK_FA_KEEP BIT(14)
#define BIT_MASK_CCK_FA_EN BIT(15)
#define BIT_MASK_CCK_FA_KPEN (BIT_MASK_CCK_FA_KEEP | BIT_MASK_CCK_FA_EN)
#define REG_CCK_FA_LSB_11N 0x0a5c
#define REG_CCK_FA_MSB_11N 0x0a58
#define REG_CCK_CCA_CNT_11N 0x0a60
#define BIT_MASK_CCK_FA_MSB GENMASK(7, 0)
#define BIT_MASK_CCK_FA_LSB GENMASK(15, 8)
#define REG_PWRTH2  0x0aa8
#define REG_CSRATIO  0x0aaa
#define REG_OFDM_FA_HOLDC_11N 0x0c00
#define BIT_MASK_OFDM_FA_KEEP BIT(31)
#define REG_BB_RX_PATH_11N 0x0c04
#define REG_TRMUX_11N  0x0c08
#define REG_OFDM_FA_RSTC_11N 0x0c0c
#define BIT_MASK_OFDM_FA_RST BIT(31)
#define REG_A_RXIQI  0x0c14
#define BIT_MASK_RXIQ_S1_X 0x000003FF
#define BIT_MASK_RXIQ_S1_Y1 0x0000FC00
#define BIT_SET_RXIQ_S1_Y1(y) ((y) & 0x3F)
#define REG_OFDM0_RXDSP  0x0c40
#define BIT_MASK_RXDSP  GENMASK(28, 24)
#define BIT_EN_RXDSP  BIT(9)
#define REG_OFDM_0_ECCA_THRESHOLD 0x0c4c
#define BIT_MASK_OFDM0_EXT_A BIT(31)
#define BIT_MASK_OFDM0_EXT_C BIT(29)
#define BIT_MASK_OFDM0_EXTS (BIT(31) | BIT(29) | BIT(28))
#define BIT_SET_OFDM0_EXTS(a, c, d) (((a) << 31) | ((c) << 29) | ((d) << 28))
#define BIT_MASK_OFDM0_EXTS_B (BIT(27) | BIT(25) | BIT(24))
#define BIT_SET_OFDM0_EXTS_B(a, c, d) (((a) << 27) | ((c) << 25) | ((d) << 24))
#define REG_OFDM0_XAAGC1 0x0c50
#define REG_OFDM0_XBAGC1 0x0c58
#define REG_AGCRSSI  0x0c78
#define REG_OFDM_0_XA_TX_IQ_IMBALANCE 0x0c80
#define REG_OFDM_0_XB_TX_IQ_IMBALANCE 0x0c88
#define BIT_MASK_TXIQ_ELM_A 0x03ff
#define BIT_SET_TXIQ_ELM_ACD(a, c, d) (((d) << 22) | (((c) & 0x3F) << 16) |    \
           ((a) & 0x03ff))
#define BIT_MASK_TXIQ_ELM_C GENMASK(21, 16)
#define BIT_SET_TXIQ_ELM_C2(c) ((c) & 0x3F)
#define BIT_MASK_TXIQ_ELM_D GENMASK(31, 22)
#define REG_TXIQK_MATRIXA_LSB2_11N 0x0c94
#define BIT_SET_TXIQ_ELM_C1(c) (((c) & 0x000003C0) >> 6)
#define REG_RXIQK_MATRIX_LSB_11N 0x0ca0
#define BIT_MASK_RXIQ_S1_Y2 0xF0000000
#define BIT_SET_RXIQ_S1_Y2(y) (((y) >> 6) & 0xF)
#define REG_TXIQ_AB_S0  0x0cd0
#define BIT_MASK_TXIQ_A_S0 0x000007FE
#define BIT_MASK_TXIQ_A_EXT_S0 BIT(0)
#define BIT_MASK_TXIQ_B_S0 0x0007E000
#define REG_TXIQ_CD_S0  0x0cd4
#define BIT_MASK_TXIQ_C_S0 0x000007FE
#define BIT_MASK_TXIQ_C_EXT_S0 BIT(0)
#define BIT_MASK_TXIQ_D_S0 GENMASK(22, 13)
#define BIT_MASK_TXIQ_D_EXT_S0 BIT(12)
#define REG_RXIQ_AB_S0  0x0cd8
#define BIT_MASK_RXIQ_X_S0 0x000003FF
#define BIT_MASK_RXIQ_Y_S0 0x003FF000
#define REG_OFDM_FA_TYPE1_11N 0x0cf0
#define BIT_MASK_OFDM_FF_CNT GENMASK(15, 0)
#define BIT_MASK_OFDM_SF_CNT GENMASK(31, 16)
#define REG_OFDM_FA_RSTD_11N 0x0d00
#define BIT_MASK_OFDM_FA_RST1 BIT(27)
#define BIT_MASK_OFDM_FA_KEEP1 BIT(31)
#define REG_CTX   0x0d03
#define BIT_MASK_CTX_TYPE GENMASK(6, 4)
#define REG_OFDM1_CFOTRK 0x0d2c
#define BIT_EN_CFOTRK  BIT(28)
#define REG_OFDM1_CSI1  0x0d40
#define REG_OFDM1_CSI2  0x0d44
#define REG_OFDM1_CSI3  0x0d48
#define REG_OFDM1_CSI4  0x0d4c
#define REG_OFDM_FA_TYPE2_11N 0x0da0
#define BIT_MASK_OFDM_CCA_CNT GENMASK(15, 0)
#define BIT_MASK_OFDM_PF_CNT GENMASK(31, 16)
#define REG_OFDM_FA_TYPE3_11N 0x0da4
#define BIT_MASK_OFDM_RI_CNT GENMASK(15, 0)
#define BIT_MASK_OFDM_CRC_CNT GENMASK(31, 16)
#define REG_OFDM_FA_TYPE4_11N 0x0da8
#define BIT_MASK_OFDM_MNS_CNT GENMASK(15, 0)
#define REG_FPGA0_IQK_11N 0x0e28
#define BIT_MASK_IQK_MOD 0xffffff00
#define EN_IQK   0x808000
#define RST_IQK   0x000000
#define REG_TXIQK_TONE_A_11N 0x0e30
#define REG_RXIQK_TONE_A_11N 0x0e34
#define REG_TXIQK_PI_A_11N 0x0e38
#define REG_RXIQK_PI_A_11N 0x0e3c
#define REG_TXIQK_11N  0x0e40
#define BIT_SET_TXIQK_11N(x, y) (0x80007C00 | ((x) << 16) | (y))
#define REG_RXIQK_11N  0x0e44
#define REG_IQK_AGC_PTS_11N 0x0e48
#define REG_IQK_AGC_RSP_11N 0x0e4c
#define REG_TX_IQK_TONE_B 0x0e50
#define REG_RX_IQK_TONE_B 0x0e54
#define REG_TXIQK_PI_B  0x0e58
#define REG_RXIQK_PI_B  0x0e5c
#define REG_IQK_RES_TX  0x0e94
#define BIT_MASK_RES_TX  GENMASK(25, 16)
#define REG_IQK_RES_TY  0x0e9c
#define BIT_MASK_RES_TY  GENMASK(25, 16)
#define REG_IQK_RES_RX  0x0ea4
#define BIT_MASK_RES_RX  GENMASK(25, 16)
#define REG_IQK_RES_RY  0x0eac
#define BIT_IQK_TX_FAIL  BIT(28)
#define BIT_IQK_RX_FAIL  BIT(27)
#define BIT_IQK_DONE  BIT(26)
#define BIT_MASK_RES_RY  GENMASK(25, 16)
#define REG_PAGE_F_RST_11N  0x0f14
#define BIT_MASK_F_RST_ALL  BIT(16)
#define REG_IGI_C_11N   0x0f84
#define REG_IGI_D_11N   0x0f88
#define REG_HT_CRC32_CNT_11N  0x0f90
#define BIT_MASK_HT_CRC_OK  GENMASK(15, 0)
#define BIT_MASK_HT_CRC_ERR  GENMASK(31, 16)
#define REG_OFDM_CRC32_CNT_11N  0x0f94
#define BIT_MASK_OFDM_LCRC_OK  GENMASK(15, 0)
#define BIT_MASK_OFDM_LCRC_ERR  GENMASK(31, 16)
#define REG_HT_CRC32_CNT_11N_AGG 0x0fb8

#define OFDM_SWING_A(swing)  FIELD_GET(GENMASK(9, 0), swing)
#define OFDM_SWING_B(swing)  FIELD_GET(GENMASK(15, 10), swing)
#define OFDM_SWING_C(swing)  FIELD_GET(GENMASK(21, 16), swing)
#define OFDM_SWING_D(swing)  FIELD_GET(GENMASK(31, 22), swing)

static inline s32 iqkxy_to_s32(s32 val)
{
 /* val is Q10.8 */
 return sign_extend32(val, 9);
}

static inline s32 iqk_mult(s32 x, s32 y, s32 *ext)
{
 /* x, y and return value are Q10.8 */
 s32 t;

 t = x * y;
 if (ext)
  *ext = (t >> 7) & 0x1; /* Q.16 --> Q.9; get LSB of Q.9 */

 return (t >> 8); /* Q.16 --> Q.8 */
}

static inline
void rtw8723x_debug_txpwr_limit(struct rtw_dev *rtwdev,
    struct rtw_txpwr_idx *table,
    int tx_path_count)
{
 rtw8723x_common.debug_txpwr_limit(rtwdev, table, tx_path_count);
}

static inline void rtw8723x_lck(struct rtw_dev *rtwdev)
{
 rtw8723x_common.lck(rtwdev);
}

static inline int rtw8723x_read_efuse(struct rtw_dev *rtwdev, u8 *log_map)
{
 return rtw8723x_common.read_efuse(rtwdev, log_map);
}

static inline int rtw8723x_mac_init(struct rtw_dev *rtwdev)
{
 return rtw8723x_common.mac_init(rtwdev);
}

static inline int rtw8723x_mac_postinit(struct rtw_dev *rtwdev)
{
 return rtw8723x_common.mac_postinit(rtwdev);
}

static inline void rtw8723x_cfg_ldo25(struct rtw_dev *rtwdev, bool enable)
{
 rtw8723x_common.cfg_ldo25(rtwdev, enable);
}

static inline void rtw8723x_set_tx_power_index(struct rtw_dev *rtwdev)
{
 rtw8723x_common.set_tx_power_index(rtwdev);
}

static inline void rtw8723x_efuse_grant(struct rtw_dev *rtwdev, bool on)
{
 rtw8723x_common.efuse_grant(rtwdev, on);
}

static inline void rtw8723x_false_alarm_statistics(struct rtw_dev *rtwdev)
{
 rtw8723x_common.false_alarm_statistics(rtwdev);
}

static inline
void rtw8723x_iqk_backup_regs(struct rtw_dev *rtwdev,
         struct rtw8723x_iqk_backup_regs *backup)
{
 rtw8723x_common.iqk_backup_regs(rtwdev, backup);
}

static inline
void rtw8723x_iqk_restore_regs(struct rtw_dev *rtwdev,
          const struct rtw8723x_iqk_backup_regs *backup)
{
 rtw8723x_common.iqk_restore_regs(rtwdev, backup);
}

static inline
bool rtw8723x_iqk_similarity_cmp(struct rtw_dev *rtwdev, s32 result[][IQK_NR],
     u8 c1, u8 c2)
{
 return rtw8723x_common.iqk_similarity_cmp(rtwdev, result, c1, c2);
}

static inline u8 rtw8723x_pwrtrack_get_limit_ofdm(struct rtw_dev *rtwdev)
{
 return rtw8723x_common.pwrtrack_get_limit_ofdm(rtwdev);
}

static inline
void rtw8723x_pwrtrack_set_xtal(struct rtw_dev *rtwdev, u8 therm_path,
    u8 delta)
{
 rtw8723x_common.pwrtrack_set_xtal(rtwdev, therm_path, delta);
}

static inline void rtw8723x_coex_cfg_init(struct rtw_dev *rtwdev)
{
 rtw8723x_common.coex_cfg_init(rtwdev);
}

static inline
void rtw8723x_fill_txdesc_checksum(struct rtw_dev *rtwdev,
       struct rtw_tx_pkt_info *pkt_info,
       u8 *txdesc)
{
 rtw8723x_common.fill_txdesc_checksum(rtwdev, pkt_info, txdesc);
}

/* IQK helper functions, defined as inline so they can be shared
 * without needing an EXPORT_SYMBOL each.
 */
static inline void
rtw8723x_iqk_backup_path_ctrl(struct rtw_dev *rtwdev,
         struct rtw8723x_iqk_backup_regs *backup)
{
 backup->btg_sel = rtw_read8(rtwdev, REG_BTG_SEL);
 rtw_dbg(rtwdev, RTW_DBG_RFK, "[IQK] original 0x67 = 0x%x\n",
  backup->btg_sel);
}

static inline void rtw8723x_iqk_config_path_ctrl(struct rtw_dev *rtwdev)
{
 rtw_write32_mask(rtwdev, REG_PAD_CTRL1, BIT_BT_BTG_SEL, 0x1);
 rtw_dbg(rtwdev, RTW_DBG_RFK, "[IQK] set 0x67 = 0x%x\n",
  rtw_read32_mask(rtwdev, REG_PAD_CTRL1, MASKBYTE3));
}

static inline void
rtw8723x_iqk_restore_path_ctrl(struct rtw_dev *rtwdev,
          const struct rtw8723x_iqk_backup_regs *backup)
{
 rtw_write8(rtwdev, REG_BTG_SEL, backup->btg_sel);
 rtw_dbg(rtwdev, RTW_DBG_RFK, "[IQK] restore 0x67 = 0x%x\n",
  rtw_read32_mask(rtwdev, REG_PAD_CTRL1, MASKBYTE3));
}

static inline void
rtw8723x_iqk_backup_lte_path_gnt(struct rtw_dev *rtwdev,
     struct rtw8723x_iqk_backup_regs *backup)
{
 backup->lte_path = rtw_read32(rtwdev, REG_LTECOEX_PATH_CONTROL);
 rtw_write32(rtwdev, REG_LTECOEX_CTRL, 0x800f0038);
 mdelay(1);
 backup->lte_gnt = rtw_read32(rtwdev, REG_LTECOEX_READ_DATA);
 rtw_dbg(rtwdev, RTW_DBG_RFK, "[IQK] OriginalGNT = 0x%x\n",
  backup->lte_gnt);
}

static inline void
rtw8723x_iqk_config_lte_path_gnt(struct rtw_dev *rtwdev,
     u32 write_data)
{
 rtw_write32(rtwdev, REG_LTECOEX_WRITE_DATA, write_data);
 rtw_write32(rtwdev, REG_LTECOEX_CTRL, 0xc0020038);
 rtw_write32_mask(rtwdev, REG_LTECOEX_PATH_CONTROL,
    BIT_LTE_MUX_CTRL_PATH, 0x1);
}

static inline void
rtw8723x_iqk_restore_lte_path_gnt(struct rtw_dev *rtwdev,
      const struct rtw8723x_iqk_backup_regs *bak)
{
 rtw_write32(rtwdev, REG_LTECOEX_WRITE_DATA, bak->lte_gnt);
 rtw_write32(rtwdev, REG_LTECOEX_CTRL, 0xc00f0038);
 rtw_write32(rtwdev, REG_LTECOEX_PATH_CONTROL, bak->lte_path);
}

/* set all ADDA registers to the given value */
static inline void rtw8723x_iqk_path_adda_on(struct rtw_dev *rtwdev, u32 value)
{
 for (int i = 0; i < RTW8723X_IQK_ADDA_REG_NUM; i++)
  rtw_write32(rtwdev, rtw8723x_common.iqk_adda_regs[i], value);
}

#endif /* __RTW8723X_H__ */