root/drivers/net/wireless/ath/ath10k/hw.h
/* SPDX-License-Identifier: ISC */
/*
 * Copyright (c) 2005-2011 Atheros Communications Inc.
 * Copyright (c) 2011-2017 Qualcomm Atheros, Inc.
 * Copyright (c) 2018 The Linux Foundation. All rights reserved.
 * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
 */

#ifndef _HW_H_
#define _HW_H_

#include "targaddrs.h"

enum ath10k_bus {
        ATH10K_BUS_PCI,
        ATH10K_BUS_AHB,
        ATH10K_BUS_SDIO,
        ATH10K_BUS_USB,
        ATH10K_BUS_SNOC,
};

#define ATH10K_FW_DIR                   "ath10k"

#define QCA988X_2_0_DEVICE_ID_UBNT   (0x11ac)
#define QCA988X_2_0_DEVICE_ID   (0x003c)
#define QCA6164_2_1_DEVICE_ID   (0x0041)
#define QCA6174_2_1_DEVICE_ID   (0x003e)
#define QCA6174_3_2_DEVICE_ID   (0x0042)
#define QCA99X0_2_0_DEVICE_ID   (0x0040)
#define QCA9888_2_0_DEVICE_ID   (0x0056)
#define QCA9984_1_0_DEVICE_ID   (0x0046)
#define QCA9377_1_0_DEVICE_ID   (0x0042)
#define QCA9887_1_0_DEVICE_ID   (0x0050)

/* QCA988X 1.0 definitions (unsupported) */
#define QCA988X_HW_1_0_CHIP_ID_REV      0x0

/* QCA988X 2.0 definitions */
#define QCA988X_HW_2_0_VERSION          0x4100016c
#define QCA988X_HW_2_0_CHIP_ID_REV      0x2
#define QCA988X_HW_2_0_FW_DIR           ATH10K_FW_DIR "/QCA988X/hw2.0"
#define QCA988X_HW_2_0_PATCH_LOAD_ADDR  0x1234

/* QCA9887 1.0 definitions */
#define QCA9887_HW_1_0_VERSION          0x4100016d
#define QCA9887_HW_1_0_CHIP_ID_REV      0
#define QCA9887_HW_1_0_FW_DIR           ATH10K_FW_DIR "/QCA9887/hw1.0"
#define QCA9887_HW_1_0_PATCH_LOAD_ADDR  0x1234

/* QCA6174 target BMI version signatures */
#define QCA6174_HW_1_0_VERSION          0x05000000
#define QCA6174_HW_1_1_VERSION          0x05000001
#define QCA6174_HW_1_3_VERSION          0x05000003
#define QCA6174_HW_2_1_VERSION          0x05010000
#define QCA6174_HW_3_0_VERSION          0x05020000
#define QCA6174_HW_3_2_VERSION          0x05030000

/* QCA9377 target BMI version signatures */
#define QCA9377_HW_1_0_DEV_VERSION      0x05020000
#define QCA9377_HW_1_1_DEV_VERSION      0x05020001

enum qca6174_pci_rev {
        QCA6174_PCI_REV_1_1 = 0x11,
        QCA6174_PCI_REV_1_3 = 0x13,
        QCA6174_PCI_REV_2_0 = 0x20,
        QCA6174_PCI_REV_3_0 = 0x30,
};

enum qca6174_chip_id_rev {
        QCA6174_HW_1_0_CHIP_ID_REV = 0,
        QCA6174_HW_1_1_CHIP_ID_REV = 1,
        QCA6174_HW_1_3_CHIP_ID_REV = 2,
        QCA6174_HW_2_1_CHIP_ID_REV = 4,
        QCA6174_HW_2_2_CHIP_ID_REV = 5,
        QCA6174_HW_3_0_CHIP_ID_REV = 8,
        QCA6174_HW_3_1_CHIP_ID_REV = 9,
        QCA6174_HW_3_2_CHIP_ID_REV = 10,
};

enum qca9377_chip_id_rev {
        QCA9377_HW_1_0_CHIP_ID_REV = 0x0,
        QCA9377_HW_1_1_CHIP_ID_REV = 0x1,
};

#define QCA6174_HW_2_1_FW_DIR           ATH10K_FW_DIR "/QCA6174/hw2.1"
#define QCA6174_HW_2_1_PATCH_LOAD_ADDR  0x1234

#define QCA6174_HW_3_0_FW_DIR           ATH10K_FW_DIR "/QCA6174/hw3.0"
#define QCA6174_HW_3_0_PATCH_LOAD_ADDR  0x1234

/* QCA99X0 1.0 definitions (unsupported) */
#define QCA99X0_HW_1_0_CHIP_ID_REV     0x0

/* QCA99X0 2.0 definitions */
#define QCA99X0_HW_2_0_DEV_VERSION     0x01000000
#define QCA99X0_HW_2_0_CHIP_ID_REV     0x1
#define QCA99X0_HW_2_0_FW_DIR          ATH10K_FW_DIR "/QCA99X0/hw2.0"
#define QCA99X0_HW_2_0_PATCH_LOAD_ADDR  0x1234

/* QCA9984 1.0 defines */
#define QCA9984_HW_1_0_DEV_VERSION      0x1000000
#define QCA9984_HW_DEV_TYPE             0xa
#define QCA9984_HW_1_0_CHIP_ID_REV      0x0
#define QCA9984_HW_1_0_FW_DIR           ATH10K_FW_DIR "/QCA9984/hw1.0"
#define QCA9984_HW_1_0_PATCH_LOAD_ADDR  0x1234

/* QCA9888 2.0 defines */
#define QCA9888_HW_2_0_DEV_VERSION      0x1000000
#define QCA9888_HW_DEV_TYPE             0xc
#define QCA9888_HW_2_0_CHIP_ID_REV      0x0
#define QCA9888_HW_2_0_FW_DIR           ATH10K_FW_DIR "/QCA9888/hw2.0"
#define QCA9888_HW_2_0_PATCH_LOAD_ADDR  0x1234

/* QCA9377 1.0 definitions */
#define QCA9377_HW_1_0_FW_DIR          ATH10K_FW_DIR "/QCA9377/hw1.0"
#define QCA9377_HW_1_0_PATCH_LOAD_ADDR  0x1234

/* QCA4019 1.0 definitions */
#define QCA4019_HW_1_0_DEV_VERSION     0x01000000
#define QCA4019_HW_1_0_FW_DIR          ATH10K_FW_DIR "/QCA4019/hw1.0"
#define QCA4019_HW_1_0_PATCH_LOAD_ADDR  0x1234

/* WCN3990 1.0 definitions */
#define WCN3990_HW_1_0_DEV_VERSION      ATH10K_HW_WCN3990
#define WCN3990_HW_1_0_FW_DIR           ATH10K_FW_DIR "/WCN3990/hw1.0"

#define ATH10K_FW_FILE_BASE             "firmware"
#define ATH10K_FW_API_MAX               6
#define ATH10K_FW_API_MIN               2

#define ATH10K_FW_API2_FILE             "firmware-2.bin"
#define ATH10K_FW_API3_FILE             "firmware-3.bin"

/* added support for ATH10K_FW_IE_WMI_OP_VERSION */
#define ATH10K_FW_API4_FILE             "firmware-4.bin"

/* HTT id conflict fix for management frames over HTT */
#define ATH10K_FW_API5_FILE             "firmware-5.bin"

/* the firmware-6.bin blob */
#define ATH10K_FW_API6_FILE             "firmware-6.bin"

#define ATH10K_FW_UTF_FILE              "utf.bin"
#define ATH10K_FW_UTF_API2_FILE         "utf-2.bin"

#define ATH10K_FW_UTF_FILE_BASE         "utf"

/* includes also the null byte */
#define ATH10K_FIRMWARE_MAGIC               "QCA-ATH10K"
#define ATH10K_BOARD_MAGIC                  "QCA-ATH10K-BOARD"

#define ATH10K_BOARD_DATA_FILE         "board.bin"
#define ATH10K_BOARD_API2_FILE         "board-2.bin"
#define ATH10K_EBOARD_DATA_FILE        "eboard.bin"

#define REG_DUMP_COUNT_QCA988X 60

struct ath10k_fw_ie {
        __le32 id;
        __le32 len;
        u8 data[];
};

enum ath10k_fw_ie_type {
        ATH10K_FW_IE_FW_VERSION = 0,
        ATH10K_FW_IE_TIMESTAMP = 1,
        ATH10K_FW_IE_FEATURES = 2,
        ATH10K_FW_IE_FW_IMAGE = 3,
        ATH10K_FW_IE_OTP_IMAGE = 4,

        /* WMI "operations" interface version, 32 bit value. Supported from
         * FW API 4 and above.
         */
        ATH10K_FW_IE_WMI_OP_VERSION = 5,

        /* HTT "operations" interface version, 32 bit value. Supported from
         * FW API 5 and above.
         */
        ATH10K_FW_IE_HTT_OP_VERSION = 6,

        /* Code swap image for firmware binary */
        ATH10K_FW_IE_FW_CODE_SWAP_IMAGE = 7,
};

enum ath10k_fw_wmi_op_version {
        ATH10K_FW_WMI_OP_VERSION_UNSET = 0,

        ATH10K_FW_WMI_OP_VERSION_MAIN = 1,
        ATH10K_FW_WMI_OP_VERSION_10_1 = 2,
        ATH10K_FW_WMI_OP_VERSION_10_2 = 3,
        ATH10K_FW_WMI_OP_VERSION_TLV = 4,
        ATH10K_FW_WMI_OP_VERSION_10_2_4 = 5,
        ATH10K_FW_WMI_OP_VERSION_10_4 = 6,

        /* keep last */
        ATH10K_FW_WMI_OP_VERSION_MAX,
};

enum ath10k_fw_htt_op_version {
        ATH10K_FW_HTT_OP_VERSION_UNSET = 0,

        ATH10K_FW_HTT_OP_VERSION_MAIN = 1,

        /* also used in 10.2 and 10.2.4 branches */
        ATH10K_FW_HTT_OP_VERSION_10_1 = 2,

        ATH10K_FW_HTT_OP_VERSION_TLV = 3,

        ATH10K_FW_HTT_OP_VERSION_10_4 = 4,

        /* keep last */
        ATH10K_FW_HTT_OP_VERSION_MAX,
};

enum ath10k_bd_ie_type {
        /* contains sub IEs of enum ath10k_bd_ie_board_type */
        ATH10K_BD_IE_BOARD = 0,
        ATH10K_BD_IE_BOARD_EXT = 1,
};

enum ath10k_bd_ie_board_type {
        ATH10K_BD_IE_BOARD_NAME = 0,
        ATH10K_BD_IE_BOARD_DATA = 1,
};

enum ath10k_hw_rev {
        ATH10K_HW_QCA988X,
        ATH10K_HW_QCA6174,
        ATH10K_HW_QCA99X0,
        ATH10K_HW_QCA9888,
        ATH10K_HW_QCA9984,
        ATH10K_HW_QCA9377,
        ATH10K_HW_QCA4019,
        ATH10K_HW_QCA9887,
        ATH10K_HW_WCN3990,
};

struct ath10k_hw_regs {
        u32 rtc_soc_base_address;
        u32 rtc_wmac_base_address;
        u32 soc_core_base_address;
        u32 wlan_mac_base_address;
        u32 ce_wrapper_base_address;
        u32 ce0_base_address;
        u32 ce1_base_address;
        u32 ce2_base_address;
        u32 ce3_base_address;
        u32 ce4_base_address;
        u32 ce5_base_address;
        u32 ce6_base_address;
        u32 ce7_base_address;
        u32 ce8_base_address;
        u32 ce9_base_address;
        u32 ce10_base_address;
        u32 ce11_base_address;
        u32 soc_reset_control_si0_rst_mask;
        u32 soc_reset_control_ce_rst_mask;
        u32 soc_chip_id_address;
        u32 scratch_3_address;
        u32 fw_indicator_address;
        u32 pcie_local_base_address;
        u32 ce_wrap_intr_sum_host_msi_lsb;
        u32 ce_wrap_intr_sum_host_msi_mask;
        u32 pcie_intr_fw_mask;
        u32 pcie_intr_ce_mask_all;
        u32 pcie_intr_clr_address;
        u32 cpu_pll_init_address;
        u32 cpu_speed_address;
        u32 core_clk_div_address;
};

extern const struct ath10k_hw_regs qca988x_regs;
extern const struct ath10k_hw_regs qca6174_regs;
extern const struct ath10k_hw_regs qca99x0_regs;
extern const struct ath10k_hw_regs qca4019_regs;
extern const struct ath10k_hw_regs wcn3990_regs;

struct ath10k_hw_ce_regs_addr_map {
        u32 msb;
        u32 lsb;
        u32 mask;
};

struct ath10k_hw_ce_ctrl1 {
        u32 addr;
        u32 hw_mask;
        u32 sw_mask;
        u32 hw_wr_mask;
        u32 sw_wr_mask;
        u32 reset_mask;
        u32 reset;
        const struct ath10k_hw_ce_regs_addr_map *src_ring;
        const struct ath10k_hw_ce_regs_addr_map *dst_ring;
        const struct ath10k_hw_ce_regs_addr_map *dmax;
};

struct ath10k_hw_ce_cmd_halt {
        u32 status_reset;
        u32 msb;
        u32 mask;
        const struct ath10k_hw_ce_regs_addr_map *status;
};

struct ath10k_hw_ce_host_ie {
        u32 copy_complete_reset;
        const struct ath10k_hw_ce_regs_addr_map *copy_complete;
};

struct ath10k_hw_ce_host_wm_regs {
        u32 dstr_lmask;
        u32 dstr_hmask;
        u32 srcr_lmask;
        u32 srcr_hmask;
        u32 cc_mask;
        u32 wm_mask;
        u32 addr;
};

struct ath10k_hw_ce_misc_regs {
        u32 axi_err;
        u32 dstr_add_err;
        u32 srcr_len_err;
        u32 dstr_mlen_vio;
        u32 dstr_overflow;
        u32 srcr_overflow;
        u32 err_mask;
        u32 addr;
};

struct ath10k_hw_ce_dst_src_wm_regs {
        u32 addr;
        u32 low_rst;
        u32 high_rst;
        const struct ath10k_hw_ce_regs_addr_map *wm_low;
        const struct ath10k_hw_ce_regs_addr_map *wm_high;
};

struct ath10k_hw_ce_ctrl1_upd {
        u32 shift;
        u32 mask;
        u32 enable;
};

struct ath10k_hw_ce_regs {
        u32 sr_base_addr_lo;
        u32 sr_base_addr_hi;
        u32 sr_size_addr;
        u32 dr_base_addr_lo;
        u32 dr_base_addr_hi;
        u32 dr_size_addr;
        u32 ce_cmd_addr;
        u32 misc_ie_addr;
        u32 sr_wr_index_addr;
        u32 dst_wr_index_addr;
        u32 current_srri_addr;
        u32 current_drri_addr;
        u32 ddr_addr_for_rri_low;
        u32 ddr_addr_for_rri_high;
        u32 ce_rri_low;
        u32 ce_rri_high;
        u32 host_ie_addr;
        const struct ath10k_hw_ce_host_wm_regs *wm_regs;
        const struct ath10k_hw_ce_misc_regs *misc_regs;
        const struct ath10k_hw_ce_ctrl1 *ctrl1_regs;
        const struct ath10k_hw_ce_cmd_halt *cmd_halt;
        const struct ath10k_hw_ce_host_ie *host_ie;
        const struct ath10k_hw_ce_dst_src_wm_regs *wm_srcr;
        const struct ath10k_hw_ce_dst_src_wm_regs *wm_dstr;
        const struct ath10k_hw_ce_ctrl1_upd *upd;
};

struct ath10k_hw_values {
        u32 rtc_state_val_on;
        u8 ce_count;
        u8 msi_assign_ce_max;
        u8 num_target_ce_config_wlan;
        u16 ce_desc_meta_data_mask;
        u8 ce_desc_meta_data_lsb;
        u32 rfkill_pin;
        u32 rfkill_cfg;
        bool rfkill_on_level;
};

extern const struct ath10k_hw_values qca988x_values;
extern const struct ath10k_hw_values qca6174_values;
extern const struct ath10k_hw_values qca99x0_values;
extern const struct ath10k_hw_values qca9888_values;
extern const struct ath10k_hw_values qca4019_values;
extern const struct ath10k_hw_values wcn3990_values;
extern const struct ath10k_hw_ce_regs wcn3990_ce_regs;
extern const struct ath10k_hw_ce_regs qcax_ce_regs;

void ath10k_hw_fill_survey_time(struct ath10k *ar, struct survey_info *survey,
                                u32 cc, u32 rcc, u32 cc_prev, u32 rcc_prev);

int ath10k_hw_diag_fast_download(struct ath10k *ar,
                                 u32 address,
                                 const void *buffer,
                                 u32 length);

#define QCA_REV_988X(ar) ((ar)->hw_rev == ATH10K_HW_QCA988X)
#define QCA_REV_9887(ar) ((ar)->hw_rev == ATH10K_HW_QCA9887)
#define QCA_REV_6174(ar) ((ar)->hw_rev == ATH10K_HW_QCA6174)
#define QCA_REV_99X0(ar) ((ar)->hw_rev == ATH10K_HW_QCA99X0)
#define QCA_REV_9888(ar) ((ar)->hw_rev == ATH10K_HW_QCA9888)
#define QCA_REV_9984(ar) ((ar)->hw_rev == ATH10K_HW_QCA9984)
#define QCA_REV_9377(ar) ((ar)->hw_rev == ATH10K_HW_QCA9377)
#define QCA_REV_40XX(ar) ((ar)->hw_rev == ATH10K_HW_QCA4019)
#define QCA_REV_WCN3990(ar) ((ar)->hw_rev == ATH10K_HW_WCN3990)

/* Known peculiarities:
 *  - raw appears in nwifi decap, raw and nwifi appear in ethernet decap
 *  - raw have FCS, nwifi doesn't
 *  - ethernet frames have 802.11 header decapped and parts (base hdr, cipher
 *    param, llc/snap) are aligned to 4byte boundaries each
 */
enum ath10k_hw_txrx_mode {
        ATH10K_HW_TXRX_RAW = 0,

        /* Native Wifi decap mode is used to align IP frames to 4-byte
         * boundaries and avoid a very expensive re-alignment in mac80211.
         */
        ATH10K_HW_TXRX_NATIVE_WIFI = 1,
        ATH10K_HW_TXRX_ETHERNET = 2,

        /* Valid for HTT >= 3.0. Used for management frames in TX_FRM. */
        ATH10K_HW_TXRX_MGMT = 3,
};

enum ath10k_mcast2ucast_mode {
        ATH10K_MCAST2UCAST_DISABLED = 0,
        ATH10K_MCAST2UCAST_ENABLED = 1,
};

enum ath10k_hw_rate_ofdm {
        ATH10K_HW_RATE_OFDM_48M = 0,
        ATH10K_HW_RATE_OFDM_24M,
        ATH10K_HW_RATE_OFDM_12M,
        ATH10K_HW_RATE_OFDM_6M,
        ATH10K_HW_RATE_OFDM_54M,
        ATH10K_HW_RATE_OFDM_36M,
        ATH10K_HW_RATE_OFDM_18M,
        ATH10K_HW_RATE_OFDM_9M,
};

enum ath10k_hw_rate_cck {
        ATH10K_HW_RATE_CCK_LP_11M = 0,
        ATH10K_HW_RATE_CCK_LP_5_5M,
        ATH10K_HW_RATE_CCK_LP_2M,
        ATH10K_HW_RATE_CCK_LP_1M,
        ATH10K_HW_RATE_CCK_SP_11M,
        ATH10K_HW_RATE_CCK_SP_5_5M,
        ATH10K_HW_RATE_CCK_SP_2M,
};

enum ath10k_hw_rate_rev2_cck {
        ATH10K_HW_RATE_REV2_CCK_LP_1M = 1,
        ATH10K_HW_RATE_REV2_CCK_LP_2M,
        ATH10K_HW_RATE_REV2_CCK_LP_5_5M,
        ATH10K_HW_RATE_REV2_CCK_LP_11M,
        ATH10K_HW_RATE_REV2_CCK_SP_2M,
        ATH10K_HW_RATE_REV2_CCK_SP_5_5M,
        ATH10K_HW_RATE_REV2_CCK_SP_11M,
};

enum ath10k_hw_cc_wraparound_type {
        ATH10K_HW_CC_WRAP_DISABLED = 0,

        /* This type is when the HW chip has a quirky Cycle Counter
         * wraparound which resets to 0x7fffffff instead of 0. All
         * other CC related counters (e.g. Rx Clear Count) are divided
         * by 2 so they never wraparound themselves.
         */
        ATH10K_HW_CC_WRAP_SHIFTED_ALL = 1,

        /* Each hw counter wraps around independently. When the
         * counter overflows the respective counter is right shifted
         * by 1, i.e reset to 0x7fffffff, and other counters will be
         * running unaffected. In this type of wraparound, it should
         * be possible to report accurate Rx busy time unlike the
         * first type.
         */
        ATH10K_HW_CC_WRAP_SHIFTED_EACH = 2,
};

enum ath10k_hw_refclk_speed {
        ATH10K_HW_REFCLK_UNKNOWN = -1,
        ATH10K_HW_REFCLK_48_MHZ = 0,
        ATH10K_HW_REFCLK_19_2_MHZ = 1,
        ATH10K_HW_REFCLK_24_MHZ = 2,
        ATH10K_HW_REFCLK_26_MHZ = 3,
        ATH10K_HW_REFCLK_37_4_MHZ = 4,
        ATH10K_HW_REFCLK_38_4_MHZ = 5,
        ATH10K_HW_REFCLK_40_MHZ = 6,
        ATH10K_HW_REFCLK_52_MHZ = 7,

        /* must be the last one */
        ATH10K_HW_REFCLK_COUNT,
};

struct ath10k_hw_clk_params {
        u32 refclk;
        u32 div;
        u32 rnfrac;
        u32 settle_time;
        u32 refdiv;
        u32 outdiv;
};

struct htt_rx_desc_ops;

struct ath10k_hw_params {
        u32 id;
        u16 dev_id;
        enum ath10k_bus bus;
        const char *name;
        u32 patch_load_addr;
        int uart_pin;
        int led_pin;
        u32 otp_exe_param;

        /* Type of hw cycle counter wraparound logic, for more info
         * refer enum ath10k_hw_cc_wraparound_type.
         */
        enum ath10k_hw_cc_wraparound_type cc_wraparound_type;

        /* Some of chip expects fragment descriptor to be continuous
         * memory for any TX operation. Set continuous_frag_desc flag
         * for the hardware which have such requirement.
         */
        bool continuous_frag_desc;

        /* CCK hardware rate table mapping for the newer chipsets
         * like QCA99X0, QCA4019 got revised. The CCK h/w rate values
         * are in a proper order with respect to the rate/preamble
         */
        bool cck_rate_map_rev2;

        u32 channel_counters_freq_hz;

        /* Mgmt tx descriptors threshold for limiting probe response
         * frames.
         */
        u32 max_probe_resp_desc_thres;

        u32 tx_chain_mask;
        u32 rx_chain_mask;
        u32 max_spatial_stream;
        u32 cal_data_len;

        struct ath10k_hw_params_fw {
                const char *dir;
                size_t board_size;
                size_t ext_board_size;
                size_t board_ext_size;
        } fw;

        /* qca99x0 family chips deliver broadcast/multicast management
         * frames encrypted and expect software do decryption.
         */
        bool sw_decrypt_mcast_mgmt;

        /* Rx descriptor abstraction */
        const struct ath10k_htt_rx_desc_ops *rx_desc_ops;

        const struct ath10k_hw_ops *hw_ops;

        /* Number of bytes used for alignment in rx_hdr_status of rx desc. */
        int decap_align_bytes;

        /* hw specific clock control parameters */
        const struct ath10k_hw_clk_params *hw_clk;
        int target_cpu_freq;

        /* Number of bytes to be discarded for each FFT sample */
        int spectral_bin_discard;

        /* The board may have a restricted NSS for 160 or 80+80 vs what it
         * can do for 80Mhz.
         */
        int vht160_mcs_rx_highest;
        int vht160_mcs_tx_highest;

        /* Number of ciphers supported (i.e First N) in cipher_suites array */
        int n_cipher_suites;

        u32 num_peers;
        u32 ast_skid_limit;
        u32 num_wds_entries;

        /* Targets supporting physical addressing capability above 32-bits */
        bool target_64bit;

        /* Target rx ring fill level */
        u32 rx_ring_fill_level;

        /* target supporting shadow register for ce write */
        bool shadow_reg_support;

        /* target supporting retention restore on ddr */
        bool rri_on_ddr;

        /* Number of bytes to be the offset for each FFT sample */
        int spectral_bin_offset;

        /* targets which require hw filter reset during boot up,
         * to avoid it sending spurious acks.
         */
        bool hw_filter_reset_required;

        /* target supporting fw download via diag ce */
        bool fw_diag_ce_download;

        /* target supporting fw download via large size BMI */
        bool bmi_large_size_download;

        /* need to set uart pin if disable uart print, workaround for a
         * firmware bug
         */
        bool uart_pin_workaround;

        /* Workaround for the credit size calculation */
        bool credit_size_workaround;

        /* tx stats support over pktlog */
        bool tx_stats_over_pktlog;

        /* provides bitrates for sta_statistics using WMI_TLV_PEER_STATS_INFO_EVENTID */
        bool supports_peer_stats_info;

        bool dynamic_sar_support;

        bool hw_restart_disconnect;

        bool use_fw_tx_credits;

        bool delay_unmap_buffer;

        /* The hardware support multicast frame registrations */
        bool mcast_frame_registration;
};

struct htt_resp;
struct htt_data_tx_completion_ext;
struct htt_rx_ring_rx_desc_offsets;

/* Defines needed for Rx descriptor abstraction */
struct ath10k_hw_ops {
        void (*set_coverage_class)(struct ath10k *ar, int radio_idx, s16 value);
        int (*enable_pll_clk)(struct ath10k *ar);
        int (*tx_data_rssi_pad_bytes)(struct htt_resp *htt);
        int (*is_rssi_enable)(struct htt_resp *resp);
};

extern const struct ath10k_hw_ops qca988x_ops;
extern const struct ath10k_hw_ops qca99x0_ops;
extern const struct ath10k_hw_ops qca6174_ops;
extern const struct ath10k_hw_ops qca6174_sdio_ops;
extern const struct ath10k_hw_ops wcn3990_ops;

extern const struct ath10k_hw_clk_params qca6174_clk[];

static inline int
ath10k_tx_data_rssi_get_pad_bytes(struct ath10k_hw_params *hw,
                                  struct htt_resp *htt)
{
        if (hw->hw_ops->tx_data_rssi_pad_bytes)
                return hw->hw_ops->tx_data_rssi_pad_bytes(htt);
        return 0;
}

static inline int
ath10k_is_rssi_enable(struct ath10k_hw_params *hw,
                      struct htt_resp *resp)
{
        if (hw->hw_ops->is_rssi_enable)
                return hw->hw_ops->is_rssi_enable(resp);
        return 0;
}

/* Target specific defines for MAIN firmware */
#define TARGET_NUM_VDEVS                        8
#define TARGET_NUM_PEER_AST                     2
#define TARGET_NUM_WDS_ENTRIES                  32
#define TARGET_DMA_BURST_SIZE                   0
#define TARGET_MAC_AGGR_DELIM                   0
#define TARGET_AST_SKID_LIMIT                   16
#define TARGET_NUM_STATIONS                     16
#define TARGET_NUM_PEERS                        ((TARGET_NUM_STATIONS) + \
                                                 (TARGET_NUM_VDEVS))
#define TARGET_NUM_OFFLOAD_PEERS                0
#define TARGET_NUM_OFFLOAD_REORDER_BUFS         0
#define TARGET_NUM_PEER_KEYS                    2
#define TARGET_NUM_TIDS                         ((TARGET_NUM_PEERS) * 2)
#define TARGET_TX_CHAIN_MASK                    (BIT(0) | BIT(1) | BIT(2))
#define TARGET_RX_CHAIN_MASK                    (BIT(0) | BIT(1) | BIT(2))
#define TARGET_RX_TIMEOUT_LO_PRI                100
#define TARGET_RX_TIMEOUT_HI_PRI                40

#define TARGET_SCAN_MAX_PENDING_REQS            4
#define TARGET_BMISS_OFFLOAD_MAX_VDEV           3
#define TARGET_ROAM_OFFLOAD_MAX_VDEV            3
#define TARGET_ROAM_OFFLOAD_MAX_AP_PROFILES     8
#define TARGET_GTK_OFFLOAD_MAX_VDEV             3
#define TARGET_NUM_MCAST_GROUPS                 0
#define TARGET_NUM_MCAST_TABLE_ELEMS            0
#define TARGET_MCAST2UCAST_MODE                 ATH10K_MCAST2UCAST_DISABLED
#define TARGET_TX_DBG_LOG_SIZE                  1024
#define TARGET_RX_SKIP_DEFRAG_TIMEOUT_DUP_DETECTION_CHECK 0
#define TARGET_VOW_CONFIG                       0
#define TARGET_NUM_MSDU_DESC                    (1024 + 400)
#define TARGET_MAX_FRAG_ENTRIES                 0

/* Target specific defines for 10.X firmware */
#define TARGET_10X_NUM_VDEVS                    16
#define TARGET_10X_NUM_PEER_AST                 2
#define TARGET_10X_NUM_WDS_ENTRIES              32
#define TARGET_10X_DMA_BURST_SIZE               0
#define TARGET_10X_MAC_AGGR_DELIM               0
#define TARGET_10X_AST_SKID_LIMIT               128
#define TARGET_10X_NUM_STATIONS                 128
#define TARGET_10X_TX_STATS_NUM_STATIONS        118
#define TARGET_10X_NUM_PEERS                    ((TARGET_10X_NUM_STATIONS) + \
                                                 (TARGET_10X_NUM_VDEVS))
#define TARGET_10X_TX_STATS_NUM_PEERS           ((TARGET_10X_TX_STATS_NUM_STATIONS) + \
                                                 (TARGET_10X_NUM_VDEVS))
#define TARGET_10X_NUM_OFFLOAD_PEERS            0
#define TARGET_10X_NUM_OFFLOAD_REORDER_BUFS     0
#define TARGET_10X_NUM_PEER_KEYS                2
#define TARGET_10X_NUM_TIDS_MAX                 256
#define TARGET_10X_NUM_TIDS                     min((TARGET_10X_NUM_TIDS_MAX), \
                                                    (TARGET_10X_NUM_PEERS) * 2)
#define TARGET_10X_TX_STATS_NUM_TIDS            min((TARGET_10X_NUM_TIDS_MAX), \
                                                    (TARGET_10X_TX_STATS_NUM_PEERS) * 2)
#define TARGET_10X_TX_CHAIN_MASK                (BIT(0) | BIT(1) | BIT(2))
#define TARGET_10X_RX_CHAIN_MASK                (BIT(0) | BIT(1) | BIT(2))
#define TARGET_10X_RX_TIMEOUT_LO_PRI            100
#define TARGET_10X_RX_TIMEOUT_HI_PRI            40
#define TARGET_10X_SCAN_MAX_PENDING_REQS        4
#define TARGET_10X_BMISS_OFFLOAD_MAX_VDEV       2
#define TARGET_10X_ROAM_OFFLOAD_MAX_VDEV        2
#define TARGET_10X_ROAM_OFFLOAD_MAX_AP_PROFILES 8
#define TARGET_10X_GTK_OFFLOAD_MAX_VDEV         3
#define TARGET_10X_NUM_MCAST_GROUPS             0
#define TARGET_10X_NUM_MCAST_TABLE_ELEMS        0
#define TARGET_10X_MCAST2UCAST_MODE             ATH10K_MCAST2UCAST_DISABLED
#define TARGET_10X_TX_DBG_LOG_SIZE              1024
#define TARGET_10X_RX_SKIP_DEFRAG_TIMEOUT_DUP_DETECTION_CHECK 1
#define TARGET_10X_VOW_CONFIG                   0
#define TARGET_10X_NUM_MSDU_DESC                (1024 + 400)
#define TARGET_10X_MAX_FRAG_ENTRIES             0

/* 10.2 parameters */
#define TARGET_10_2_DMA_BURST_SIZE              0

/* Target specific defines for WMI-TLV firmware */
#define TARGET_TLV_NUM_VDEVS                    4
#define TARGET_TLV_NUM_STATIONS                 32
#define TARGET_TLV_NUM_PEERS                    33
#define TARGET_TLV_NUM_TDLS_VDEVS               1
#define TARGET_TLV_NUM_TIDS                     ((TARGET_TLV_NUM_PEERS) * 2)
#define TARGET_TLV_NUM_MSDU_DESC                (1024 + 32)
#define TARGET_TLV_NUM_MSDU_DESC_HL             1024
#define TARGET_TLV_NUM_WOW_PATTERNS             22
#define TARGET_TLV_MGMT_NUM_MSDU_DESC           (50)

/* Target specific defines for WMI-HL-1.0 firmware */
#define TARGET_HL_TLV_NUM_PEERS                 33
#define TARGET_HL_TLV_AST_SKID_LIMIT            16
#define TARGET_HL_TLV_NUM_WDS_ENTRIES           2

/* Target specific defines for QCA9377 high latency firmware */
#define TARGET_QCA9377_HL_NUM_PEERS             15

/* Diagnostic Window */
#define CE_DIAG_PIPE    7

#define NUM_TARGET_CE_CONFIG_WLAN ar->hw_values->num_target_ce_config_wlan

/* Target specific defines for 10.4 firmware */
#define TARGET_10_4_NUM_VDEVS                   16
#define TARGET_10_4_NUM_STATIONS                32
#define TARGET_10_4_NUM_PEERS                   ((TARGET_10_4_NUM_STATIONS) + \
                                                 (TARGET_10_4_NUM_VDEVS))
#define TARGET_10_4_ACTIVE_PEERS                0

#define TARGET_10_4_NUM_QCACHE_PEERS_MAX        512
#define TARGET_10_4_QCACHE_ACTIVE_PEERS         50
#define TARGET_10_4_QCACHE_ACTIVE_PEERS_PFC     35
#define TARGET_10_4_NUM_OFFLOAD_PEERS           0
#define TARGET_10_4_NUM_OFFLOAD_REORDER_BUFFS   0
#define TARGET_10_4_NUM_PEER_KEYS               2
#define TARGET_10_4_TGT_NUM_TIDS                ((TARGET_10_4_NUM_PEERS) * 2)
#define TARGET_10_4_NUM_MSDU_DESC               (1024 + 400)
#define TARGET_10_4_NUM_MSDU_DESC_PFC           2500
#define TARGET_10_4_AST_SKID_LIMIT              32

/* 100 ms for video, best-effort, and background */
#define TARGET_10_4_RX_TIMEOUT_LO_PRI           100

/* 40 ms for voice */
#define TARGET_10_4_RX_TIMEOUT_HI_PRI           40

#define TARGET_10_4_RX_DECAP_MODE               ATH10K_HW_TXRX_NATIVE_WIFI
#define TARGET_10_4_SCAN_MAX_REQS               4
#define TARGET_10_4_BMISS_OFFLOAD_MAX_VDEV      3
#define TARGET_10_4_ROAM_OFFLOAD_MAX_VDEV       3
#define TARGET_10_4_ROAM_OFFLOAD_MAX_PROFILES   8

/* Note: mcast to ucast is disabled by default */
#define TARGET_10_4_NUM_MCAST_GROUPS            0
#define TARGET_10_4_NUM_MCAST_TABLE_ELEMS       0
#define TARGET_10_4_MCAST2UCAST_MODE            0

#define TARGET_10_4_TX_DBG_LOG_SIZE             1024
#define TARGET_10_4_NUM_WDS_ENTRIES             32
#define TARGET_10_4_DMA_BURST_SIZE              1
#define TARGET_10_4_MAC_AGGR_DELIM              0
#define TARGET_10_4_RX_SKIP_DEFRAG_TIMEOUT_DUP_DETECTION_CHECK 1
#define TARGET_10_4_VOW_CONFIG                  0
#define TARGET_10_4_GTK_OFFLOAD_MAX_VDEV        3
#define TARGET_10_4_11AC_TX_MAX_FRAGS           2
#define TARGET_10_4_MAX_PEER_EXT_STATS          16
#define TARGET_10_4_SMART_ANT_CAP               0
#define TARGET_10_4_BK_MIN_FREE                 0
#define TARGET_10_4_BE_MIN_FREE                 0
#define TARGET_10_4_VI_MIN_FREE                 0
#define TARGET_10_4_VO_MIN_FREE                 0
#define TARGET_10_4_RX_BATCH_MODE               1
#define TARGET_10_4_THERMAL_THROTTLING_CONFIG   0
#define TARGET_10_4_ATF_CONFIG                  0
#define TARGET_10_4_IPHDR_PAD_CONFIG            1
#define TARGET_10_4_QWRAP_CONFIG                0

/* TDLS config */
#define TARGET_10_4_NUM_TDLS_VDEVS              1
#define TARGET_10_4_NUM_TDLS_BUFFER_STA         1
#define TARGET_10_4_NUM_TDLS_SLEEP_STA          1

/* Maximum number of Copy Engines supported */
#define CE_COUNT_MAX 12

/* Number of Copy Engines supported */
#define CE_COUNT ar->hw_values->ce_count

/*
 * Granted MSIs are assigned as follows:
 * Firmware uses the first
 * Remaining MSIs, if any, are used by Copy Engines
 * This mapping is known to both Target firmware and Host software.
 * It may be changed as long as Host and Target are kept in sync.
 */
/* MSI for firmware (errors, etc.) */
#define MSI_ASSIGN_FW           0

/* MSIs for Copy Engines */
#define MSI_ASSIGN_CE_INITIAL   1
#define MSI_ASSIGN_CE_MAX       ar->hw_values->msi_assign_ce_max

/* as of IP3.7.1 */
#define RTC_STATE_V_ON                          ar->hw_values->rtc_state_val_on

#define RTC_STATE_V_LSB                         0
#define RTC_STATE_V_MASK                        0x00000007
#define RTC_STATE_ADDRESS                       0x0000
#define PCIE_SOC_WAKE_V_MASK                    0x00000001
#define PCIE_SOC_WAKE_ADDRESS                   0x0004
#define PCIE_SOC_WAKE_RESET                     0x00000000
#define SOC_GLOBAL_RESET_ADDRESS                0x0008

#define RTC_SOC_BASE_ADDRESS                    ar->regs->rtc_soc_base_address
#define RTC_WMAC_BASE_ADDRESS                   ar->regs->rtc_wmac_base_address
#define MAC_COEX_BASE_ADDRESS                   0x00006000
#define BT_COEX_BASE_ADDRESS                    0x00007000
#define SOC_PCIE_BASE_ADDRESS                   0x00008000
#define SOC_CORE_BASE_ADDRESS                   ar->regs->soc_core_base_address
#define WLAN_UART_BASE_ADDRESS                  0x0000c000
#define WLAN_SI_BASE_ADDRESS                    0x00010000
#define WLAN_GPIO_BASE_ADDRESS                  0x00014000
#define WLAN_ANALOG_INTF_BASE_ADDRESS           0x0001c000
#define WLAN_MAC_BASE_ADDRESS                   ar->regs->wlan_mac_base_address
#define EFUSE_BASE_ADDRESS                      0x00030000
#define FPGA_REG_BASE_ADDRESS                   0x00039000
#define WLAN_UART2_BASE_ADDRESS                 0x00054c00
#define CE_WRAPPER_BASE_ADDRESS                 ar->regs->ce_wrapper_base_address
#define CE0_BASE_ADDRESS                        ar->regs->ce0_base_address
#define CE1_BASE_ADDRESS                        ar->regs->ce1_base_address
#define CE2_BASE_ADDRESS                        ar->regs->ce2_base_address
#define CE3_BASE_ADDRESS                        ar->regs->ce3_base_address
#define CE4_BASE_ADDRESS                        ar->regs->ce4_base_address
#define CE5_BASE_ADDRESS                        ar->regs->ce5_base_address
#define CE6_BASE_ADDRESS                        ar->regs->ce6_base_address
#define CE7_BASE_ADDRESS                        ar->regs->ce7_base_address
#define DBI_BASE_ADDRESS                        0x00060000
#define WLAN_ANALOG_INTF_PCIE_BASE_ADDRESS      0x0006c000
#define PCIE_LOCAL_BASE_ADDRESS         ar->regs->pcie_local_base_address

#define SOC_RESET_CONTROL_ADDRESS               0x00000000
#define SOC_RESET_CONTROL_OFFSET                0x00000000
#define SOC_RESET_CONTROL_SI0_RST_MASK          ar->regs->soc_reset_control_si0_rst_mask
#define SOC_RESET_CONTROL_CE_RST_MASK           ar->regs->soc_reset_control_ce_rst_mask
#define SOC_RESET_CONTROL_CPU_WARM_RST_MASK     0x00000040
#define SOC_CPU_CLOCK_OFFSET                    0x00000020
#define SOC_CPU_CLOCK_STANDARD_LSB              0
#define SOC_CPU_CLOCK_STANDARD_MASK             0x00000003
#define SOC_CLOCK_CONTROL_OFFSET                0x00000028
#define SOC_CLOCK_CONTROL_SI0_CLK_MASK          0x00000001
#define SOC_SYSTEM_SLEEP_OFFSET                 0x000000c4
#define SOC_LPO_CAL_OFFSET                      0x000000e0
#define SOC_LPO_CAL_ENABLE_LSB                  20
#define SOC_LPO_CAL_ENABLE_MASK                 0x00100000
#define SOC_LF_TIMER_CONTROL0_ADDRESS           0x00000050
#define SOC_LF_TIMER_CONTROL0_ENABLE_MASK       0x00000004

#define SOC_CHIP_ID_ADDRESS                     ar->regs->soc_chip_id_address
#define SOC_CHIP_ID_REV_LSB                     8
#define SOC_CHIP_ID_REV_MASK                    0x00000f00

#define WLAN_RESET_CONTROL_COLD_RST_MASK        0x00000008
#define WLAN_RESET_CONTROL_WARM_RST_MASK        0x00000004
#define WLAN_SYSTEM_SLEEP_DISABLE_LSB           0
#define WLAN_SYSTEM_SLEEP_DISABLE_MASK          0x00000001

#define WLAN_GPIO_PIN0_ADDRESS                  0x00000028
#define WLAN_GPIO_PIN0_CONFIG_LSB               11
#define WLAN_GPIO_PIN0_CONFIG_MASK              0x00007800
#define WLAN_GPIO_PIN0_PAD_PULL_LSB             5
#define WLAN_GPIO_PIN0_PAD_PULL_MASK            0x00000060
#define WLAN_GPIO_PIN1_ADDRESS                  0x0000002c
#define WLAN_GPIO_PIN1_CONFIG_MASK              0x00007800
#define WLAN_GPIO_PIN10_ADDRESS                 0x00000050
#define WLAN_GPIO_PIN11_ADDRESS                 0x00000054
#define WLAN_GPIO_PIN12_ADDRESS                 0x00000058
#define WLAN_GPIO_PIN13_ADDRESS                 0x0000005c

#define CLOCK_GPIO_OFFSET                       0xffffffff
#define CLOCK_GPIO_BT_CLK_OUT_EN_LSB            0
#define CLOCK_GPIO_BT_CLK_OUT_EN_MASK           0

#define SI_CONFIG_OFFSET                        0x00000000
#define SI_CONFIG_ERR_INT_LSB                   19
#define SI_CONFIG_ERR_INT_MASK                  0x00080000
#define SI_CONFIG_BIDIR_OD_DATA_LSB             18
#define SI_CONFIG_BIDIR_OD_DATA_MASK            0x00040000
#define SI_CONFIG_I2C_LSB                       16
#define SI_CONFIG_I2C_MASK                      0x00010000
#define SI_CONFIG_POS_SAMPLE_LSB                7
#define SI_CONFIG_POS_SAMPLE_MASK               0x00000080
#define SI_CONFIG_INACTIVE_DATA_LSB             5
#define SI_CONFIG_INACTIVE_DATA_MASK            0x00000020
#define SI_CONFIG_INACTIVE_CLK_LSB              4
#define SI_CONFIG_INACTIVE_CLK_MASK             0x00000010
#define SI_CONFIG_DIVIDER_LSB                   0
#define SI_CONFIG_DIVIDER_MASK                  0x0000000f
#define SI_CS_OFFSET                            0x00000004
#define SI_CS_DONE_ERR_LSB                      10
#define SI_CS_DONE_ERR_MASK                     0x00000400
#define SI_CS_DONE_INT_LSB                      9
#define SI_CS_DONE_INT_MASK                     0x00000200
#define SI_CS_START_LSB                         8
#define SI_CS_START_MASK                        0x00000100
#define SI_CS_RX_CNT_LSB                        4
#define SI_CS_RX_CNT_MASK                       0x000000f0
#define SI_CS_TX_CNT_LSB                        0
#define SI_CS_TX_CNT_MASK                       0x0000000f

#define SI_TX_DATA0_OFFSET                      0x00000008
#define SI_TX_DATA1_OFFSET                      0x0000000c
#define SI_RX_DATA0_OFFSET                      0x00000010
#define SI_RX_DATA1_OFFSET                      0x00000014

#define CORE_CTRL_CPU_INTR_MASK                 0x00002000
#define CORE_CTRL_PCIE_REG_31_MASK              0x00000800
#define CORE_CTRL_ADDRESS                       0x0000
#define PCIE_INTR_ENABLE_ADDRESS                0x0008
#define PCIE_INTR_CAUSE_ADDRESS                 0x000c
#define PCIE_INTR_CLR_ADDRESS                   ar->regs->pcie_intr_clr_address
#define SCRATCH_3_ADDRESS                       ar->regs->scratch_3_address
#define CPU_INTR_ADDRESS                        0x0010
#define FW_RAM_CONFIG_ADDRESS                   0x0018

#define CCNT_TO_MSEC(ar, x) ((x) / ar->hw_params.channel_counters_freq_hz)

/* Firmware indications to the Host via SCRATCH_3 register. */
#define FW_INDICATOR_ADDRESS                    ar->regs->fw_indicator_address
#define FW_IND_EVENT_PENDING                    1
#define FW_IND_INITIALIZED                      2
#define FW_IND_HOST_READY                       0x80000000

/* HOST_REG interrupt from firmware */
#define PCIE_INTR_FIRMWARE_MASK                 ar->regs->pcie_intr_fw_mask
#define PCIE_INTR_CE_MASK_ALL                   ar->regs->pcie_intr_ce_mask_all

#define DRAM_BASE_ADDRESS                       0x00400000

#define PCIE_BAR_REG_ADDRESS                    0x40030

#define MISSING 0

#define SYSTEM_SLEEP_OFFSET                     SOC_SYSTEM_SLEEP_OFFSET
#define WLAN_SYSTEM_SLEEP_OFFSET                SOC_SYSTEM_SLEEP_OFFSET
#define WLAN_RESET_CONTROL_OFFSET               SOC_RESET_CONTROL_OFFSET
#define CLOCK_CONTROL_OFFSET                    SOC_CLOCK_CONTROL_OFFSET
#define CLOCK_CONTROL_SI0_CLK_MASK              SOC_CLOCK_CONTROL_SI0_CLK_MASK
#define RESET_CONTROL_MBOX_RST_MASK             MISSING
#define RESET_CONTROL_SI0_RST_MASK              SOC_RESET_CONTROL_SI0_RST_MASK
#define GPIO_BASE_ADDRESS                       WLAN_GPIO_BASE_ADDRESS
#define GPIO_PIN0_OFFSET                        WLAN_GPIO_PIN0_ADDRESS
#define GPIO_PIN1_OFFSET                        WLAN_GPIO_PIN1_ADDRESS
#define GPIO_PIN0_CONFIG_LSB                    WLAN_GPIO_PIN0_CONFIG_LSB
#define GPIO_PIN0_CONFIG_MASK                   WLAN_GPIO_PIN0_CONFIG_MASK
#define GPIO_PIN0_PAD_PULL_LSB                  WLAN_GPIO_PIN0_PAD_PULL_LSB
#define GPIO_PIN0_PAD_PULL_MASK                 WLAN_GPIO_PIN0_PAD_PULL_MASK
#define GPIO_PIN1_CONFIG_MASK                   WLAN_GPIO_PIN1_CONFIG_MASK
#define SI_BASE_ADDRESS                         WLAN_SI_BASE_ADDRESS
#define SCRATCH_BASE_ADDRESS                    SOC_CORE_BASE_ADDRESS
#define LOCAL_SCRATCH_OFFSET                    0x18
#define CPU_CLOCK_OFFSET                        SOC_CPU_CLOCK_OFFSET
#define LPO_CAL_OFFSET                          SOC_LPO_CAL_OFFSET
#define GPIO_PIN10_OFFSET                       WLAN_GPIO_PIN10_ADDRESS
#define GPIO_PIN11_OFFSET                       WLAN_GPIO_PIN11_ADDRESS
#define GPIO_PIN12_OFFSET                       WLAN_GPIO_PIN12_ADDRESS
#define GPIO_PIN13_OFFSET                       WLAN_GPIO_PIN13_ADDRESS
#define CPU_CLOCK_STANDARD_LSB                  SOC_CPU_CLOCK_STANDARD_LSB
#define CPU_CLOCK_STANDARD_MASK                 SOC_CPU_CLOCK_STANDARD_MASK
#define LPO_CAL_ENABLE_LSB                      SOC_LPO_CAL_ENABLE_LSB
#define LPO_CAL_ENABLE_MASK                     SOC_LPO_CAL_ENABLE_MASK
#define ANALOG_INTF_BASE_ADDRESS                WLAN_ANALOG_INTF_BASE_ADDRESS
#define MBOX_BASE_ADDRESS                       MISSING
#define INT_STATUS_ENABLE_ERROR_LSB             MISSING
#define INT_STATUS_ENABLE_ERROR_MASK            MISSING
#define INT_STATUS_ENABLE_CPU_LSB               MISSING
#define INT_STATUS_ENABLE_CPU_MASK              MISSING
#define INT_STATUS_ENABLE_COUNTER_LSB           MISSING
#define INT_STATUS_ENABLE_COUNTER_MASK          MISSING
#define INT_STATUS_ENABLE_MBOX_DATA_LSB         MISSING
#define INT_STATUS_ENABLE_MBOX_DATA_MASK        MISSING
#define ERROR_STATUS_ENABLE_RX_UNDERFLOW_LSB    MISSING
#define ERROR_STATUS_ENABLE_RX_UNDERFLOW_MASK   MISSING
#define ERROR_STATUS_ENABLE_TX_OVERFLOW_LSB     MISSING
#define ERROR_STATUS_ENABLE_TX_OVERFLOW_MASK    MISSING
#define COUNTER_INT_STATUS_ENABLE_BIT_LSB       MISSING
#define COUNTER_INT_STATUS_ENABLE_BIT_MASK      MISSING
#define INT_STATUS_ENABLE_ADDRESS               MISSING
#define CPU_INT_STATUS_ENABLE_BIT_LSB           MISSING
#define CPU_INT_STATUS_ENABLE_BIT_MASK          MISSING
#define HOST_INT_STATUS_ADDRESS                 MISSING
#define CPU_INT_STATUS_ADDRESS                  MISSING
#define ERROR_INT_STATUS_ADDRESS                MISSING
#define ERROR_INT_STATUS_WAKEUP_MASK            MISSING
#define ERROR_INT_STATUS_WAKEUP_LSB             MISSING
#define ERROR_INT_STATUS_RX_UNDERFLOW_MASK      MISSING
#define ERROR_INT_STATUS_RX_UNDERFLOW_LSB       MISSING
#define ERROR_INT_STATUS_TX_OVERFLOW_MASK       MISSING
#define ERROR_INT_STATUS_TX_OVERFLOW_LSB        MISSING
#define COUNT_DEC_ADDRESS                       MISSING
#define HOST_INT_STATUS_CPU_MASK                MISSING
#define HOST_INT_STATUS_CPU_LSB                 MISSING
#define HOST_INT_STATUS_ERROR_MASK              MISSING
#define HOST_INT_STATUS_ERROR_LSB               MISSING
#define HOST_INT_STATUS_COUNTER_MASK            MISSING
#define HOST_INT_STATUS_COUNTER_LSB             MISSING
#define RX_LOOKAHEAD_VALID_ADDRESS              MISSING
#define WINDOW_DATA_ADDRESS                     MISSING
#define WINDOW_READ_ADDR_ADDRESS                MISSING
#define WINDOW_WRITE_ADDR_ADDRESS               MISSING

#define QCA9887_1_0_I2C_SDA_GPIO_PIN            5
#define QCA9887_1_0_I2C_SDA_PIN_CONFIG          3
#define QCA9887_1_0_SI_CLK_GPIO_PIN             17
#define QCA9887_1_0_SI_CLK_PIN_CONFIG           3
#define QCA9887_1_0_GPIO_ENABLE_W1TS_LOW_ADDRESS 0x00000010

#define QCA9887_EEPROM_SELECT_READ              0xa10000a0
#define QCA9887_EEPROM_ADDR_HI_MASK             0x0000ff00
#define QCA9887_EEPROM_ADDR_HI_LSB              8
#define QCA9887_EEPROM_ADDR_LO_MASK             0x00ff0000
#define QCA9887_EEPROM_ADDR_LO_LSB              16

#define MBOX_RESET_CONTROL_ADDRESS              0x00000000
#define MBOX_HOST_INT_STATUS_ADDRESS            0x00000800
#define MBOX_HOST_INT_STATUS_ERROR_LSB          7
#define MBOX_HOST_INT_STATUS_ERROR_MASK         0x00000080
#define MBOX_HOST_INT_STATUS_CPU_LSB            6
#define MBOX_HOST_INT_STATUS_CPU_MASK           0x00000040
#define MBOX_HOST_INT_STATUS_COUNTER_LSB        4
#define MBOX_HOST_INT_STATUS_COUNTER_MASK       0x00000010
#define MBOX_CPU_INT_STATUS_ADDRESS             0x00000801
#define MBOX_ERROR_INT_STATUS_ADDRESS           0x00000802
#define MBOX_ERROR_INT_STATUS_WAKEUP_LSB        2
#define MBOX_ERROR_INT_STATUS_WAKEUP_MASK       0x00000004
#define MBOX_ERROR_INT_STATUS_RX_UNDERFLOW_LSB  1
#define MBOX_ERROR_INT_STATUS_RX_UNDERFLOW_MASK 0x00000002
#define MBOX_ERROR_INT_STATUS_TX_OVERFLOW_LSB   0
#define MBOX_ERROR_INT_STATUS_TX_OVERFLOW_MASK  0x00000001
#define MBOX_COUNTER_INT_STATUS_ADDRESS         0x00000803
#define MBOX_COUNTER_INT_STATUS_COUNTER_LSB     0
#define MBOX_COUNTER_INT_STATUS_COUNTER_MASK    0x000000ff
#define MBOX_RX_LOOKAHEAD_VALID_ADDRESS         0x00000805
#define MBOX_INT_STATUS_ENABLE_ADDRESS          0x00000828
#define MBOX_INT_STATUS_ENABLE_ERROR_LSB        7
#define MBOX_INT_STATUS_ENABLE_ERROR_MASK       0x00000080
#define MBOX_INT_STATUS_ENABLE_CPU_LSB          6
#define MBOX_INT_STATUS_ENABLE_CPU_MASK         0x00000040
#define MBOX_INT_STATUS_ENABLE_INT_LSB          5
#define MBOX_INT_STATUS_ENABLE_INT_MASK         0x00000020
#define MBOX_INT_STATUS_ENABLE_COUNTER_LSB      4
#define MBOX_INT_STATUS_ENABLE_COUNTER_MASK     0x00000010
#define MBOX_INT_STATUS_ENABLE_MBOX_DATA_LSB    0
#define MBOX_INT_STATUS_ENABLE_MBOX_DATA_MASK   0x0000000f
#define MBOX_CPU_INT_STATUS_ENABLE_ADDRESS      0x00000819
#define MBOX_CPU_INT_STATUS_ENABLE_BIT_LSB      0
#define MBOX_CPU_INT_STATUS_ENABLE_BIT_MASK     0x000000ff
#define MBOX_CPU_STATUS_ENABLE_ASSERT_MASK 0x00000001
#define MBOX_ERROR_STATUS_ENABLE_ADDRESS        0x0000081a
#define MBOX_ERROR_STATUS_ENABLE_RX_UNDERFLOW_LSB  1
#define MBOX_ERROR_STATUS_ENABLE_RX_UNDERFLOW_MASK 0x00000002
#define MBOX_ERROR_STATUS_ENABLE_TX_OVERFLOW_LSB   0
#define MBOX_ERROR_STATUS_ENABLE_TX_OVERFLOW_MASK  0x00000001
#define MBOX_COUNTER_INT_STATUS_ENABLE_ADDRESS  0x0000081b
#define MBOX_COUNTER_INT_STATUS_ENABLE_BIT_LSB  0
#define MBOX_COUNTER_INT_STATUS_ENABLE_BIT_MASK 0x000000ff
#define MBOX_COUNT_ADDRESS                      0x00000820
#define MBOX_COUNT_DEC_ADDRESS                  0x00000840
#define MBOX_WINDOW_DATA_ADDRESS                0x00000874
#define MBOX_WINDOW_WRITE_ADDR_ADDRESS          0x00000878
#define MBOX_WINDOW_READ_ADDR_ADDRESS           0x0000087c
#define MBOX_CPU_DBG_SEL_ADDRESS                0x00000883
#define MBOX_CPU_DBG_ADDRESS                    0x00000884
#define MBOX_RTC_BASE_ADDRESS                   0x00000000
#define MBOX_GPIO_BASE_ADDRESS                  0x00005000
#define MBOX_MBOX_BASE_ADDRESS                  0x00008000

#define RTC_STATE_V_GET(x) (((x) & RTC_STATE_V_MASK) >> RTC_STATE_V_LSB)

/* Register definitions for first generation ath10k cards. These cards include
 * a mac which has a register allocation similar to ath9k and at least some
 * registers including the ones relevant for modifying the coverage class are
 * identical to the ath9k definitions.
 * These registers are usually managed by the ath10k firmware. However by
 * overriding them it is possible to support coverage class modifications.
 */
#define WAVE1_PCU_ACK_CTS_TIMEOUT               0x8014
#define WAVE1_PCU_ACK_CTS_TIMEOUT_MAX           0x00003FFF
#define WAVE1_PCU_ACK_CTS_TIMEOUT_ACK_MASK      0x00003FFF
#define WAVE1_PCU_ACK_CTS_TIMEOUT_ACK_LSB       0
#define WAVE1_PCU_ACK_CTS_TIMEOUT_CTS_MASK      0x3FFF0000
#define WAVE1_PCU_ACK_CTS_TIMEOUT_CTS_LSB       16

#define WAVE1_PCU_GBL_IFS_SLOT                  0x1070
#define WAVE1_PCU_GBL_IFS_SLOT_MASK             0x0000FFFF
#define WAVE1_PCU_GBL_IFS_SLOT_MAX              0x0000FFFF
#define WAVE1_PCU_GBL_IFS_SLOT_LSB              0
#define WAVE1_PCU_GBL_IFS_SLOT_RESV0            0xFFFF0000

#define WAVE1_PHYCLK                            0x801C
#define WAVE1_PHYCLK_USEC_MASK                  0x0000007F
#define WAVE1_PHYCLK_USEC_LSB                   0

/* qca6174 PLL offset/mask */
#define SOC_CORE_CLK_CTRL_OFFSET                0x00000114
#define SOC_CORE_CLK_CTRL_DIV_LSB               0
#define SOC_CORE_CLK_CTRL_DIV_MASK              0x00000007

#define EFUSE_OFFSET                            0x0000032c
#define EFUSE_XTAL_SEL_LSB                      8
#define EFUSE_XTAL_SEL_MASK                     0x00000700

#define BB_PLL_CONFIG_OFFSET                    0x000002f4
#define BB_PLL_CONFIG_FRAC_LSB                  0
#define BB_PLL_CONFIG_FRAC_MASK                 0x0003ffff
#define BB_PLL_CONFIG_OUTDIV_LSB                18
#define BB_PLL_CONFIG_OUTDIV_MASK               0x001c0000

#define WLAN_PLL_SETTLE_OFFSET                  0x0018
#define WLAN_PLL_SETTLE_TIME_LSB                0
#define WLAN_PLL_SETTLE_TIME_MASK               0x000007ff

#define WLAN_PLL_CONTROL_OFFSET                 0x0014
#define WLAN_PLL_CONTROL_DIV_LSB                0
#define WLAN_PLL_CONTROL_DIV_MASK               0x000003ff
#define WLAN_PLL_CONTROL_REFDIV_LSB             10
#define WLAN_PLL_CONTROL_REFDIV_MASK            0x00003c00
#define WLAN_PLL_CONTROL_BYPASS_LSB             16
#define WLAN_PLL_CONTROL_BYPASS_MASK            0x00010000
#define WLAN_PLL_CONTROL_NOPWD_LSB              18
#define WLAN_PLL_CONTROL_NOPWD_MASK             0x00040000

#define RTC_SYNC_STATUS_OFFSET                  0x0244
#define RTC_SYNC_STATUS_PLL_CHANGING_LSB        5
#define RTC_SYNC_STATUS_PLL_CHANGING_MASK       0x00000020
/* qca6174 PLL offset/mask end */

/* CPU_ADDR_MSB is a register, bit[3:0] is to specify which memory
 * region is accessed. The memory region size is 1M.
 * If host wants to access 0xX12345 at target, then CPU_ADDR_MSB[3:0]
 * is 0xX.
 * The following MACROs are defined to get the 0xX and the size limit.
 */
#define CPU_ADDR_MSB_REGION_MASK        GENMASK(23, 20)
#define CPU_ADDR_MSB_REGION_VAL(X)      FIELD_GET(CPU_ADDR_MSB_REGION_MASK, X)
#define REGION_ACCESS_SIZE_LIMIT        0x100000
#define REGION_ACCESS_SIZE_MASK         (REGION_ACCESS_SIZE_LIMIT - 1)

#endif /* _HW_H_ */