Back to home page

OSCL-LXR

 
 

    


0001 /* SPDX-License-Identifier: GPL-2.0 */
0002 /* Copyright(c) 2009-2012  Realtek Corporation.*/
0003 
0004 #ifndef __RTL_WIFI_H__
0005 #define __RTL_WIFI_H__
0006 
0007 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
0008 
0009 #include <linux/sched.h>
0010 #include <linux/firmware.h>
0011 #include <linux/etherdevice.h>
0012 #include <linux/vmalloc.h>
0013 #include <linux/usb.h>
0014 #include <net/mac80211.h>
0015 #include <linux/completion.h>
0016 #include <linux/bitfield.h>
0017 #include "debug.h"
0018 
0019 #define MASKBYTE0               0xff
0020 #define MASKBYTE1               0xff00
0021 #define MASKBYTE2               0xff0000
0022 #define MASKBYTE3               0xff000000
0023 #define MASKHWORD               0xffff0000
0024 #define MASKLWORD               0x0000ffff
0025 #define MASKDWORD               0xffffffff
0026 #define MASK12BITS              0xfff
0027 #define MASKH4BITS              0xf0000000
0028 #define MASKOFDM_D              0xffc00000
0029 #define MASKCCK                 0x3f3f3f3f
0030 
0031 #define MASK4BITS               0x0f
0032 #define MASK20BITS              0xfffff
0033 #define RFREG_OFFSET_MASK           0xfffff
0034 
0035 #define MASKBYTE0               0xff
0036 #define MASKBYTE1               0xff00
0037 #define MASKBYTE2               0xff0000
0038 #define MASKBYTE3               0xff000000
0039 #define MASKHWORD               0xffff0000
0040 #define MASKLWORD               0x0000ffff
0041 #define MASKDWORD               0xffffffff
0042 #define MASK12BITS              0xfff
0043 #define MASKH4BITS              0xf0000000
0044 #define MASKOFDM_D              0xffc00000
0045 #define MASKCCK                 0x3f3f3f3f
0046 
0047 #define MASK4BITS               0x0f
0048 #define MASK20BITS              0xfffff
0049 #define RFREG_OFFSET_MASK           0xfffff
0050 
0051 #define RF_CHANGE_BY_INIT           0
0052 #define RF_CHANGE_BY_IPS            BIT(28)
0053 #define RF_CHANGE_BY_PS             BIT(29)
0054 #define RF_CHANGE_BY_HW             BIT(30)
0055 #define RF_CHANGE_BY_SW             BIT(31)
0056 
0057 #define IQK_ADDA_REG_NUM            16
0058 #define IQK_MAC_REG_NUM             4
0059 #define IQK_THRESHOLD               8
0060 
0061 #define MAX_KEY_LEN             61
0062 #define KEY_BUF_SIZE                5
0063 
0064 /* QoS related. */
0065 /*aci: 0x00 Best Effort*/
0066 /*aci: 0x01 Background*/
0067 /*aci: 0x10 Video*/
0068 /*aci: 0x11 Voice*/
0069 /*Max: define total number.*/
0070 #define AC0_BE                  0
0071 #define AC1_BK                  1
0072 #define AC2_VI                  2
0073 #define AC3_VO                  3
0074 #define AC_MAX                  4
0075 #define QOS_QUEUE_NUM               4
0076 #define RTL_MAC80211_NUM_QUEUE          5
0077 #define REALTEK_USB_VENQT_MAX_BUF_SIZE      254
0078 #define RTL_USB_MAX_RX_COUNT            100
0079 #define QBSS_LOAD_SIZE              5
0080 #define MAX_WMMELE_LENGTH           64
0081 #define ASPM_L1_LATENCY             7
0082 
0083 #define TOTAL_CAM_ENTRY             32
0084 
0085 /*slot time for 11g. */
0086 #define RTL_SLOT_TIME_9             9
0087 #define RTL_SLOT_TIME_20            20
0088 
0089 /*related to tcp/ip. */
0090 #define SNAP_SIZE       6
0091 #define PROTOC_TYPE_SIZE    2
0092 
0093 /*related with 802.11 frame*/
0094 #define MAC80211_3ADDR_LEN          24
0095 #define MAC80211_4ADDR_LEN          30
0096 
0097 #define CHANNEL_MAX_NUMBER  (14 + 24 + 21)  /* 14 is the max channel no */
0098 #define CHANNEL_MAX_NUMBER_2G       14
0099 #define CHANNEL_MAX_NUMBER_5G       49 /* Please refer to
0100                         *"phy_GetChnlGroup8812A" and
0101                         * "Hal_ReadTxPowerInfo8812A"
0102                         */
0103 #define CHANNEL_MAX_NUMBER_5G_80M   7
0104 #define CHANNEL_GROUP_MAX   (3 + 9) /*  ch1~3, 4~9, 10~14 = three groups */
0105 #define MAX_PG_GROUP            13
0106 #define CHANNEL_GROUP_MAX_2G        3
0107 #define CHANNEL_GROUP_IDX_5GL       3
0108 #define CHANNEL_GROUP_IDX_5GM       6
0109 #define CHANNEL_GROUP_IDX_5GH       9
0110 #define CHANNEL_GROUP_MAX_5G        9
0111 #define AVG_THERMAL_NUM         8
0112 #define AVG_THERMAL_NUM_88E     4
0113 #define AVG_THERMAL_NUM_8723BE      4
0114 #define MAX_TID_COUNT           9
0115 
0116 /* for early mode */
0117 #define FCS_LEN             4
0118 #define EM_HDR_LEN          8
0119 
0120 enum rtl8192c_h2c_cmd {
0121     H2C_AP_OFFLOAD = 0,
0122     H2C_SETPWRMODE = 1,
0123     H2C_JOINBSSRPT = 2,
0124     H2C_RSVDPAGE = 3,
0125     H2C_RSSI_REPORT = 5,
0126     H2C_RA_MASK = 6,
0127     H2C_MACID_PS_MODE = 7,
0128     H2C_P2P_PS_OFFLOAD = 8,
0129     H2C_MAC_MODE_SEL = 9,
0130     H2C_PWRM = 15,
0131     H2C_P2P_PS_CTW_CMD = 24,
0132     MAX_H2CCMD
0133 };
0134 
0135 enum {
0136     H2C_BT_PORT_ID = 0x71,
0137 };
0138 
0139 enum rtl_c2h_evt_v1 {
0140     C2H_DBG = 0,
0141     C2H_LB = 1,
0142     C2H_TXBF = 2,
0143     C2H_TX_REPORT = 3,
0144     C2H_BT_INFO = 9,
0145     C2H_BT_MP = 11,
0146     C2H_RA_RPT = 12,
0147 
0148     C2H_FW_SWCHNL = 0x10,
0149     C2H_IQK_FINISH = 0x11,
0150 
0151     C2H_EXT_V2 = 0xFF,
0152 };
0153 
0154 enum rtl_c2h_evt_v2 {
0155     C2H_V2_CCX_RPT = 0x0F,
0156 };
0157 
0158 #define GET_C2H_CMD_ID(c2h) ({u8 *__c2h = c2h; __c2h[0]; })
0159 #define GET_C2H_SEQ(c2h)    ({u8 *__c2h = c2h; __c2h[1]; })
0160 #define C2H_DATA_OFFSET     2
0161 #define GET_C2H_DATA_PTR(c2h)   ({u8 *__c2h = c2h; &__c2h[C2H_DATA_OFFSET]; })
0162 
0163 #define GET_TX_REPORT_SN_V1(c2h)    (c2h[6])
0164 #define GET_TX_REPORT_ST_V1(c2h)    (c2h[0] & 0xC0)
0165 #define GET_TX_REPORT_RETRY_V1(c2h) (c2h[2] & 0x3F)
0166 #define GET_TX_REPORT_SN_V2(c2h)    (c2h[6])
0167 #define GET_TX_REPORT_ST_V2(c2h)    (c2h[7] & 0xC0)
0168 #define GET_TX_REPORT_RETRY_V2(c2h) (c2h[8] & 0x3F)
0169 
0170 #define MAX_TX_COUNT            4
0171 #define MAX_REGULATION_NUM      4
0172 #define MAX_RF_PATH_NUM         4
0173 #define MAX_RATE_SECTION_NUM        6   /* = MAX_RATE_SECTION */
0174 #define MAX_2_4G_BANDWIDTH_NUM      4
0175 #define MAX_5G_BANDWIDTH_NUM        4
0176 #define MAX_RF_PATH         4
0177 #define MAX_CHNL_GROUP_24G      6
0178 #define MAX_CHNL_GROUP_5G       14
0179 
0180 #define TX_PWR_BY_RATE_NUM_BAND     2
0181 #define TX_PWR_BY_RATE_NUM_RF       4
0182 #define TX_PWR_BY_RATE_NUM_SECTION  12
0183 #define TX_PWR_BY_RATE_NUM_RATE     84 /* >= TX_PWR_BY_RATE_NUM_SECTION */
0184 #define MAX_BASE_NUM_IN_PHY_REG_PG_24G  6  /* MAX_RATE_SECTION */
0185 #define MAX_BASE_NUM_IN_PHY_REG_PG_5G   5  /* MAX_RATE_SECTION -1 */
0186 
0187 #define BUFDESC_SEG_NUM     1 /* 0:2 seg, 1: 4 seg, 2: 8 seg */
0188 
0189 #define DEL_SW_IDX_SZ       30
0190 
0191 /* For now, it's just for 8192ee
0192  * but not OK yet, keep it 0
0193  */
0194 #define RTL8192EE_SEG_NUM       BUFDESC_SEG_NUM
0195 
0196 enum rf_tx_num {
0197     RF_1TX = 0,
0198     RF_2TX,
0199     RF_MAX_TX_NUM,
0200     RF_TX_NUM_NONIMPLEMENT,
0201 };
0202 
0203 #define PACKET_NORMAL           0
0204 #define PACKET_DHCP         1
0205 #define PACKET_ARP          2
0206 #define PACKET_EAPOL            3
0207 
0208 #define MAX_SUPPORT_WOL_PATTERN_NUM 16
0209 #define RSVD_WOL_PATTERN_NUM        1
0210 #define WKFMCAM_ADDR_NUM        6
0211 #define WKFMCAM_SIZE            24
0212 
0213 #define MAX_WOL_BIT_MASK_SIZE       16
0214 /* MIN LEN keeps 13 here */
0215 #define MIN_WOL_PATTERN_SIZE        13
0216 #define MAX_WOL_PATTERN_SIZE        128
0217 
0218 #define WAKE_ON_MAGIC_PACKET        BIT(0)
0219 #define WAKE_ON_PATTERN_MATCH       BIT(1)
0220 
0221 #define WOL_REASON_PTK_UPDATE       BIT(0)
0222 #define WOL_REASON_GTK_UPDATE       BIT(1)
0223 #define WOL_REASON_DISASSOC     BIT(2)
0224 #define WOL_REASON_DEAUTH       BIT(3)
0225 #define WOL_REASON_AP_LOST      BIT(4)
0226 #define WOL_REASON_MAGIC_PKT        BIT(5)
0227 #define WOL_REASON_UNICAST_PKT      BIT(6)
0228 #define WOL_REASON_PATTERN_PKT      BIT(7)
0229 #define WOL_REASON_RTD3_SSID_MATCH  BIT(8)
0230 #define WOL_REASON_REALWOW_V2_WAKEUPPKT BIT(9)
0231 #define WOL_REASON_REALWOW_V2_ACKLOST   BIT(10)
0232 
0233 struct rtlwifi_firmware_header {
0234     __le16 signature;
0235     u8 category;
0236     u8 function;
0237     __le16 version;
0238     u8 subversion;
0239     u8 rsvd1;
0240     u8 month;
0241     u8 date;
0242     u8 hour;
0243     u8 minute;
0244     __le16 ramcodesize;
0245     __le16 rsvd2;
0246     __le32 svnindex;
0247     __le32 rsvd3;
0248     __le32 rsvd4;
0249     __le32 rsvd5;
0250 };
0251 
0252 struct txpower_info_2g {
0253     u8 index_cck_base[MAX_RF_PATH][MAX_CHNL_GROUP_24G];
0254     u8 index_bw40_base[MAX_RF_PATH][MAX_CHNL_GROUP_24G];
0255     /*If only one tx, only BW20 and OFDM are used.*/
0256     u8 cck_diff[MAX_RF_PATH][MAX_TX_COUNT];
0257     u8 ofdm_diff[MAX_RF_PATH][MAX_TX_COUNT];
0258     u8 bw20_diff[MAX_RF_PATH][MAX_TX_COUNT];
0259     u8 bw40_diff[MAX_RF_PATH][MAX_TX_COUNT];
0260     u8 bw80_diff[MAX_RF_PATH][MAX_TX_COUNT];
0261     u8 bw160_diff[MAX_RF_PATH][MAX_TX_COUNT];
0262 };
0263 
0264 struct txpower_info_5g {
0265     u8 index_bw40_base[MAX_RF_PATH][MAX_CHNL_GROUP_5G];
0266     /*If only one tx, only BW20, OFDM, BW80 and BW160 are used.*/
0267     u8 ofdm_diff[MAX_RF_PATH][MAX_TX_COUNT];
0268     u8 bw20_diff[MAX_RF_PATH][MAX_TX_COUNT];
0269     u8 bw40_diff[MAX_RF_PATH][MAX_TX_COUNT];
0270     u8 bw80_diff[MAX_RF_PATH][MAX_TX_COUNT];
0271     u8 bw160_diff[MAX_RF_PATH][MAX_TX_COUNT];
0272 };
0273 
0274 enum rate_section {
0275     CCK = 0,
0276     OFDM,
0277     HT_MCS0_MCS7,
0278     HT_MCS8_MCS15,
0279     VHT_1SSMCS0_1SSMCS9,
0280     VHT_2SSMCS0_2SSMCS9,
0281     MAX_RATE_SECTION,
0282 };
0283 
0284 enum intf_type {
0285     INTF_PCI = 0,
0286     INTF_USB = 1,
0287 };
0288 
0289 enum radio_path {
0290     RF90_PATH_A = 0,
0291     RF90_PATH_B = 1,
0292     RF90_PATH_C = 2,
0293     RF90_PATH_D = 3,
0294 };
0295 
0296 enum radio_mask {
0297     RF_MASK_A = BIT(0),
0298     RF_MASK_B = BIT(1),
0299     RF_MASK_C = BIT(2),
0300     RF_MASK_D = BIT(3),
0301 };
0302 
0303 enum regulation_txpwr_lmt {
0304     TXPWR_LMT_FCC = 0,
0305     TXPWR_LMT_MKK = 1,
0306     TXPWR_LMT_ETSI = 2,
0307     TXPWR_LMT_WW = 3,
0308 
0309     TXPWR_LMT_MAX_REGULATION_NUM = 4
0310 };
0311 
0312 enum rt_eeprom_type {
0313     EEPROM_93C46,
0314     EEPROM_93C56,
0315     EEPROM_BOOT_EFUSE,
0316 };
0317 
0318 enum ttl_status {
0319     RTL_STATUS_INTERFACE_START = 0,
0320 };
0321 
0322 enum hardware_type {
0323     HARDWARE_TYPE_RTL8192E,
0324     HARDWARE_TYPE_RTL8192U,
0325     HARDWARE_TYPE_RTL8192SE,
0326     HARDWARE_TYPE_RTL8192SU,
0327     HARDWARE_TYPE_RTL8192CE,
0328     HARDWARE_TYPE_RTL8192CU,
0329     HARDWARE_TYPE_RTL8192DE,
0330     HARDWARE_TYPE_RTL8192DU,
0331     HARDWARE_TYPE_RTL8723AE,
0332     HARDWARE_TYPE_RTL8723U,
0333     HARDWARE_TYPE_RTL8188EE,
0334     HARDWARE_TYPE_RTL8723BE,
0335     HARDWARE_TYPE_RTL8192EE,
0336     HARDWARE_TYPE_RTL8821AE,
0337     HARDWARE_TYPE_RTL8812AE,
0338     HARDWARE_TYPE_RTL8822BE,
0339 
0340     /* keep it last */
0341     HARDWARE_TYPE_NUM
0342 };
0343 
0344 #define RTL_HW_TYPE(rtlpriv)    (rtl_hal((struct rtl_priv *)rtlpriv)->hw_type)
0345 #define IS_NEW_GENERATION_IC(rtlpriv)           \
0346             (RTL_HW_TYPE(rtlpriv) >= HARDWARE_TYPE_RTL8192EE)
0347 #define IS_HARDWARE_TYPE_8192CE(rtlpriv)        \
0348             (RTL_HW_TYPE(rtlpriv) == HARDWARE_TYPE_RTL8192CE)
0349 #define IS_HARDWARE_TYPE_8812(rtlpriv)          \
0350             (RTL_HW_TYPE(rtlpriv) == HARDWARE_TYPE_RTL8812AE)
0351 #define IS_HARDWARE_TYPE_8821(rtlpriv)          \
0352             (RTL_HW_TYPE(rtlpriv) == HARDWARE_TYPE_RTL8821AE)
0353 #define IS_HARDWARE_TYPE_8723A(rtlpriv)         \
0354             (RTL_HW_TYPE(rtlpriv) == HARDWARE_TYPE_RTL8723AE)
0355 #define IS_HARDWARE_TYPE_8723B(rtlpriv)         \
0356             (RTL_HW_TYPE(rtlpriv) == HARDWARE_TYPE_RTL8723BE)
0357 #define IS_HARDWARE_TYPE_8192E(rtlpriv)         \
0358             (RTL_HW_TYPE(rtlpriv) == HARDWARE_TYPE_RTL8192EE)
0359 #define IS_HARDWARE_TYPE_8822B(rtlpriv)         \
0360             (RTL_HW_TYPE(rtlpriv) == HARDWARE_TYPE_RTL8822BE)
0361 
0362 #define RX_HAL_IS_CCK_RATE(rxmcs)           \
0363     ((rxmcs) == DESC_RATE1M ||          \
0364      (rxmcs) == DESC_RATE2M ||          \
0365      (rxmcs) == DESC_RATE5_5M ||            \
0366      (rxmcs) == DESC_RATE11M)
0367 
0368 enum scan_operation_backup_opt {
0369     SCAN_OPT_BACKUP = 0,
0370     SCAN_OPT_BACKUP_BAND0 = 0,
0371     SCAN_OPT_BACKUP_BAND1,
0372     SCAN_OPT_RESTORE,
0373     SCAN_OPT_MAX
0374 };
0375 
0376 /*RF state.*/
0377 enum rf_pwrstate {
0378     ERFON,
0379     ERFSLEEP,
0380     ERFOFF
0381 };
0382 
0383 struct bb_reg_def {
0384     u32 rfintfs;
0385     u32 rfintfi;
0386     u32 rfintfo;
0387     u32 rfintfe;
0388     u32 rf3wire_offset;
0389     u32 rflssi_select;
0390     u32 rftxgain_stage;
0391     u32 rfhssi_para1;
0392     u32 rfhssi_para2;
0393     u32 rfsw_ctrl;
0394     u32 rfagc_control1;
0395     u32 rfagc_control2;
0396     u32 rfrxiq_imbal;
0397     u32 rfrx_afe;
0398     u32 rftxiq_imbal;
0399     u32 rftx_afe;
0400     u32 rf_rb;      /* rflssi_readback */
0401     u32 rf_rbpi;        /* rflssi_readbackpi */
0402 };
0403 
0404 enum io_type {
0405     IO_CMD_PAUSE_DM_BY_SCAN = 0,
0406     IO_CMD_PAUSE_BAND0_DM_BY_SCAN = 0,
0407     IO_CMD_PAUSE_BAND1_DM_BY_SCAN = 1,
0408     IO_CMD_RESUME_DM_BY_SCAN = 2,
0409 };
0410 
0411 enum hw_variables {
0412     HW_VAR_ETHER_ADDR = 0x0,
0413     HW_VAR_MULTICAST_REG = 0x1,
0414     HW_VAR_BASIC_RATE = 0x2,
0415     HW_VAR_BSSID = 0x3,
0416     HW_VAR_MEDIA_STATUS = 0x4,
0417     HW_VAR_SECURITY_CONF = 0x5,
0418     HW_VAR_BEACON_INTERVAL = 0x6,
0419     HW_VAR_ATIM_WINDOW = 0x7,
0420     HW_VAR_LISTEN_INTERVAL = 0x8,
0421     HW_VAR_CS_COUNTER = 0x9,
0422     HW_VAR_DEFAULTKEY0 = 0xa,
0423     HW_VAR_DEFAULTKEY1 = 0xb,
0424     HW_VAR_DEFAULTKEY2 = 0xc,
0425     HW_VAR_DEFAULTKEY3 = 0xd,
0426     HW_VAR_SIFS = 0xe,
0427     HW_VAR_R2T_SIFS = 0xf,
0428     HW_VAR_DIFS = 0x10,
0429     HW_VAR_EIFS = 0x11,
0430     HW_VAR_SLOT_TIME = 0x12,
0431     HW_VAR_ACK_PREAMBLE = 0x13,
0432     HW_VAR_CW_CONFIG = 0x14,
0433     HW_VAR_CW_VALUES = 0x15,
0434     HW_VAR_RATE_FALLBACK_CONTROL = 0x16,
0435     HW_VAR_CONTENTION_WINDOW = 0x17,
0436     HW_VAR_RETRY_COUNT = 0x18,
0437     HW_VAR_TR_SWITCH = 0x19,
0438     HW_VAR_COMMAND = 0x1a,
0439     HW_VAR_WPA_CONFIG = 0x1b,
0440     HW_VAR_AMPDU_MIN_SPACE = 0x1c,
0441     HW_VAR_SHORTGI_DENSITY = 0x1d,
0442     HW_VAR_AMPDU_FACTOR = 0x1e,
0443     HW_VAR_MCS_RATE_AVAILABLE = 0x1f,
0444     HW_VAR_AC_PARAM = 0x20,
0445     HW_VAR_ACM_CTRL = 0x21,
0446     HW_VAR_DIS_REQ_QSIZE = 0x22,
0447     HW_VAR_CCX_CHNL_LOAD = 0x23,
0448     HW_VAR_CCX_NOISE_HISTOGRAM = 0x24,
0449     HW_VAR_CCX_CLM_NHM = 0x25,
0450     HW_VAR_TXOPLIMIT = 0x26,
0451     HW_VAR_TURBO_MODE = 0x27,
0452     HW_VAR_RF_STATE = 0x28,
0453     HW_VAR_RF_OFF_BY_HW = 0x29,
0454     HW_VAR_BUS_SPEED = 0x2a,
0455     HW_VAR_SET_DEV_POWER = 0x2b,
0456 
0457     HW_VAR_RCR = 0x2c,
0458     HW_VAR_RATR_0 = 0x2d,
0459     HW_VAR_RRSR = 0x2e,
0460     HW_VAR_CPU_RST = 0x2f,
0461     HW_VAR_CHECK_BSSID = 0x30,
0462     HW_VAR_LBK_MODE = 0x31,
0463     HW_VAR_AES_11N_FIX = 0x32,
0464     HW_VAR_USB_RX_AGGR = 0x33,
0465     HW_VAR_USER_CONTROL_TURBO_MODE = 0x34,
0466     HW_VAR_RETRY_LIMIT = 0x35,
0467     HW_VAR_INIT_TX_RATE = 0x36,
0468     HW_VAR_TX_RATE_REG = 0x37,
0469     HW_VAR_EFUSE_USAGE = 0x38,
0470     HW_VAR_EFUSE_BYTES = 0x39,
0471     HW_VAR_AUTOLOAD_STATUS = 0x3a,
0472     HW_VAR_RF_2R_DISABLE = 0x3b,
0473     HW_VAR_SET_RPWM = 0x3c,
0474     HW_VAR_H2C_FW_PWRMODE = 0x3d,
0475     HW_VAR_H2C_FW_JOINBSSRPT = 0x3e,
0476     HW_VAR_H2C_FW_MEDIASTATUSRPT = 0x3f,
0477     HW_VAR_H2C_FW_P2P_PS_OFFLOAD = 0x40,
0478     HW_VAR_FW_PSMODE_STATUS = 0x41,
0479     HW_VAR_INIT_RTS_RATE = 0x42,
0480     HW_VAR_RESUME_CLK_ON = 0x43,
0481     HW_VAR_FW_LPS_ACTION = 0x44,
0482     HW_VAR_1X1_RECV_COMBINE = 0x45,
0483     HW_VAR_STOP_SEND_BEACON = 0x46,
0484     HW_VAR_TSF_TIMER = 0x47,
0485     HW_VAR_IO_CMD = 0x48,
0486 
0487     HW_VAR_RF_RECOVERY = 0x49,
0488     HW_VAR_H2C_FW_UPDATE_GTK = 0x4a,
0489     HW_VAR_WF_MASK = 0x4b,
0490     HW_VAR_WF_CRC = 0x4c,
0491     HW_VAR_WF_IS_MAC_ADDR = 0x4d,
0492     HW_VAR_H2C_FW_OFFLOAD = 0x4e,
0493     HW_VAR_RESET_WFCRC = 0x4f,
0494 
0495     HW_VAR_HANDLE_FW_C2H = 0x50,
0496     HW_VAR_DL_FW_RSVD_PAGE = 0x51,
0497     HW_VAR_AID = 0x52,
0498     HW_VAR_HW_SEQ_ENABLE = 0x53,
0499     HW_VAR_CORRECT_TSF = 0x54,
0500     HW_VAR_BCN_VALID = 0x55,
0501     HW_VAR_FWLPS_RF_ON = 0x56,
0502     HW_VAR_DUAL_TSF_RST = 0x57,
0503     HW_VAR_SWITCH_EPHY_WOWLAN = 0x58,
0504     HW_VAR_INT_MIGRATION = 0x59,
0505     HW_VAR_INT_AC = 0x5a,
0506     HW_VAR_RF_TIMING = 0x5b,
0507 
0508     HAL_DEF_WOWLAN = 0x5c,
0509     HW_VAR_MRC = 0x5d,
0510     HW_VAR_KEEP_ALIVE = 0x5e,
0511     HW_VAR_NAV_UPPER = 0x5f,
0512 
0513     HW_VAR_MGT_FILTER = 0x60,
0514     HW_VAR_CTRL_FILTER = 0x61,
0515     HW_VAR_DATA_FILTER = 0x62,
0516 };
0517 
0518 enum rt_media_status {
0519     RT_MEDIA_DISCONNECT = 0,
0520     RT_MEDIA_CONNECT = 1
0521 };
0522 
0523 enum rt_oem_id {
0524     RT_CID_DEFAULT = 0,
0525     RT_CID_8187_ALPHA0 = 1,
0526     RT_CID_8187_SERCOMM_PS = 2,
0527     RT_CID_8187_HW_LED = 3,
0528     RT_CID_8187_NETGEAR = 4,
0529     RT_CID_WHQL = 5,
0530     RT_CID_819X_CAMEO = 6,
0531     RT_CID_819X_RUNTOP = 7,
0532     RT_CID_819X_SENAO = 8,
0533     RT_CID_TOSHIBA = 9,
0534     RT_CID_819X_NETCORE = 10,
0535     RT_CID_NETTRONIX = 11,
0536     RT_CID_DLINK = 12,
0537     RT_CID_PRONET = 13,
0538     RT_CID_COREGA = 14,
0539     RT_CID_819X_ALPHA = 15,
0540     RT_CID_819X_SITECOM = 16,
0541     RT_CID_CCX = 17,
0542     RT_CID_819X_LENOVO = 18,
0543     RT_CID_819X_QMI = 19,
0544     RT_CID_819X_EDIMAX_BELKIN = 20,
0545     RT_CID_819X_SERCOMM_BELKIN = 21,
0546     RT_CID_819X_CAMEO1 = 22,
0547     RT_CID_819X_MSI = 23,
0548     RT_CID_819X_ACER = 24,
0549     RT_CID_819X_HP = 27,
0550     RT_CID_819X_CLEVO = 28,
0551     RT_CID_819X_ARCADYAN_BELKIN = 29,
0552     RT_CID_819X_SAMSUNG = 30,
0553     RT_CID_819X_WNC_COREGA = 31,
0554     RT_CID_819X_FOXCOON = 32,
0555     RT_CID_819X_DELL = 33,
0556     RT_CID_819X_PRONETS = 34,
0557     RT_CID_819X_EDIMAX_ASUS = 35,
0558     RT_CID_NETGEAR = 36,
0559     RT_CID_PLANEX = 37,
0560     RT_CID_CC_C = 38,
0561     RT_CID_LENOVO_CHINA = 40,
0562 };
0563 
0564 enum hw_descs {
0565     HW_DESC_OWN,
0566     HW_DESC_RXOWN,
0567     HW_DESC_TX_NEXTDESC_ADDR,
0568     HW_DESC_TXBUFF_ADDR,
0569     HW_DESC_RXBUFF_ADDR,
0570     HW_DESC_RXPKT_LEN,
0571     HW_DESC_RXERO,
0572     HW_DESC_RX_PREPARE,
0573 };
0574 
0575 enum prime_sc {
0576     PRIME_CHNL_OFFSET_DONT_CARE = 0,
0577     PRIME_CHNL_OFFSET_LOWER = 1,
0578     PRIME_CHNL_OFFSET_UPPER = 2,
0579 };
0580 
0581 enum rf_type {
0582     RF_1T1R = 0,
0583     RF_1T2R = 1,
0584     RF_2T2R = 2,
0585     RF_2T2R_GREEN = 3,
0586     RF_2T3R = 4,
0587     RF_2T4R = 5,
0588     RF_3T3R = 6,
0589     RF_3T4R = 7,
0590     RF_4T4R = 8,
0591 };
0592 
0593 enum ht_channel_width {
0594     HT_CHANNEL_WIDTH_20 = 0,
0595     HT_CHANNEL_WIDTH_20_40 = 1,
0596     HT_CHANNEL_WIDTH_80 = 2,
0597     HT_CHANNEL_WIDTH_MAX,
0598 };
0599 
0600 /* Ref: 802.11i spec D10.0 7.3.2.25.1
0601  * Cipher Suites Encryption Algorithms
0602  */
0603 enum rt_enc_alg {
0604     NO_ENCRYPTION = 0,
0605     WEP40_ENCRYPTION = 1,
0606     TKIP_ENCRYPTION = 2,
0607     RSERVED_ENCRYPTION = 3,
0608     AESCCMP_ENCRYPTION = 4,
0609     WEP104_ENCRYPTION = 5,
0610     AESCMAC_ENCRYPTION = 6, /*IEEE802.11w */
0611 };
0612 
0613 enum rtl_hal_state {
0614     _HAL_STATE_STOP = 0,
0615     _HAL_STATE_START = 1,
0616 };
0617 
0618 enum rtl_desc_rate {
0619     DESC_RATE1M = 0x00,
0620     DESC_RATE2M = 0x01,
0621     DESC_RATE5_5M = 0x02,
0622     DESC_RATE11M = 0x03,
0623 
0624     DESC_RATE6M = 0x04,
0625     DESC_RATE9M = 0x05,
0626     DESC_RATE12M = 0x06,
0627     DESC_RATE18M = 0x07,
0628     DESC_RATE24M = 0x08,
0629     DESC_RATE36M = 0x09,
0630     DESC_RATE48M = 0x0a,
0631     DESC_RATE54M = 0x0b,
0632 
0633     DESC_RATEMCS0 = 0x0c,
0634     DESC_RATEMCS1 = 0x0d,
0635     DESC_RATEMCS2 = 0x0e,
0636     DESC_RATEMCS3 = 0x0f,
0637     DESC_RATEMCS4 = 0x10,
0638     DESC_RATEMCS5 = 0x11,
0639     DESC_RATEMCS6 = 0x12,
0640     DESC_RATEMCS7 = 0x13,
0641     DESC_RATEMCS8 = 0x14,
0642     DESC_RATEMCS9 = 0x15,
0643     DESC_RATEMCS10 = 0x16,
0644     DESC_RATEMCS11 = 0x17,
0645     DESC_RATEMCS12 = 0x18,
0646     DESC_RATEMCS13 = 0x19,
0647     DESC_RATEMCS14 = 0x1a,
0648     DESC_RATEMCS15 = 0x1b,
0649     DESC_RATEMCS15_SG = 0x1c,
0650     DESC_RATEMCS32 = 0x20,
0651 
0652     DESC_RATEVHT1SS_MCS0 = 0x2c,
0653     DESC_RATEVHT1SS_MCS1 = 0x2d,
0654     DESC_RATEVHT1SS_MCS2 = 0x2e,
0655     DESC_RATEVHT1SS_MCS3 = 0x2f,
0656     DESC_RATEVHT1SS_MCS4 = 0x30,
0657     DESC_RATEVHT1SS_MCS5 = 0x31,
0658     DESC_RATEVHT1SS_MCS6 = 0x32,
0659     DESC_RATEVHT1SS_MCS7 = 0x33,
0660     DESC_RATEVHT1SS_MCS8 = 0x34,
0661     DESC_RATEVHT1SS_MCS9 = 0x35,
0662     DESC_RATEVHT2SS_MCS0 = 0x36,
0663     DESC_RATEVHT2SS_MCS1 = 0x37,
0664     DESC_RATEVHT2SS_MCS2 = 0x38,
0665     DESC_RATEVHT2SS_MCS3 = 0x39,
0666     DESC_RATEVHT2SS_MCS4 = 0x3a,
0667     DESC_RATEVHT2SS_MCS5 = 0x3b,
0668     DESC_RATEVHT2SS_MCS6 = 0x3c,
0669     DESC_RATEVHT2SS_MCS7 = 0x3d,
0670     DESC_RATEVHT2SS_MCS8 = 0x3e,
0671     DESC_RATEVHT2SS_MCS9 = 0x3f,
0672 };
0673 
0674 enum rtl_var_map {
0675     /*reg map */
0676     SYS_ISO_CTRL = 0,
0677     SYS_FUNC_EN,
0678     SYS_CLK,
0679     MAC_RCR_AM,
0680     MAC_RCR_AB,
0681     MAC_RCR_ACRC32,
0682     MAC_RCR_ACF,
0683     MAC_RCR_AAP,
0684     MAC_HIMR,
0685     MAC_HIMRE,
0686     MAC_HSISR,
0687 
0688     /*efuse map */
0689     EFUSE_TEST,
0690     EFUSE_CTRL,
0691     EFUSE_CLK,
0692     EFUSE_CLK_CTRL,
0693     EFUSE_PWC_EV12V,
0694     EFUSE_FEN_ELDR,
0695     EFUSE_LOADER_CLK_EN,
0696     EFUSE_ANA8M,
0697     EFUSE_HWSET_MAX_SIZE,
0698     EFUSE_MAX_SECTION_MAP,
0699     EFUSE_REAL_CONTENT_SIZE,
0700     EFUSE_OOB_PROTECT_BYTES_LEN,
0701     EFUSE_ACCESS,
0702 
0703     /*CAM map */
0704     RWCAM,
0705     WCAMI,
0706     RCAMO,
0707     CAMDBG,
0708     SECR,
0709     SEC_CAM_NONE,
0710     SEC_CAM_WEP40,
0711     SEC_CAM_TKIP,
0712     SEC_CAM_AES,
0713     SEC_CAM_WEP104,
0714 
0715     /*IMR map */
0716     RTL_IMR_BCNDMAINT6, /*Beacon DMA Interrupt 6 */
0717     RTL_IMR_BCNDMAINT5, /*Beacon DMA Interrupt 5 */
0718     RTL_IMR_BCNDMAINT4, /*Beacon DMA Interrupt 4 */
0719     RTL_IMR_BCNDMAINT3, /*Beacon DMA Interrupt 3 */
0720     RTL_IMR_BCNDMAINT2, /*Beacon DMA Interrupt 2 */
0721     RTL_IMR_BCNDMAINT1, /*Beacon DMA Interrupt 1 */
0722     RTL_IMR_BCNDOK8,    /*Beacon Queue DMA OK Interrup 8 */
0723     RTL_IMR_BCNDOK7,    /*Beacon Queue DMA OK Interrup 7 */
0724     RTL_IMR_BCNDOK6,    /*Beacon Queue DMA OK Interrup 6 */
0725     RTL_IMR_BCNDOK5,    /*Beacon Queue DMA OK Interrup 5 */
0726     RTL_IMR_BCNDOK4,    /*Beacon Queue DMA OK Interrup 4 */
0727     RTL_IMR_BCNDOK3,    /*Beacon Queue DMA OK Interrup 3 */
0728     RTL_IMR_BCNDOK2,    /*Beacon Queue DMA OK Interrup 2 */
0729     RTL_IMR_BCNDOK1,    /*Beacon Queue DMA OK Interrup 1 */
0730     RTL_IMR_TIMEOUT2,   /*Timeout interrupt 2 */
0731     RTL_IMR_TIMEOUT1,   /*Timeout interrupt 1 */
0732     RTL_IMR_TXFOVW,     /*Transmit FIFO Overflow */
0733     RTL_IMR_PSTIMEOUT,  /*Power save time out interrupt */
0734     RTL_IMR_BCNINT,     /*Beacon DMA Interrupt 0 */
0735     RTL_IMR_RXFOVW,     /*Receive FIFO Overflow */
0736     RTL_IMR_RDU,        /*Receive Descriptor Unavailable */
0737     RTL_IMR_ATIMEND,    /*For 92C,ATIM Window End Interrupt */
0738     RTL_IMR_H2CDOK,     /*H2C Queue DMA OK Interrupt */
0739     RTL_IMR_BDOK,       /*Beacon Queue DMA OK Interrup */
0740     RTL_IMR_HIGHDOK,    /*High Queue DMA OK Interrupt */
0741     RTL_IMR_COMDOK,     /*Command Queue DMA OK Interrupt*/
0742     RTL_IMR_TBDOK,      /*Transmit Beacon OK interrup */
0743     RTL_IMR_MGNTDOK,    /*Management Queue DMA OK Interrupt */
0744     RTL_IMR_TBDER,      /*For 92C,Transmit Beacon Error Interrupt */
0745     RTL_IMR_BKDOK,      /*AC_BK DMA OK Interrupt */
0746     RTL_IMR_BEDOK,      /*AC_BE DMA OK Interrupt */
0747     RTL_IMR_VIDOK,      /*AC_VI DMA OK Interrupt */
0748     RTL_IMR_VODOK,      /*AC_VO DMA Interrupt */
0749     RTL_IMR_ROK,        /*Receive DMA OK Interrupt */
0750     RTL_IMR_HSISR_IND,  /*HSISR Interrupt*/
0751     RTL_IBSS_INT_MASKS, /*(RTL_IMR_BCNINT | RTL_IMR_TBDOK |
0752                  * RTL_IMR_TBDER)
0753                  */
0754     RTL_IMR_C2HCMD,     /*fw interrupt*/
0755 
0756     /*CCK Rates, TxHT = 0 */
0757     RTL_RC_CCK_RATE1M,
0758     RTL_RC_CCK_RATE2M,
0759     RTL_RC_CCK_RATE5_5M,
0760     RTL_RC_CCK_RATE11M,
0761 
0762     /*OFDM Rates, TxHT = 0 */
0763     RTL_RC_OFDM_RATE6M,
0764     RTL_RC_OFDM_RATE9M,
0765     RTL_RC_OFDM_RATE12M,
0766     RTL_RC_OFDM_RATE18M,
0767     RTL_RC_OFDM_RATE24M,
0768     RTL_RC_OFDM_RATE36M,
0769     RTL_RC_OFDM_RATE48M,
0770     RTL_RC_OFDM_RATE54M,
0771 
0772     RTL_RC_HT_RATEMCS7,
0773     RTL_RC_HT_RATEMCS15,
0774 
0775     RTL_RC_VHT_RATE_1SS_MCS7,
0776     RTL_RC_VHT_RATE_1SS_MCS8,
0777     RTL_RC_VHT_RATE_1SS_MCS9,
0778     RTL_RC_VHT_RATE_2SS_MCS7,
0779     RTL_RC_VHT_RATE_2SS_MCS8,
0780     RTL_RC_VHT_RATE_2SS_MCS9,
0781 
0782     /*keep it last */
0783     RTL_VAR_MAP_MAX,
0784 };
0785 
0786 /*Firmware PS mode for control LPS.*/
0787 enum _fw_ps_mode {
0788     FW_PS_ACTIVE_MODE = 0,
0789     FW_PS_MIN_MODE = 1,
0790     FW_PS_MAX_MODE = 2,
0791     FW_PS_DTIM_MODE = 3,
0792     FW_PS_VOIP_MODE = 4,
0793     FW_PS_UAPSD_WMM_MODE = 5,
0794     FW_PS_UAPSD_MODE = 6,
0795     FW_PS_IBSS_MODE = 7,
0796     FW_PS_WWLAN_MODE = 8,
0797     FW_PS_PM_RADIO_OFF = 9,
0798     FW_PS_PM_CARD_DISABLE = 10,
0799 };
0800 
0801 enum rt_psmode {
0802     EACTIVE,        /*Active/Continuous access. */
0803     EMAXPS,         /*Max power save mode. */
0804     EFASTPS,        /*Fast power save mode. */
0805     EAUTOPS,        /*Auto power save mode. */
0806 };
0807 
0808 /*LED related.*/
0809 enum led_ctl_mode {
0810     LED_CTL_POWER_ON = 1,
0811     LED_CTL_LINK = 2,
0812     LED_CTL_NO_LINK = 3,
0813     LED_CTL_TX = 4,
0814     LED_CTL_RX = 5,
0815     LED_CTL_SITE_SURVEY = 6,
0816     LED_CTL_POWER_OFF = 7,
0817     LED_CTL_START_TO_LINK = 8,
0818     LED_CTL_START_WPS = 9,
0819     LED_CTL_STOP_WPS = 10,
0820 };
0821 
0822 enum rtl_led_pin {
0823     LED_PIN_GPIO0,
0824     LED_PIN_LED0,
0825     LED_PIN_LED1,
0826     LED_PIN_LED2
0827 };
0828 
0829 /*QoS related.*/
0830 /*acm implementation method.*/
0831 enum acm_method {
0832     EACMWAY0_SWANDHW = 0,
0833     EACMWAY1_HW = 1,
0834     EACMWAY2_SW = 2,
0835 };
0836 
0837 enum macphy_mode {
0838     SINGLEMAC_SINGLEPHY = 0,
0839     DUALMAC_DUALPHY,
0840     DUALMAC_SINGLEPHY,
0841 };
0842 
0843 enum band_type {
0844     BAND_ON_2_4G = 0,
0845     BAND_ON_5G,
0846     BAND_ON_BOTH,
0847     BANDMAX
0848 };
0849 
0850 /* aci/aifsn Field.
0851  * Ref: WMM spec 2.2.2: WME Parameter Element, p.12.
0852  */
0853 union aci_aifsn {
0854     u8 char_data;
0855 
0856     struct {
0857         u8 aifsn:4;
0858         u8 acm:1;
0859         u8 aci:2;
0860         u8 reserved:1;
0861     } f;            /* Field */
0862 };
0863 
0864 /*mlme related.*/
0865 enum wireless_mode {
0866     WIRELESS_MODE_UNKNOWN = 0x00,
0867     WIRELESS_MODE_A = 0x01,
0868     WIRELESS_MODE_B = 0x02,
0869     WIRELESS_MODE_G = 0x04,
0870     WIRELESS_MODE_AUTO = 0x08,
0871     WIRELESS_MODE_N_24G = 0x10,
0872     WIRELESS_MODE_N_5G = 0x20,
0873     WIRELESS_MODE_AC_5G = 0x40,
0874     WIRELESS_MODE_AC_24G  = 0x80,
0875     WIRELESS_MODE_AC_ONLY = 0x100,
0876     WIRELESS_MODE_MAX = 0x800
0877 };
0878 
0879 #define IS_WIRELESS_MODE_A(wirelessmode)    \
0880     (wirelessmode == WIRELESS_MODE_A)
0881 #define IS_WIRELESS_MODE_B(wirelessmode)    \
0882     (wirelessmode == WIRELESS_MODE_B)
0883 #define IS_WIRELESS_MODE_G(wirelessmode)    \
0884     (wirelessmode == WIRELESS_MODE_G)
0885 #define IS_WIRELESS_MODE_N_24G(wirelessmode)    \
0886     (wirelessmode == WIRELESS_MODE_N_24G)
0887 #define IS_WIRELESS_MODE_N_5G(wirelessmode) \
0888     (wirelessmode == WIRELESS_MODE_N_5G)
0889 
0890 enum ratr_table_mode {
0891     RATR_INX_WIRELESS_NGB = 0,
0892     RATR_INX_WIRELESS_NG = 1,
0893     RATR_INX_WIRELESS_NB = 2,
0894     RATR_INX_WIRELESS_N = 3,
0895     RATR_INX_WIRELESS_GB = 4,
0896     RATR_INX_WIRELESS_G = 5,
0897     RATR_INX_WIRELESS_B = 6,
0898     RATR_INX_WIRELESS_MC = 7,
0899     RATR_INX_WIRELESS_A = 8,
0900     RATR_INX_WIRELESS_AC_5N = 8,
0901     RATR_INX_WIRELESS_AC_24N = 9,
0902 };
0903 
0904 enum ratr_table_mode_new {
0905     RATEID_IDX_BGN_40M_2SS = 0,
0906     RATEID_IDX_BGN_40M_1SS = 1,
0907     RATEID_IDX_BGN_20M_2SS_BN = 2,
0908     RATEID_IDX_BGN_20M_1SS_BN = 3,
0909     RATEID_IDX_GN_N2SS = 4,
0910     RATEID_IDX_GN_N1SS = 5,
0911     RATEID_IDX_BG = 6,
0912     RATEID_IDX_G = 7,
0913     RATEID_IDX_B = 8,
0914     RATEID_IDX_VHT_2SS = 9,
0915     RATEID_IDX_VHT_1SS = 10,
0916     RATEID_IDX_MIX1 = 11,
0917     RATEID_IDX_MIX2 = 12,
0918     RATEID_IDX_VHT_3SS = 13,
0919     RATEID_IDX_BGN_3SS = 14,
0920 };
0921 
0922 enum rtl_link_state {
0923     MAC80211_NOLINK = 0,
0924     MAC80211_LINKING = 1,
0925     MAC80211_LINKED = 2,
0926     MAC80211_LINKED_SCANNING = 3,
0927 };
0928 
0929 enum act_category {
0930     ACT_CAT_QOS = 1,
0931     ACT_CAT_DLS = 2,
0932     ACT_CAT_BA = 3,
0933     ACT_CAT_HT = 7,
0934     ACT_CAT_WMM = 17,
0935 };
0936 
0937 enum ba_action {
0938     ACT_ADDBAREQ = 0,
0939     ACT_ADDBARSP = 1,
0940     ACT_DELBA = 2,
0941 };
0942 
0943 enum rt_polarity_ctl {
0944     RT_POLARITY_LOW_ACT = 0,
0945     RT_POLARITY_HIGH_ACT = 1,
0946 };
0947 
0948 /* After 8188E, we use V2 reason define. 88C/8723A use V1 reason. */
0949 enum fw_wow_reason_v2 {
0950     FW_WOW_V2_PTK_UPDATE_EVENT = 0x01,
0951     FW_WOW_V2_GTK_UPDATE_EVENT = 0x02,
0952     FW_WOW_V2_DISASSOC_EVENT = 0x04,
0953     FW_WOW_V2_DEAUTH_EVENT = 0x08,
0954     FW_WOW_V2_FW_DISCONNECT_EVENT = 0x10,
0955     FW_WOW_V2_MAGIC_PKT_EVENT = 0x21,
0956     FW_WOW_V2_UNICAST_PKT_EVENT = 0x22,
0957     FW_WOW_V2_PATTERN_PKT_EVENT = 0x23,
0958     FW_WOW_V2_RTD3_SSID_MATCH_EVENT = 0x24,
0959     FW_WOW_V2_REALWOW_V2_WAKEUPPKT = 0x30,
0960     FW_WOW_V2_REALWOW_V2_ACKLOST = 0x31,
0961     FW_WOW_V2_REASON_MAX = 0xff,
0962 };
0963 
0964 enum wolpattern_type {
0965     UNICAST_PATTERN = 0,
0966     MULTICAST_PATTERN = 1,
0967     BROADCAST_PATTERN = 2,
0968     DONT_CARE_DA = 3,
0969     UNKNOWN_TYPE = 4,
0970 };
0971 
0972 enum package_type {
0973     PACKAGE_DEFAULT,
0974     PACKAGE_QFN68,
0975     PACKAGE_TFBGA90,
0976     PACKAGE_TFBGA80,
0977     PACKAGE_TFBGA79
0978 };
0979 
0980 enum rtl_spec_ver {
0981     RTL_SPEC_NEW_RATEID = BIT(0),   /* use ratr_table_mode_new */
0982     RTL_SPEC_SUPPORT_VHT = BIT(1),  /* support VHT */
0983     RTL_SPEC_EXT_C2H = BIT(2),  /* extend FW C2H (e.g. TX REPORT) */
0984 };
0985 
0986 enum dm_info_query {
0987     DM_INFO_FA_OFDM,
0988     DM_INFO_FA_CCK,
0989     DM_INFO_FA_TOTAL,
0990     DM_INFO_CCA_OFDM,
0991     DM_INFO_CCA_CCK,
0992     DM_INFO_CCA_ALL,
0993     DM_INFO_CRC32_OK_VHT,
0994     DM_INFO_CRC32_OK_HT,
0995     DM_INFO_CRC32_OK_LEGACY,
0996     DM_INFO_CRC32_OK_CCK,
0997     DM_INFO_CRC32_ERROR_VHT,
0998     DM_INFO_CRC32_ERROR_HT,
0999     DM_INFO_CRC32_ERROR_LEGACY,
1000     DM_INFO_CRC32_ERROR_CCK,
1001     DM_INFO_EDCCA_FLAG,
1002     DM_INFO_OFDM_ENABLE,
1003     DM_INFO_CCK_ENABLE,
1004     DM_INFO_CRC32_OK_HT_AGG,
1005     DM_INFO_CRC32_ERROR_HT_AGG,
1006     DM_INFO_DBG_PORT_0,
1007     DM_INFO_CURR_IGI,
1008     DM_INFO_RSSI_MIN,
1009     DM_INFO_RSSI_MAX,
1010     DM_INFO_CLM_RATIO,
1011     DM_INFO_NHM_RATIO,
1012     DM_INFO_IQK_ALL,
1013     DM_INFO_IQK_OK,
1014     DM_INFO_IQK_NG,
1015     DM_INFO_SIZE,
1016 };
1017 
1018 enum rx_packet_type {
1019     NORMAL_RX,
1020     TX_REPORT1,
1021     TX_REPORT2,
1022     HIS_REPORT,
1023     C2H_PACKET,
1024 };
1025 
1026 struct rtlwifi_tx_info {
1027     int sn;
1028     unsigned long send_time;
1029 };
1030 
1031 static inline struct rtlwifi_tx_info *rtl_tx_skb_cb_info(struct sk_buff *skb)
1032 {
1033     struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
1034 
1035     BUILD_BUG_ON(sizeof(struct rtlwifi_tx_info) >
1036              sizeof(info->status.status_driver_data));
1037 
1038     return (struct rtlwifi_tx_info *)(info->status.status_driver_data);
1039 }
1040 
1041 struct octet_string {
1042     u8 *octet;
1043     u16 length;
1044 };
1045 
1046 struct rtl_hdr_3addr {
1047     __le16 frame_ctl;
1048     __le16 duration_id;
1049     u8 addr1[ETH_ALEN];
1050     u8 addr2[ETH_ALEN];
1051     u8 addr3[ETH_ALEN];
1052     __le16 seq_ctl;
1053     u8 payload[];
1054 } __packed;
1055 
1056 struct rtl_info_element {
1057     u8 id;
1058     u8 len;
1059     u8 data[];
1060 } __packed;
1061 
1062 struct rtl_probe_rsp {
1063     struct rtl_hdr_3addr header;
1064     u32 time_stamp[2];
1065     __le16 beacon_interval;
1066     __le16 capability;
1067     /*SSID, supported rates, FH params, DS params,
1068      * CF params, IBSS params, TIM (if beacon), RSN
1069      */
1070     struct rtl_info_element info_element[];
1071 } __packed;
1072 
1073 /*LED related.*/
1074 /*ledpin Identify how to implement this SW led.*/
1075 struct rtl_led {
1076     void *hw;
1077     enum rtl_led_pin ledpin;
1078     bool ledon;
1079 };
1080 
1081 struct rtl_led_ctl {
1082     bool led_opendrain;
1083     struct rtl_led sw_led0;
1084     struct rtl_led sw_led1;
1085 };
1086 
1087 struct rtl_qos_parameters {
1088     __le16 cw_min;
1089     __le16 cw_max;
1090     u8 aifs;
1091     u8 flag;
1092     __le16 tx_op;
1093 } __packed;
1094 
1095 struct rt_smooth_data {
1096     u32 elements[100];  /*array to store values */
1097     u32 index;      /*index to current array to store */
1098     u32 total_num;      /*num of valid elements */
1099     u32 total_val;      /*sum of valid elements */
1100 };
1101 
1102 struct false_alarm_statistics {
1103     u32 cnt_parity_fail;
1104     u32 cnt_rate_illegal;
1105     u32 cnt_crc8_fail;
1106     u32 cnt_mcs_fail;
1107     u32 cnt_fast_fsync_fail;
1108     u32 cnt_sb_search_fail;
1109     u32 cnt_ofdm_fail;
1110     u32 cnt_cck_fail;
1111     u32 cnt_all;
1112     u32 cnt_ofdm_cca;
1113     u32 cnt_cck_cca;
1114     u32 cnt_cca_all;
1115     u32 cnt_bw_usc;
1116     u32 cnt_bw_lsc;
1117 };
1118 
1119 struct init_gain {
1120     u8 xaagccore1;
1121     u8 xbagccore1;
1122     u8 xcagccore1;
1123     u8 xdagccore1;
1124     u8 cca;
1125 
1126 };
1127 
1128 struct wireless_stats {
1129     u64 txbytesunicast;
1130     u64 txbytesmulticast;
1131     u64 txbytesbroadcast;
1132     u64 rxbytesunicast;
1133 
1134     u64 txbytesunicast_inperiod;
1135     u64 rxbytesunicast_inperiod;
1136     u32 txbytesunicast_inperiod_tp;
1137     u32 rxbytesunicast_inperiod_tp;
1138     u64 txbytesunicast_last;
1139     u64 rxbytesunicast_last;
1140 
1141     long rx_snr_db[4];
1142     /*Correct smoothed ss in Dbm, only used
1143      * in driver to report real power now.
1144      */
1145     long recv_signal_power;
1146     long signal_quality;
1147     long last_sigstrength_inpercent;
1148 
1149     u32 rssi_calculate_cnt;
1150     u32 pwdb_all_cnt;
1151 
1152     /* Transformed, in dbm. Beautified signal
1153      * strength for UI, not correct.
1154      */
1155     long signal_strength;
1156 
1157     u8 rx_rssi_percentage[4];
1158     u8 rx_evm_dbm[4];
1159     u8 rx_evm_percentage[2];
1160 
1161     u16 rx_cfo_short[4];
1162     u16 rx_cfo_tail[4];
1163 
1164     struct rt_smooth_data ui_rssi;
1165     struct rt_smooth_data ui_link_quality;
1166 };
1167 
1168 struct rate_adaptive {
1169     u8 rate_adaptive_disabled;
1170     u8 ratr_state;
1171     u16 reserve;
1172 
1173     u32 high_rssi_thresh_for_ra;
1174     u32 high2low_rssi_thresh_for_ra;
1175     u8 low2high_rssi_thresh_for_ra40m;
1176     u32 low_rssi_thresh_for_ra40m;
1177     u8 low2high_rssi_thresh_for_ra20m;
1178     u32 low_rssi_thresh_for_ra20m;
1179     u32 upper_rssi_threshold_ratr;
1180     u32 middleupper_rssi_threshold_ratr;
1181     u32 middle_rssi_threshold_ratr;
1182     u32 middlelow_rssi_threshold_ratr;
1183     u32 low_rssi_threshold_ratr;
1184     u32 ultralow_rssi_threshold_ratr;
1185     u32 low_rssi_threshold_ratr_40m;
1186     u32 low_rssi_threshold_ratr_20m;
1187     u8 ping_rssi_enable;
1188     u32 ping_rssi_ratr;
1189     u32 ping_rssi_thresh_for_ra;
1190     u32 last_ratr;
1191     u8 pre_ratr_state;
1192     u8 ldpc_thres;
1193     bool use_ldpc;
1194     bool lower_rts_rate;
1195     bool is_special_data;
1196 };
1197 
1198 struct regd_pair_mapping {
1199     u16 reg_dmnenum;
1200     u16 reg_5ghz_ctl;
1201     u16 reg_2ghz_ctl;
1202 };
1203 
1204 struct dynamic_primary_cca {
1205     u8 pricca_flag;
1206     u8 intf_flag;
1207     u8 intf_type;
1208     u8 dup_rts_flag;
1209     u8 monitor_flag;
1210     u8 ch_offset;
1211     u8 mf_state;
1212 };
1213 
1214 struct rtl_regulatory {
1215     s8 alpha2[2];
1216     u16 country_code;
1217     u16 max_power_level;
1218     u32 tp_scale;
1219     u16 current_rd;
1220     u16 current_rd_ext;
1221     int16_t power_limit;
1222     struct regd_pair_mapping *regpair;
1223 };
1224 
1225 struct rtl_rfkill {
1226     bool rfkill_state;  /*0 is off, 1 is on */
1227 };
1228 
1229 /*for P2P PS**/
1230 #define P2P_MAX_NOA_NUM     2
1231 
1232 enum p2p_role {
1233     P2P_ROLE_DISABLE = 0,
1234     P2P_ROLE_DEVICE = 1,
1235     P2P_ROLE_CLIENT = 2,
1236     P2P_ROLE_GO = 3
1237 };
1238 
1239 enum p2p_ps_state {
1240     P2P_PS_DISABLE = 0,
1241     P2P_PS_ENABLE = 1,
1242     P2P_PS_SCAN = 2,
1243     P2P_PS_SCAN_DONE = 3,
1244     P2P_PS_ALLSTASLEEP = 4, /* for P2P GO */
1245 };
1246 
1247 enum p2p_ps_mode {
1248     P2P_PS_NONE = 0,
1249     P2P_PS_CTWINDOW = 1,
1250     P2P_PS_NOA   = 2,
1251     P2P_PS_MIX = 3, /* CTWindow and NoA */
1252 };
1253 
1254 struct rtl_p2p_ps_info {
1255     enum p2p_ps_mode p2p_ps_mode; /* indicate p2p ps mode */
1256     enum p2p_ps_state p2p_ps_state; /*  indicate p2p ps state */
1257     u8 noa_index; /*  Identifies instance of Notice of Absence timing. */
1258     /*  Client traffic window. A period of time in TU after TBTT. */
1259     u8 ctwindow;
1260     u8 opp_ps; /*  opportunistic power save. */
1261     u8 noa_num; /*  number of NoA descriptor in P2P IE. */
1262     /*  Count for owner, Type of client. */
1263     u8 noa_count_type[P2P_MAX_NOA_NUM];
1264     /*  Max duration for owner, preferred or min acceptable duration
1265      * for client.
1266      */
1267     u32 noa_duration[P2P_MAX_NOA_NUM];
1268     /*  Length of interval for owner, preferred or max acceptable intervali
1269      * of client.
1270      */
1271     u32 noa_interval[P2P_MAX_NOA_NUM];
1272     /*  schedule in terms of the lower 4 bytes of the TSF timer. */
1273     u32 noa_start_time[P2P_MAX_NOA_NUM];
1274 };
1275 
1276 struct p2p_ps_offload_t {
1277     u8 offload_en:1;
1278     u8 role:1; /* 1: Owner, 0: Client */
1279     u8 ctwindow_en:1;
1280     u8 noa0_en:1;
1281     u8 noa1_en:1;
1282     u8 allstasleep:1;
1283     u8 discovery:1;
1284     u8 reserved:1;
1285 };
1286 
1287 #define IQK_MATRIX_REG_NUM  8
1288 #define IQK_MATRIX_SETTINGS_NUM (1 + 24 + 21)
1289 
1290 struct iqk_matrix_regs {
1291     bool iqk_done;
1292     long value[1][IQK_MATRIX_REG_NUM];
1293 };
1294 
1295 struct phy_parameters {
1296     u16 length;
1297     u32 *pdata;
1298 };
1299 
1300 enum hw_param_tab_index {
1301     PHY_REG_2T,
1302     PHY_REG_1T,
1303     PHY_REG_PG,
1304     RADIOA_2T,
1305     RADIOB_2T,
1306     RADIOA_1T,
1307     RADIOB_1T,
1308     MAC_REG,
1309     AGCTAB_2T,
1310     AGCTAB_1T,
1311     MAX_TAB
1312 };
1313 
1314 struct rtl_phy {
1315     struct bb_reg_def phyreg_def[4];    /*Radio A/B/C/D */
1316     struct init_gain initgain_backup;
1317     enum io_type current_io_type;
1318 
1319     u8 rf_mode;
1320     u8 rf_type;
1321     u8 current_chan_bw;
1322     u8 set_bwmode_inprogress;
1323     u8 sw_chnl_inprogress;
1324     u8 sw_chnl_stage;
1325     u8 sw_chnl_step;
1326     u8 current_channel;
1327     u8 h2c_box_num;
1328     u8 set_io_inprogress;
1329     u8 lck_inprogress;
1330 
1331     /* record for power tracking */
1332     s32 reg_e94;
1333     s32 reg_e9c;
1334     s32 reg_ea4;
1335     s32 reg_eac;
1336     s32 reg_eb4;
1337     s32 reg_ebc;
1338     s32 reg_ec4;
1339     s32 reg_ecc;
1340     u8 rfpienable;
1341     u8 reserve_0;
1342     u16 reserve_1;
1343     u32 reg_c04, reg_c08, reg_874;
1344     u32 adda_backup[16];
1345     u32 iqk_mac_backup[IQK_MAC_REG_NUM];
1346     u32 iqk_bb_backup[10];
1347     bool iqk_initialized;
1348 
1349     bool rfpath_rx_enable[MAX_RF_PATH];
1350     u8 reg_837;
1351     /* Dual mac */
1352     bool need_iqk;
1353     struct iqk_matrix_regs iqk_matrix[IQK_MATRIX_SETTINGS_NUM];
1354 
1355     bool rfpi_enable;
1356     bool iqk_in_progress;
1357 
1358     u8 pwrgroup_cnt;
1359     u8 cck_high_power;
1360     /* this is for 88E & 8723A */
1361     u32 mcs_txpwrlevel_origoffset[MAX_PG_GROUP][16];
1362     /* MAX_PG_GROUP groups of pwr diff by rates */
1363     u32 mcs_offset[MAX_PG_GROUP][16];
1364     u32 tx_power_by_rate_offset[TX_PWR_BY_RATE_NUM_BAND]
1365                    [TX_PWR_BY_RATE_NUM_RF]
1366                    [TX_PWR_BY_RATE_NUM_RF]
1367                    [TX_PWR_BY_RATE_NUM_RATE];
1368     u8 txpwr_by_rate_base_24g[TX_PWR_BY_RATE_NUM_RF]
1369                  [TX_PWR_BY_RATE_NUM_RF]
1370                  [MAX_BASE_NUM_IN_PHY_REG_PG_24G];
1371     u8 txpwr_by_rate_base_5g[TX_PWR_BY_RATE_NUM_RF]
1372                 [TX_PWR_BY_RATE_NUM_RF]
1373                 [MAX_BASE_NUM_IN_PHY_REG_PG_5G];
1374     u8 default_initialgain[4];
1375 
1376     /* the current Tx power level */
1377     u8 cur_cck_txpwridx;
1378     u8 cur_ofdm24g_txpwridx;
1379     u8 cur_bw20_txpwridx;
1380     u8 cur_bw40_txpwridx;
1381 
1382     s8 txpwr_limit_2_4g[MAX_REGULATION_NUM]
1383                [MAX_2_4G_BANDWIDTH_NUM]
1384                [MAX_RATE_SECTION_NUM]
1385                [CHANNEL_MAX_NUMBER_2G]
1386                [MAX_RF_PATH_NUM];
1387     s8 txpwr_limit_5g[MAX_REGULATION_NUM]
1388              [MAX_5G_BANDWIDTH_NUM]
1389              [MAX_RATE_SECTION_NUM]
1390              [CHANNEL_MAX_NUMBER_5G]
1391              [MAX_RF_PATH_NUM];
1392 
1393     u32 rfreg_chnlval[2];
1394     bool apk_done;
1395     u32 reg_rf3c[2];    /* pathA / pathB  */
1396 
1397     u32 backup_rf_0x1a;/*92ee*/
1398     /* bfsync */
1399     u8 framesync;
1400     u32 framesync_c34;
1401 
1402     u8 num_total_rfpath;
1403     struct phy_parameters hwparam_tables[MAX_TAB];
1404     u16 rf_pathmap;
1405 
1406     u8 hw_rof_enable; /*Enable GPIO[9] as WL RF HW PDn source*/
1407     enum rt_polarity_ctl polarity_ctl;
1408 };
1409 
1410 #define MAX_TID_COUNT               9
1411 #define RTL_AGG_STOP                0
1412 #define RTL_AGG_PROGRESS            1
1413 #define RTL_AGG_START               2
1414 #define RTL_AGG_OPERATIONAL         3
1415 #define RTL_AGG_OFF             0
1416 #define RTL_AGG_ON              1
1417 #define RTL_RX_AGG_START            1
1418 #define RTL_RX_AGG_STOP             0
1419 #define RTL_AGG_EMPTYING_HW_QUEUE_ADDBA     2
1420 #define RTL_AGG_EMPTYING_HW_QUEUE_DELBA     3
1421 
1422 struct rtl_ht_agg {
1423     u16 txq_id;
1424     u16 wait_for_ba;
1425     u16 start_idx;
1426     u64 bitmap;
1427     u32 rate_n_flags;
1428     u8 agg_state;
1429     u8 rx_agg_state;
1430 };
1431 
1432 struct rssi_sta {
1433     long undec_sm_pwdb;
1434     long undec_sm_cck;
1435 };
1436 
1437 struct rtl_tid_data {
1438     struct rtl_ht_agg agg;
1439 };
1440 
1441 struct rtl_sta_info {
1442     struct list_head list;
1443     struct rtl_tid_data tids[MAX_TID_COUNT];
1444     /* just used for ap adhoc or mesh*/
1445     struct rssi_sta rssi_stat;
1446     u8 rssi_level;
1447     u16 wireless_mode;
1448     u8 ratr_index;
1449     u8 mimo_ps;
1450     u8 mac_addr[ETH_ALEN];
1451 } __packed;
1452 
1453 struct rtl_priv;
1454 struct rtl_io {
1455     struct device *dev;
1456     struct mutex bb_mutex;
1457 
1458     /*PCI MEM map */
1459     unsigned long pci_mem_end;  /*shared mem end        */
1460     unsigned long pci_mem_start;    /*shared mem start */
1461 
1462     /*PCI IO map */
1463     unsigned long pci_base_addr;    /*device I/O address */
1464 
1465     void (*write8_async)(struct rtl_priv *rtlpriv, u32 addr, u8 val);
1466     void (*write16_async)(struct rtl_priv *rtlpriv, u32 addr, u16 val);
1467     void (*write32_async)(struct rtl_priv *rtlpriv, u32 addr, u32 val);
1468     void (*writen_sync)(struct rtl_priv *rtlpriv, u32 addr, void *buf,
1469                 u16 len);
1470 
1471     u8 (*read8_sync)(struct rtl_priv *rtlpriv, u32 addr);
1472     u16 (*read16_sync)(struct rtl_priv *rtlpriv, u32 addr);
1473     u32 (*read32_sync)(struct rtl_priv *rtlpriv, u32 addr);
1474 
1475 };
1476 
1477 struct rtl_mac {
1478     u8 mac_addr[ETH_ALEN];
1479     u8 mac80211_registered;
1480     u8 beacon_enabled;
1481 
1482     u32 tx_ss_num;
1483     u32 rx_ss_num;
1484 
1485     struct ieee80211_supported_band bands[NUM_NL80211_BANDS];
1486     struct ieee80211_hw *hw;
1487     struct ieee80211_vif *vif;
1488     enum nl80211_iftype opmode;
1489 
1490     /*Probe Beacon management */
1491     struct rtl_tid_data tids[MAX_TID_COUNT];
1492     enum rtl_link_state link_state;
1493 
1494     int n_channels;
1495     int n_bitrates;
1496 
1497     bool offchan_delay;
1498     u8 p2p; /*using p2p role*/
1499     bool p2p_in_use;
1500 
1501     /*filters */
1502     u32 rx_conf;
1503     u16 rx_mgt_filter;
1504     u16 rx_ctrl_filter;
1505     u16 rx_data_filter;
1506 
1507     bool act_scanning;
1508     u8 cnt_after_linked;
1509     bool skip_scan;
1510 
1511     /* early mode */
1512     /* skb wait queue */
1513     struct sk_buff_head skb_waitq[MAX_TID_COUNT];
1514 
1515     u8 ht_stbc_cap;
1516     u8 ht_cur_stbc;
1517 
1518     /*vht support*/
1519     u8 vht_enable;
1520     u8 bw_80;
1521     u8 vht_cur_ldpc;
1522     u8 vht_cur_stbc;
1523     u8 vht_stbc_cap;
1524     u8 vht_ldpc_cap;
1525 
1526     /*RDG*/
1527     bool rdg_en;
1528 
1529     /*AP*/
1530     u8 bssid[ETH_ALEN] __aligned(2);
1531     u32 vendor;
1532     u8 mcs[16]; /* 16 bytes mcs for HT rates. */
1533     u32 basic_rates; /* b/g rates */
1534     u8 ht_enable;
1535     u8 sgi_40;
1536     u8 sgi_20;
1537     u8 bw_40;
1538     u16 mode;       /* wireless mode */
1539     u8 slot_time;
1540     u8 short_preamble;
1541     u8 use_cts_protect;
1542     u8 cur_40_prime_sc;
1543     u8 cur_40_prime_sc_bk;
1544     u8 cur_80_prime_sc;
1545     u64 tsf;
1546     u8 retry_short;
1547     u8 retry_long;
1548     u16 assoc_id;
1549     bool hiddenssid;
1550 
1551     /*IBSS*/
1552     int beacon_interval;
1553 
1554     /*AMPDU*/
1555     u8 min_space_cfg;   /*For Min spacing configurations */
1556     u8 max_mss_density;
1557     u8 current_ampdu_factor;
1558     u8 current_ampdu_density;
1559 
1560     /*QOS & EDCA */
1561     struct ieee80211_tx_queue_params edca_param[RTL_MAC80211_NUM_QUEUE];
1562     struct rtl_qos_parameters ac[AC_MAX];
1563 
1564     /* counters */
1565     u64 last_txok_cnt;
1566     u64 last_rxok_cnt;
1567     u32 last_bt_edca_ul;
1568     u32 last_bt_edca_dl;
1569 };
1570 
1571 struct btdm_8723 {
1572     bool all_off;
1573     bool agc_table_en;
1574     bool adc_back_off_on;
1575     bool b2_ant_hid_en;
1576     bool low_penalty_rate_adaptive;
1577     bool rf_rx_lpf_shrink;
1578     bool reject_aggre_pkt;
1579     bool tra_tdma_on;
1580     u8 tra_tdma_nav;
1581     u8 tra_tdma_ant;
1582     bool tdma_on;
1583     u8 tdma_ant;
1584     u8 tdma_nav;
1585     u8 tdma_dac_swing;
1586     u8 fw_dac_swing_lvl;
1587     bool ps_tdma_on;
1588     u8 ps_tdma_byte[5];
1589     bool pta_on;
1590     u32 val_0x6c0;
1591     u32 val_0x6c8;
1592     u32 val_0x6cc;
1593     bool sw_dac_swing_on;
1594     u32 sw_dac_swing_lvl;
1595     u32 wlan_act_hi;
1596     u32 wlan_act_lo;
1597     u32 bt_retry_index;
1598     bool dec_bt_pwr;
1599     bool ignore_wlan_act;
1600 };
1601 
1602 struct bt_coexist_8723 {
1603     u32 high_priority_tx;
1604     u32 high_priority_rx;
1605     u32 low_priority_tx;
1606     u32 low_priority_rx;
1607     u8 c2h_bt_info;
1608     bool c2h_bt_info_req_sent;
1609     bool c2h_bt_inquiry_page;
1610     u32 bt_inq_page_start_time;
1611     u8 bt_retry_cnt;
1612     u8 c2h_bt_info_original;
1613     u8 bt_inquiry_page_cnt;
1614     struct btdm_8723 btdm;
1615 };
1616 
1617 struct rtl_hal {
1618     struct ieee80211_hw *hw;
1619     bool driver_is_goingto_unload;
1620     bool up_first_time;
1621     bool first_init;
1622     bool being_init_adapter;
1623     bool bbrf_ready;
1624     bool mac_func_enable;
1625     bool pre_edcca_enable;
1626     struct bt_coexist_8723 hal_coex_8723;
1627 
1628     enum intf_type interface;
1629     u16 hw_type;        /*92c or 92d or 92s and so on */
1630     u8 ic_class;
1631     u8 oem_id;
1632     u32 version;        /*version of chip */
1633     u8 state;       /*stop 0, start 1 */
1634     u8 board_type;
1635     u8 package_type;
1636     u8 external_pa;
1637 
1638     u8 pa_mode;
1639     u8 pa_type_2g;
1640     u8 pa_type_5g;
1641     u8 lna_type_2g;
1642     u8 lna_type_5g;
1643     u8 external_pa_2g;
1644     u8 external_lna_2g;
1645     u8 external_pa_5g;
1646     u8 external_lna_5g;
1647     u8 type_glna;
1648     u8 type_gpa;
1649     u8 type_alna;
1650     u8 type_apa;
1651     u8 rfe_type;
1652 
1653     /*firmware */
1654     u32 fwsize;
1655     u8 *pfirmware;
1656     u16 fw_version;
1657     u16 fw_subversion;
1658     bool h2c_setinprogress;
1659     u8 last_hmeboxnum;
1660     bool fw_ready;
1661     /*Reserve page start offset except beacon in TxQ. */
1662     u8 fw_rsvdpage_startoffset;
1663     u8 h2c_txcmd_seq;
1664     u8 current_ra_rate;
1665 
1666     /* FW Cmd IO related */
1667     u16 fwcmd_iomap;
1668     u32 fwcmd_ioparam;
1669     bool set_fwcmd_inprogress;
1670     u8 current_fwcmd_io;
1671 
1672     struct p2p_ps_offload_t p2p_ps_offload;
1673     bool fw_clk_change_in_progress;
1674     bool allow_sw_to_change_hwclc;
1675     u8 fw_ps_state;
1676     /**/
1677     bool driver_going2unload;
1678 
1679     /*AMPDU init min space*/
1680     u8 minspace_cfg;    /*For Min spacing configurations */
1681 
1682     /* Dual mac */
1683     enum macphy_mode macphymode;
1684     enum band_type current_bandtype;    /* 0:2.4G, 1:5G */
1685     enum band_type current_bandtypebackup;
1686     enum band_type bandset;
1687     /* dual MAC 0--Mac0 1--Mac1 */
1688     u32 interfaceindex;
1689     /* just for DualMac S3S4 */
1690     u8 macphyctl_reg;
1691     bool earlymode_enable;
1692     u8 max_earlymode_num;
1693     /* Dual mac*/
1694     bool during_mac0init_radiob;
1695     bool during_mac1init_radioa;
1696     bool reloadtxpowerindex;
1697     /* True if IMR or IQK  have done
1698      * for 2.4G in scan progress
1699      */
1700     bool load_imrandiqk_setting_for2g;
1701 
1702     bool disable_amsdu_8k;
1703     bool master_of_dmsp;
1704     bool slave_of_dmsp;
1705 
1706     u16 rx_tag;/*for 92ee*/
1707     u8 rts_en;
1708 
1709     /*for wowlan*/
1710     bool wow_enable;
1711     bool enter_pnp_sleep;
1712     bool wake_from_pnp_sleep;
1713     bool wow_enabled;
1714     time64_t last_suspend_sec;
1715     u32 wowlan_fwsize;
1716     u8 *wowlan_firmware;
1717 
1718     u8 hw_rof_enable; /*Enable GPIO[9] as WL RF HW PDn source*/
1719 
1720     bool real_wow_v2_enable;
1721     bool re_init_llt_table;
1722 };
1723 
1724 struct rtl_security {
1725     /*default 0 */
1726     bool use_sw_sec;
1727 
1728     bool being_setkey;
1729     bool use_defaultkey;
1730     /*Encryption Algorithm for Unicast Packet */
1731     enum rt_enc_alg pairwise_enc_algorithm;
1732     /*Encryption Algorithm for Brocast/Multicast */
1733     enum rt_enc_alg group_enc_algorithm;
1734     /*Cam Entry Bitmap */
1735     u32 hwsec_cam_bitmap;
1736     u8 hwsec_cam_sta_addr[TOTAL_CAM_ENTRY][ETH_ALEN];
1737     /*local Key buffer, indx 0 is for
1738      * pairwise key 1-4 is for agoup key.
1739      */
1740     u8 key_buf[KEY_BUF_SIZE][MAX_KEY_LEN];
1741     u8 key_len[KEY_BUF_SIZE];
1742 
1743     /*The pointer of Pairwise Key,
1744      * it always points to KeyBuf[4]
1745      */
1746     u8 *pairwise_key;
1747 };
1748 
1749 #define ASSOCIATE_ENTRY_NUM 33
1750 
1751 struct fast_ant_training {
1752     u8  bssid[6];
1753     u8  antsel_rx_keep_0;
1754     u8  antsel_rx_keep_1;
1755     u8  antsel_rx_keep_2;
1756     u32 ant_sum[7];
1757     u32 ant_cnt[7];
1758     u32 ant_ave[7];
1759     u8  fat_state;
1760     u32 train_idx;
1761     u8  antsel_a[ASSOCIATE_ENTRY_NUM];
1762     u8  antsel_b[ASSOCIATE_ENTRY_NUM];
1763     u8  antsel_c[ASSOCIATE_ENTRY_NUM];
1764     u32 main_ant_sum[ASSOCIATE_ENTRY_NUM];
1765     u32 aux_ant_sum[ASSOCIATE_ENTRY_NUM];
1766     u32 main_ant_cnt[ASSOCIATE_ENTRY_NUM];
1767     u32 aux_ant_cnt[ASSOCIATE_ENTRY_NUM];
1768     u8  rx_idle_ant;
1769     bool    becomelinked;
1770 };
1771 
1772 struct dm_phy_dbg_info {
1773     s8 rx_snrdb[4];
1774     u64 num_qry_phy_status;
1775     u64 num_qry_phy_status_cck;
1776     u64 num_qry_phy_status_ofdm;
1777     u16 num_qry_beacon_pkt;
1778     u16 num_non_be_pkt;
1779     s32 rx_evm[4];
1780 };
1781 
1782 struct rtl_dm {
1783     /*PHY status for Dynamic Management */
1784     long entry_min_undec_sm_pwdb;
1785     long undec_sm_cck;
1786     long undec_sm_pwdb; /*out dm */
1787     long entry_max_undec_sm_pwdb;
1788     s32 ofdm_pkt_cnt;
1789     bool dm_initialgain_enable;
1790     bool dynamic_txpower_enable;
1791     bool current_turbo_edca;
1792     bool is_any_nonbepkts;  /*out dm */
1793     bool is_cur_rdlstate;
1794     bool txpower_trackinginit;
1795     bool disable_framebursting;
1796     bool cck_inch14;
1797     bool txpower_tracking;
1798     bool useramask;
1799     bool rfpath_rxenable[4];
1800     bool inform_fw_driverctrldm;
1801     bool current_mrc_switch;
1802     u8 txpowercount;
1803     u8 powerindex_backup[6];
1804 
1805     u8 thermalvalue_rxgain;
1806     u8 thermalvalue_iqk;
1807     u8 thermalvalue_lck;
1808     u8 thermalvalue;
1809     u8 last_dtp_lvl;
1810     u8 thermalvalue_avg[AVG_THERMAL_NUM];
1811     u8 thermalvalue_avg_index;
1812     u8 tm_trigger;
1813     bool done_txpower;
1814     u8 dynamic_txhighpower_lvl; /*Tx high power level */
1815     u8 dm_flag;     /*Indicate each dynamic mechanism's status. */
1816     u8 dm_flag_tmp;
1817     u8 dm_type;
1818     u8 dm_rssi_sel;
1819     u8 txpower_track_control;
1820     bool interrupt_migration;
1821     bool disable_tx_int;
1822     s8 ofdm_index[MAX_RF_PATH];
1823     u8 default_ofdm_index;
1824     u8 default_cck_index;
1825     s8 cck_index;
1826     s8 delta_power_index[MAX_RF_PATH];
1827     s8 delta_power_index_last[MAX_RF_PATH];
1828     s8 power_index_offset[MAX_RF_PATH];
1829     s8 absolute_ofdm_swing_idx[MAX_RF_PATH];
1830     s8 remnant_ofdm_swing_idx[MAX_RF_PATH];
1831     s8 remnant_cck_idx;
1832     bool modify_txagc_flag_path_a;
1833     bool modify_txagc_flag_path_b;
1834 
1835     bool one_entry_only;
1836     struct dm_phy_dbg_info dbginfo;
1837 
1838     /* Dynamic ATC switch */
1839     bool atc_status;
1840     bool large_cfo_hit;
1841     bool is_freeze;
1842     int cfo_tail[2];
1843     int cfo_ave_pre;
1844     int crystal_cap;
1845     u8 cfo_threshold;
1846     u32 packet_count;
1847     u32 packet_count_pre;
1848     u8 tx_rate;
1849 
1850     /*88e tx power tracking*/
1851     u8  swing_idx_ofdm[MAX_RF_PATH];
1852     u8  swing_idx_ofdm_cur;
1853     u8  swing_idx_ofdm_base[MAX_RF_PATH];
1854     bool    swing_flag_ofdm;
1855     u8  swing_idx_cck;
1856     u8  swing_idx_cck_cur;
1857     u8  swing_idx_cck_base;
1858     bool    swing_flag_cck;
1859 
1860     s8  swing_diff_2g;
1861     s8  swing_diff_5g;
1862 
1863     /* DMSP */
1864     bool supp_phymode_switch;
1865 
1866     /* DulMac */
1867     struct fast_ant_training fat_table;
1868 
1869     u8  resp_tx_path;
1870     u8  path_sel;
1871     u32 patha_sum;
1872     u32 pathb_sum;
1873     u32 patha_cnt;
1874     u32 pathb_cnt;
1875 
1876     u8 pre_channel;
1877     u8 *p_channel;
1878     u8 linked_interval;
1879 
1880     u64 last_tx_ok_cnt;
1881     u64 last_rx_ok_cnt;
1882 };
1883 
1884 #define EFUSE_MAX_LOGICAL_SIZE          512
1885 
1886 struct rtl_efuse {
1887     const struct rtl_efuse_ops *efuse_ops;
1888     bool autoload_ok;
1889     bool bootfromefuse;
1890     u16 max_physical_size;
1891 
1892     u8 efuse_map[2][EFUSE_MAX_LOGICAL_SIZE];
1893     u16 efuse_usedbytes;
1894     u8 efuse_usedpercentage;
1895 
1896     u8 autoload_failflag;
1897     u8 autoload_status;
1898 
1899     short epromtype;
1900     u16 eeprom_vid;
1901     u16 eeprom_did;
1902     u16 eeprom_svid;
1903     u16 eeprom_smid;
1904     u8 eeprom_oemid;
1905     u16 eeprom_channelplan;
1906     u8 eeprom_version;
1907     u8 board_type;
1908     u8 external_pa;
1909 
1910     u8 dev_addr[6];
1911     u8 wowlan_enable;
1912     u8 antenna_div_cfg;
1913     u8 antenna_div_type;
1914 
1915     bool txpwr_fromeprom;
1916     u8 eeprom_crystalcap;
1917     u8 eeprom_tssi[2];
1918     u8 eeprom_tssi_5g[3][2]; /* for 5GL/5GM/5GH band. */
1919     u8 eeprom_pwrlimit_ht20[CHANNEL_GROUP_MAX];
1920     u8 eeprom_pwrlimit_ht40[CHANNEL_GROUP_MAX];
1921     u8 eeprom_chnlarea_txpwr_cck[MAX_RF_PATH][CHANNEL_GROUP_MAX_2G];
1922     u8 eeprom_chnlarea_txpwr_ht40_1s[MAX_RF_PATH][CHANNEL_GROUP_MAX];
1923     u8 eprom_chnl_txpwr_ht40_2sdf[MAX_RF_PATH][CHANNEL_GROUP_MAX];
1924 
1925     u8 internal_pa_5g[2];   /* pathA / pathB */
1926     u8 eeprom_c9;
1927     u8 eeprom_cc;
1928 
1929     /*For power group */
1930     u8 eeprom_pwrgroup[2][3];
1931     u8 pwrgroup_ht20[2][CHANNEL_MAX_NUMBER];
1932     u8 pwrgroup_ht40[2][CHANNEL_MAX_NUMBER];
1933 
1934     u8 txpwrlevel_cck[MAX_RF_PATH][CHANNEL_MAX_NUMBER_2G];
1935     /*For HT 40MHZ pwr */
1936     u8 txpwrlevel_ht40_1s[MAX_RF_PATH][CHANNEL_MAX_NUMBER];
1937     /*For HT 40MHZ pwr */
1938     u8 txpwrlevel_ht40_2s[MAX_RF_PATH][CHANNEL_MAX_NUMBER];
1939 
1940     /*--------------------------------------------------------*
1941      * 8192CE\8192SE\8192DE\8723AE use the following 4 arrays,
1942      * other ICs (8188EE\8723BE\8192EE\8812AE...)
1943      * define new arrays in Windows code.
1944      * BUT, in linux code, we use the same array for all ICs.
1945      *
1946      * The Correspondance relation between two arrays is:
1947      * txpwr_cckdiff[][] == CCK_24G_Diff[][]
1948      * txpwr_ht20diff[][] == BW20_24G_Diff[][]
1949      * txpwr_ht40diff[][] == BW40_24G_Diff[][]
1950      * txpwr_legacyhtdiff[][] == OFDM_24G_Diff[][]
1951      *
1952      * Sizes of these arrays are decided by the larger ones.
1953      */
1954     s8 txpwr_cckdiff[MAX_RF_PATH][CHANNEL_MAX_NUMBER];
1955     s8 txpwr_ht20diff[MAX_RF_PATH][CHANNEL_MAX_NUMBER];
1956     s8 txpwr_ht40diff[MAX_RF_PATH][CHANNEL_MAX_NUMBER];
1957     s8 txpwr_legacyhtdiff[MAX_RF_PATH][CHANNEL_MAX_NUMBER];
1958 
1959     u8 txpwr_5g_bw40base[MAX_RF_PATH][CHANNEL_MAX_NUMBER];
1960     u8 txpwr_5g_bw80base[MAX_RF_PATH][CHANNEL_MAX_NUMBER_5G_80M];
1961     s8 txpwr_5g_ofdmdiff[MAX_RF_PATH][MAX_TX_COUNT];
1962     s8 txpwr_5g_bw20diff[MAX_RF_PATH][MAX_TX_COUNT];
1963     s8 txpwr_5g_bw40diff[MAX_RF_PATH][MAX_TX_COUNT];
1964     s8 txpwr_5g_bw80diff[MAX_RF_PATH][MAX_TX_COUNT];
1965 
1966     u8 txpwr_safetyflag;            /* Band edge enable flag */
1967     u16 eeprom_txpowerdiff;
1968     u8 antenna_txpwdiff[3];
1969 
1970     u8 eeprom_regulatory;
1971     u8 eeprom_thermalmeter;
1972     u8 thermalmeter[2]; /*ThermalMeter, index 0 for RFIC0, 1 for RFIC1 */
1973     u16 tssi_13dbm;
1974     u8 crystalcap;      /* CrystalCap. */
1975     u8 delta_iqk;
1976     u8 delta_lck;
1977 
1978     u8 legacy_ht_txpowerdiff;   /*Legacy to HT rate power diff */
1979     bool apk_thermalmeterignore;
1980 
1981     bool b1x1_recvcombine;
1982     bool b1ss_support;
1983 
1984     /*channel plan */
1985     u8 channel_plan;
1986 };
1987 
1988 struct rtl_efuse_ops {
1989     int (*efuse_onebyte_read)(struct ieee80211_hw *hw, u16 addr, u8 *data);
1990     void (*efuse_logical_map_read)(struct ieee80211_hw *hw, u8 type,
1991                        u16 offset, u32 *value);
1992 };
1993 
1994 struct rtl_tx_report {
1995     atomic_t sn;
1996     u16 last_sent_sn;
1997     unsigned long last_sent_time;
1998     u16 last_recv_sn;
1999     struct sk_buff_head queue;
2000 };
2001 
2002 struct rtl_ps_ctl {
2003     bool pwrdomain_protect;
2004     bool in_powersavemode;
2005     bool rfchange_inprogress;
2006     bool swrf_processing;
2007     bool hwradiooff;
2008     /* just for PCIE ASPM
2009      * If it supports ASPM, Offset[560h] = 0x40,
2010      * otherwise Offset[560h] = 0x00.
2011      */
2012     bool support_aspm;
2013     bool support_backdoor;
2014 
2015     /*for LPS */
2016     enum rt_psmode dot11_psmode;    /*Power save mode configured. */
2017     bool swctrl_lps;
2018     bool leisure_ps;
2019     bool fwctrl_lps;
2020     u8 fwctrl_psmode;
2021     /*For Fw control LPS mode */
2022     u8 reg_fwctrl_lps;
2023     /*Record Fw PS mode status. */
2024     bool fw_current_inpsmode;
2025     u8 reg_max_lps_awakeintvl;
2026     bool report_linked;
2027     bool low_power_enable;/*for 32k*/
2028 
2029     /*for IPS */
2030     bool inactiveps;
2031 
2032     u32 rfoff_reason;
2033 
2034     /*RF OFF Level */
2035     u32 cur_ps_level;
2036     u32 reg_rfps_level;
2037 
2038     /*just for PCIE ASPM */
2039     u8 const_amdpci_aspm;
2040     bool pwrdown_mode;
2041 
2042     enum rf_pwrstate inactive_pwrstate;
2043     enum rf_pwrstate rfpwr_state;   /*cur power state */
2044 
2045     /* for SW LPS*/
2046     bool sw_ps_enabled;
2047     bool state;
2048     bool state_inap;
2049     bool multi_buffered;
2050     u16 nullfunc_seq;
2051     unsigned int dtim_counter;
2052     unsigned int sleep_ms;
2053     unsigned long last_sleep_jiffies;
2054     unsigned long last_awake_jiffies;
2055     unsigned long last_delaylps_stamp_jiffies;
2056     unsigned long last_dtim;
2057     unsigned long last_beacon;
2058     unsigned long last_action;
2059     unsigned long last_slept;
2060 
2061     /*For P2P PS */
2062     struct rtl_p2p_ps_info p2p_ps_info;
2063     u8 pwr_mode;
2064     u8 smart_ps;
2065 
2066     /* wake up on line */
2067     u8 wo_wlan_mode;
2068     u8 arp_offload_enable;
2069     u8 gtk_offload_enable;
2070     /* Used for WOL, indicates the reason for waking event.*/
2071     u32 wakeup_reason;
2072 };
2073 
2074 struct rtl_stats {
2075     u8 psaddr[ETH_ALEN];
2076     u32 mac_time[2];
2077     s8 rssi;
2078     u8 signal;
2079     u8 noise;
2080     u8 rate;        /* hw desc rate */
2081     u8 received_channel;
2082     u8 control;
2083     u8 mask;
2084     u8 freq;
2085     u16 len;
2086     u64 tsf;
2087     u32 beacon_time;
2088     u8 nic_type;
2089     u16 length;
2090     u8 signalquality;   /*in 0-100 index. */
2091     /* Real power in dBm for this packet,
2092      * no beautification and aggregation.
2093      */
2094     s32 recvsignalpower;
2095     s8 rxpower;     /*in dBm Translate from PWdB */
2096     u8 signalstrength;  /*in 0-100 index. */
2097     u16 hwerror:1;
2098     u16 crc:1;
2099     u16 icv:1;
2100     u16 shortpreamble:1;
2101     u16 antenna:1;
2102     u16 decrypted:1;
2103     u16 wakeup:1;
2104     u32 timestamp_low;
2105     u32 timestamp_high;
2106     bool shift;
2107 
2108     u8 rx_drvinfo_size;
2109     u8 rx_bufshift;
2110     bool isampdu;
2111     bool isfirst_ampdu;
2112     bool rx_is40mhzpacket;
2113     u8 rx_packet_bw;
2114     u32 rx_pwdb_all;
2115     u8 rx_mimo_signalstrength[4];   /*in 0~100 index */
2116     s8 rx_mimo_signalquality[4];
2117     u8 rx_mimo_evm_dbm[4];
2118     u16 cfo_short[4];       /* per-path's Cfo_short */
2119     u16 cfo_tail[4];
2120 
2121     s8 rx_mimo_sig_qual[4];
2122     u8 rx_pwr[4]; /* per-path's pwdb */
2123     u8 rx_snr[4]; /* per-path's SNR */
2124     u8 bandwidth;
2125     u8 bt_coex_pwr_adjust;
2126     bool packet_matchbssid;
2127     bool is_cck;
2128     bool is_ht;
2129     bool packet_toself;
2130     bool packet_beacon; /*for rssi */
2131     s8 cck_adc_pwdb[4]; /*for rx path selection */
2132 
2133     bool is_vht;
2134     bool is_short_gi;
2135     u8 vht_nss;
2136 
2137     u8 packet_report_type;
2138 
2139     u32 macid;
2140     u32 bt_rx_rssi_percentage;
2141     u32 macid_valid_entry[2];
2142 };
2143 
2144 struct rt_link_detect {
2145     /* count for roaming */
2146     u32 bcn_rx_inperiod;
2147     u32 roam_times;
2148 
2149     u32 num_tx_in4period[4];
2150     u32 num_rx_in4period[4];
2151 
2152     u32 num_tx_inperiod;
2153     u32 num_rx_inperiod;
2154 
2155     bool busytraffic;
2156     bool tx_busy_traffic;
2157     bool rx_busy_traffic;
2158     bool higher_busytraffic;
2159     bool higher_busyrxtraffic;
2160 
2161     u32 tidtx_in4period[MAX_TID_COUNT][4];
2162     u32 tidtx_inperiod[MAX_TID_COUNT];
2163     bool higher_busytxtraffic[MAX_TID_COUNT];
2164 };
2165 
2166 struct rtl_tcb_desc {
2167     u8 packet_bw:2;
2168     u8 multicast:1;
2169     u8 broadcast:1;
2170 
2171     u8 rts_stbc:1;
2172     u8 rts_enable:1;
2173     u8 cts_enable:1;
2174     u8 rts_use_shortpreamble:1;
2175     u8 rts_use_shortgi:1;
2176     u8 rts_sc:1;
2177     u8 rts_bw:1;
2178     u8 rts_rate;
2179 
2180     u8 use_shortgi:1;
2181     u8 use_shortpreamble:1;
2182     u8 use_driver_rate:1;
2183     u8 disable_ratefallback:1;
2184 
2185     u8 use_spe_rpt:1;
2186 
2187     u8 ratr_index;
2188     u8 mac_id;
2189     u8 hw_rate;
2190 
2191     u8 last_inipkt:1;
2192     u8 cmd_or_init:1;
2193     u8 queue_index;
2194 
2195     /* early mode */
2196     u8 empkt_num;
2197     /* The max value by HW */
2198     u32 empkt_len[10];
2199     bool tx_enable_sw_calc_duration;
2200 };
2201 
2202 struct rtl_wow_pattern {
2203     u8 type;
2204     u16 crc;
2205     u32 mask[4];
2206 };
2207 
2208 /* struct to store contents of interrupt vectors */
2209 struct rtl_int {
2210     u32 inta;
2211     u32 intb;
2212     u32 intc;
2213     u32 intd;
2214 };
2215 
2216 struct rtl_hal_ops {
2217     int (*init_sw_vars)(struct ieee80211_hw *hw);
2218     void (*deinit_sw_vars)(struct ieee80211_hw *hw);
2219     void (*read_chip_version)(struct ieee80211_hw *hw);
2220     void (*read_eeprom_info)(struct ieee80211_hw *hw);
2221     void (*interrupt_recognized)(struct ieee80211_hw *hw,
2222                      struct rtl_int *intvec);
2223     int (*hw_init)(struct ieee80211_hw *hw);
2224     void (*hw_disable)(struct ieee80211_hw *hw);
2225     void (*hw_suspend)(struct ieee80211_hw *hw);
2226     void (*hw_resume)(struct ieee80211_hw *hw);
2227     void (*enable_interrupt)(struct ieee80211_hw *hw);
2228     void (*disable_interrupt)(struct ieee80211_hw *hw);
2229     int (*set_network_type)(struct ieee80211_hw *hw,
2230                 enum nl80211_iftype type);
2231     void (*set_chk_bssid)(struct ieee80211_hw *hw,
2232                   bool check_bssid);
2233     void (*set_bw_mode)(struct ieee80211_hw *hw,
2234                 enum nl80211_channel_type ch_type);
2235      u8 (*switch_channel)(struct ieee80211_hw *hw);
2236     void (*set_qos)(struct ieee80211_hw *hw, int aci);
2237     void (*set_bcn_reg)(struct ieee80211_hw *hw);
2238     void (*set_bcn_intv)(struct ieee80211_hw *hw);
2239     void (*update_interrupt_mask)(struct ieee80211_hw *hw,
2240                       u32 add_msr, u32 rm_msr);
2241     void (*get_hw_reg)(struct ieee80211_hw *hw, u8 variable, u8 *val);
2242     void (*set_hw_reg)(struct ieee80211_hw *hw, u8 variable, u8 *val);
2243     void (*update_rate_tbl)(struct ieee80211_hw *hw,
2244                 struct ieee80211_sta *sta, u8 rssi_leve,
2245                 bool update_bw);
2246     void (*pre_fill_tx_bd_desc)(struct ieee80211_hw *hw, u8 *tx_bd_desc,
2247                     u8 *desc, u8 queue_index,
2248                     struct sk_buff *skb, dma_addr_t addr);
2249     void (*update_rate_mask)(struct ieee80211_hw *hw, u8 rssi_level);
2250     u16 (*rx_desc_buff_remained_cnt)(struct ieee80211_hw *hw,
2251                      u8 queue_index);
2252     void (*rx_check_dma_ok)(struct ieee80211_hw *hw, u8 *header_desc,
2253                 u8 queue_index);
2254     void (*fill_tx_desc)(struct ieee80211_hw *hw,
2255                  struct ieee80211_hdr *hdr, u8 *pdesc_tx,
2256                  u8 *pbd_desc_tx,
2257                  struct ieee80211_tx_info *info,
2258                  struct ieee80211_sta *sta,
2259                  struct sk_buff *skb, u8 hw_queue,
2260                  struct rtl_tcb_desc *ptcb_desc);
2261     void (*fill_fake_txdesc)(struct ieee80211_hw *hw, u8 *pdesc,
2262                  u32 buffer_len, bool bsspspoll);
2263     void (*fill_tx_cmddesc)(struct ieee80211_hw *hw, u8 *pdesc,
2264                 bool firstseg, bool lastseg,
2265                 struct sk_buff *skb);
2266     void (*fill_tx_special_desc)(struct ieee80211_hw *hw,
2267                      u8 *pdesc, u8 *pbd_desc,
2268                      struct sk_buff *skb, u8 hw_queue);
2269     bool (*query_rx_desc)(struct ieee80211_hw *hw,
2270                   struct rtl_stats *stats,
2271                   struct ieee80211_rx_status *rx_status,
2272                   u8 *pdesc, struct sk_buff *skb);
2273     void (*set_channel_access)(struct ieee80211_hw *hw);
2274     bool (*radio_onoff_checking)(struct ieee80211_hw *hw, u8 *valid);
2275     void (*dm_watchdog)(struct ieee80211_hw *hw);
2276     void (*scan_operation_backup)(struct ieee80211_hw *hw, u8 operation);
2277     bool (*set_rf_power_state)(struct ieee80211_hw *hw,
2278                    enum rf_pwrstate rfpwr_state);
2279     void (*led_control)(struct ieee80211_hw *hw,
2280                 enum led_ctl_mode ledaction);
2281     void (*set_desc)(struct ieee80211_hw *hw, u8 *pdesc, bool istx,
2282              u8 desc_name, u8 *val);
2283     u64 (*get_desc)(struct ieee80211_hw *hw, u8 *pdesc, bool istx,
2284             u8 desc_name);
2285     bool (*is_tx_desc_closed)(struct ieee80211_hw *hw,
2286                   u8 hw_queue, u16 index);
2287     void (*tx_polling)(struct ieee80211_hw *hw, u8 hw_queue);
2288     void (*enable_hw_sec)(struct ieee80211_hw *hw);
2289     void (*set_key)(struct ieee80211_hw *hw, u32 key_index,
2290             u8 *macaddr, bool is_group, u8 enc_algo,
2291             bool is_wepkey, bool clear_all);
2292     void (*init_sw_leds)(struct ieee80211_hw *hw);
2293     void (*deinit_sw_leds)(struct ieee80211_hw *hw);
2294     u32 (*get_bbreg)(struct ieee80211_hw *hw, u32 regaddr, u32 bitmask);
2295     void (*set_bbreg)(struct ieee80211_hw *hw, u32 regaddr, u32 bitmask,
2296               u32 data);
2297     u32 (*get_rfreg)(struct ieee80211_hw *hw, enum radio_path rfpath,
2298              u32 regaddr, u32 bitmask);
2299     void (*set_rfreg)(struct ieee80211_hw *hw, enum radio_path rfpath,
2300               u32 regaddr, u32 bitmask, u32 data);
2301     void (*linked_set_reg)(struct ieee80211_hw *hw);
2302     void (*chk_switch_dmdp)(struct ieee80211_hw *hw);
2303     void (*dualmac_easy_concurrent)(struct ieee80211_hw *hw);
2304     void (*dualmac_switch_to_dmdp)(struct ieee80211_hw *hw);
2305     bool (*phy_rf6052_config)(struct ieee80211_hw *hw);
2306     void (*phy_rf6052_set_cck_txpower)(struct ieee80211_hw *hw,
2307                        u8 *powerlevel);
2308     void (*phy_rf6052_set_ofdm_txpower)(struct ieee80211_hw *hw,
2309                         u8 *ppowerlevel, u8 channel);
2310     bool (*config_bb_with_headerfile)(struct ieee80211_hw *hw,
2311                       u8 configtype);
2312     bool (*config_bb_with_pgheaderfile)(struct ieee80211_hw *hw,
2313                         u8 configtype);
2314     void (*phy_lc_calibrate)(struct ieee80211_hw *hw, bool is2t);
2315     void (*phy_set_bw_mode_callback)(struct ieee80211_hw *hw);
2316     void (*dm_dynamic_txpower)(struct ieee80211_hw *hw);
2317     void (*c2h_command_handle)(struct ieee80211_hw *hw);
2318     void (*bt_wifi_media_status_notify)(struct ieee80211_hw *hw,
2319                         bool mstate);
2320     void (*bt_coex_off_before_lps)(struct ieee80211_hw *hw);
2321     void (*fill_h2c_cmd)(struct ieee80211_hw *hw, u8 element_id,
2322                  u32 cmd_len, u8 *p_cmdbuffer);
2323     void (*set_default_port_id_cmd)(struct ieee80211_hw *hw);
2324     bool (*get_btc_status)(void);
2325     bool (*is_fw_header)(struct rtlwifi_firmware_header *hdr);
2326     void (*add_wowlan_pattern)(struct ieee80211_hw *hw,
2327                    struct rtl_wow_pattern *rtl_pattern,
2328                    u8 index);
2329     u16 (*get_available_desc)(struct ieee80211_hw *hw, u8 q_idx);
2330     void (*c2h_ra_report_handler)(struct ieee80211_hw *hw,
2331                       u8 *cmd_buf, u8 cmd_len);
2332 };
2333 
2334 struct rtl_intf_ops {
2335     /*com */
2336     void (*read_efuse_byte)(struct ieee80211_hw *hw, u16 _offset, u8 *pbuf);
2337     int (*adapter_start)(struct ieee80211_hw *hw);
2338     void (*adapter_stop)(struct ieee80211_hw *hw);
2339     bool (*check_buddy_priv)(struct ieee80211_hw *hw,
2340                  struct rtl_priv **buddy_priv);
2341 
2342     int (*adapter_tx)(struct ieee80211_hw *hw,
2343               struct ieee80211_sta *sta,
2344               struct sk_buff *skb,
2345               struct rtl_tcb_desc *ptcb_desc);
2346     void (*flush)(struct ieee80211_hw *hw, u32 queues, bool drop);
2347     int (*reset_trx_ring)(struct ieee80211_hw *hw);
2348     bool (*waitq_insert)(struct ieee80211_hw *hw,
2349                  struct ieee80211_sta *sta,
2350                  struct sk_buff *skb);
2351 
2352     /*pci */
2353     void (*disable_aspm)(struct ieee80211_hw *hw);
2354     void (*enable_aspm)(struct ieee80211_hw *hw);
2355 
2356     /*usb */
2357 };
2358 
2359 struct rtl_mod_params {
2360     /* default: 0,0 */
2361     u64 debug_mask;
2362     /* default: 0 = using hardware encryption */
2363     bool sw_crypto;
2364 
2365     /* default: 0 = DBG_EMERG (0)*/
2366     int debug_level;
2367 
2368     /* default: 1 = using no linked power save */
2369     bool inactiveps;
2370 
2371     /* default: 1 = using linked sw power save */
2372     bool swctrl_lps;
2373 
2374     /* default: 1 = using linked fw power save */
2375     bool fwctrl_lps;
2376 
2377     /* default: 0 = not using MSI interrupts mode
2378      * submodules should set their own default value
2379      */
2380     bool msi_support;
2381 
2382     /* default: 0 = dma 32 */
2383     bool dma64;
2384 
2385     /* default: 1 = enable aspm */
2386     int aspm_support;
2387 
2388     /* default 0: 1 means disable */
2389     bool disable_watchdog;
2390 
2391     /* default 0: 1 means do not disable interrupts */
2392     bool int_clear;
2393 
2394     /* select antenna */
2395     int ant_sel;
2396 };
2397 
2398 struct rtl_hal_usbint_cfg {
2399     /* data - rx */
2400     u32 in_ep_num;
2401     u32 rx_urb_num;
2402     u32 rx_max_size;
2403 
2404     /* op - rx */
2405     void (*usb_rx_hdl)(struct ieee80211_hw *, struct sk_buff *);
2406     void (*usb_rx_segregate_hdl)(struct ieee80211_hw *, struct sk_buff *,
2407                      struct sk_buff_head *);
2408 
2409     /* tx */
2410     void (*usb_tx_cleanup)(struct ieee80211_hw *, struct sk_buff *);
2411     int (*usb_tx_post_hdl)(struct ieee80211_hw *, struct urb *,
2412                    struct sk_buff *);
2413     struct sk_buff *(*usb_tx_aggregate_hdl)(struct ieee80211_hw *,
2414                         struct sk_buff_head *);
2415 
2416     /* endpoint mapping */
2417     int (*usb_endpoint_mapping)(struct ieee80211_hw *hw);
2418     u16 (*usb_mq_to_hwq)(__le16 fc, u16 mac80211_queue_index);
2419 };
2420 
2421 struct rtl_hal_cfg {
2422     u8 bar_id;
2423     bool write_readback;
2424     char *name;
2425     char *alt_fw_name;
2426     struct rtl_hal_ops *ops;
2427     struct rtl_mod_params *mod_params;
2428     struct rtl_hal_usbint_cfg *usb_interface_cfg;
2429     enum rtl_spec_ver spec_ver;
2430 
2431     /*this map used for some registers or vars
2432      * defined int HAL but used in MAIN
2433      */
2434     u32 maps[RTL_VAR_MAP_MAX];
2435 
2436 };
2437 
2438 struct rtl_locks {
2439     /* mutex */
2440     struct mutex conf_mutex;
2441     struct mutex ips_mutex; /* mutex for enter/leave IPS */
2442     struct mutex lps_mutex; /* mutex for enter/leave LPS */
2443 
2444     /*spin lock */
2445     spinlock_t irq_th_lock;
2446     spinlock_t h2c_lock;
2447     spinlock_t rf_ps_lock;
2448     spinlock_t rf_lock;
2449     spinlock_t waitq_lock;
2450     spinlock_t entry_list_lock;
2451     spinlock_t usb_lock;
2452     spinlock_t scan_list_lock; /* lock for the scan list */
2453 
2454     /*FW clock change */
2455     spinlock_t fw_ps_lock;
2456 
2457     /*Dual mac*/
2458     spinlock_t cck_and_rw_pagea_lock;
2459 
2460     spinlock_t iqk_lock;
2461 };
2462 
2463 struct rtl_works {
2464     struct ieee80211_hw *hw;
2465 
2466     /*timer */
2467     struct timer_list watchdog_timer;
2468     struct timer_list dualmac_easyconcurrent_retrytimer;
2469     struct timer_list fw_clockoff_timer;
2470     struct timer_list fast_antenna_training_timer;
2471     /*task */
2472     struct tasklet_struct irq_tasklet;
2473     struct tasklet_struct irq_prepare_bcn_tasklet;
2474 
2475     /*work queue */
2476     struct workqueue_struct *rtl_wq;
2477     struct delayed_work watchdog_wq;
2478     struct delayed_work ips_nic_off_wq;
2479     struct delayed_work c2hcmd_wq;
2480 
2481     /* For SW LPS */
2482     struct delayed_work ps_work;
2483     struct delayed_work ps_rfon_wq;
2484     struct delayed_work fwevt_wq;
2485 
2486     struct work_struct lps_change_work;
2487     struct work_struct fill_h2c_cmd;
2488     struct work_struct update_beacon_work;
2489 };
2490 
2491 struct rtl_debug {
2492     /* add for debug */
2493     struct dentry *debugfs_dir;
2494     char debugfs_name[20];
2495 };
2496 
2497 #define MIMO_PS_STATIC          0
2498 #define MIMO_PS_DYNAMIC         1
2499 #define MIMO_PS_NOLIMIT         3
2500 
2501 struct rtl_dualmac_easy_concurrent_ctl {
2502     enum band_type currentbandtype_backfordmdp;
2503     bool close_bbandrf_for_dmsp;
2504     bool change_to_dmdp;
2505     bool change_to_dmsp;
2506     bool switch_in_process;
2507 };
2508 
2509 struct rtl_dmsp_ctl {
2510     bool activescan_for_slaveofdmsp;
2511     bool scan_for_anothermac_fordmsp;
2512     bool scan_for_itself_fordmsp;
2513     bool writedig_for_anothermacofdmsp;
2514     u32 curdigvalue_for_anothermacofdmsp;
2515     bool changecckpdstate_for_anothermacofdmsp;
2516     u8 curcckpdstate_for_anothermacofdmsp;
2517     bool changetxhighpowerlvl_for_anothermacofdmsp;
2518     u8 curtxhighlvl_for_anothermacofdmsp;
2519     long rssivalmin_for_anothermacofdmsp;
2520 };
2521 
2522 struct ps_t {
2523     u8 pre_ccastate;
2524     u8 cur_ccasate;
2525     u8 pre_rfstate;
2526     u8 cur_rfstate;
2527     u8 initialize;
2528     long rssi_val_min;
2529 };
2530 
2531 struct dig_t {
2532     u32 rssi_lowthresh;
2533     u32 rssi_highthresh;
2534     u32 fa_lowthresh;
2535     u32 fa_highthresh;
2536     long last_min_undec_pwdb_for_dm;
2537     long rssi_highpower_lowthresh;
2538     long rssi_highpower_highthresh;
2539     u32 recover_cnt;
2540     u32 pre_igvalue;
2541     u32 cur_igvalue;
2542     long rssi_val;
2543     u8 dig_enable_flag;
2544     u8 dig_ext_port_stage;
2545     u8 dig_algorithm;
2546     u8 dig_twoport_algorithm;
2547     u8 dig_dbgmode;
2548     u8 dig_slgorithm_switch;
2549     u8 cursta_cstate;
2550     u8 presta_cstate;
2551     u8 curmultista_cstate;
2552     u8 stop_dig;
2553     s8 back_val;
2554     s8 back_range_max;
2555     s8 back_range_min;
2556     u8 rx_gain_max;
2557     u8 rx_gain_min;
2558     u8 min_undec_pwdb_for_dm;
2559     u8 rssi_val_min;
2560     u8 pre_cck_cca_thres;
2561     u8 cur_cck_cca_thres;
2562     u8 pre_cck_pd_state;
2563     u8 cur_cck_pd_state;
2564     u8 pre_cck_fa_state;
2565     u8 cur_cck_fa_state;
2566     u8 pre_ccastate;
2567     u8 cur_ccasate;
2568     u8 large_fa_hit;
2569     u8 forbidden_igi;
2570     u8 dig_state;
2571     u8 dig_highpwrstate;
2572     u8 cur_sta_cstate;
2573     u8 pre_sta_cstate;
2574     u8 cur_ap_cstate;
2575     u8 pre_ap_cstate;
2576     u8 cur_pd_thstate;
2577     u8 pre_pd_thstate;
2578     u8 cur_cs_ratiostate;
2579     u8 pre_cs_ratiostate;
2580     u8 backoff_enable_flag;
2581     s8 backoffval_range_max;
2582     s8 backoffval_range_min;
2583     u8 dig_min_0;
2584     u8 dig_min_1;
2585     u8 bt30_cur_igi;
2586     bool media_connect_0;
2587     bool media_connect_1;
2588 
2589     u32 antdiv_rssi_max;
2590     u32 rssi_max;
2591 };
2592 
2593 struct rtl_global_var {
2594     /* from this list we can get
2595      * other adapter's rtl_priv
2596      */
2597     struct list_head glb_priv_list;
2598     spinlock_t glb_list_lock;
2599 };
2600 
2601 #define IN_4WAY_TIMEOUT_TIME    (30 * MSEC_PER_SEC) /* 30 seconds */
2602 
2603 struct rtl_btc_info {
2604     u8 bt_type;
2605     u8 btcoexist;
2606     u8 ant_num;
2607     u8 single_ant_path;
2608 
2609     u8 ap_num;
2610     bool in_4way;
2611     unsigned long in_4way_ts;
2612 };
2613 
2614 struct bt_coexist_info {
2615     struct rtl_btc_ops *btc_ops;
2616     struct rtl_btc_info btc_info;
2617     /* btc context */
2618     void *btc_context;
2619     void *wifi_only_context;
2620     /* EEPROM BT info. */
2621     u8 eeprom_bt_coexist;
2622     u8 eeprom_bt_type;
2623     u8 eeprom_bt_ant_num;
2624     u8 eeprom_bt_ant_isol;
2625     u8 eeprom_bt_radio_shared;
2626 
2627     u8 bt_coexistence;
2628     u8 bt_ant_num;
2629     u8 bt_coexist_type;
2630     u8 bt_state;
2631     u8 bt_cur_state;    /* 0:on, 1:off */
2632     u8 bt_ant_isolation;    /* 0:good, 1:bad */
2633     u8 bt_pape_ctrl;    /* 0:SW, 1:SW/HW dynamic */
2634     u8 bt_service;
2635     u8 bt_radio_shared_type;
2636     u8 bt_rfreg_origin_1e;
2637     u8 bt_rfreg_origin_1f;
2638     u8 bt_rssi_state;
2639     u32 ratio_tx;
2640     u32 ratio_pri;
2641     u32 bt_edca_ul;
2642     u32 bt_edca_dl;
2643 
2644     bool init_set;
2645     bool bt_busy_traffic;
2646     bool bt_traffic_mode_set;
2647     bool bt_non_traffic_mode_set;
2648 
2649     bool fw_coexist_all_off;
2650     bool sw_coexist_all_off;
2651     bool hw_coexist_all_off;
2652     u32 cstate;
2653     u32 previous_state;
2654     u32 cstate_h;
2655     u32 previous_state_h;
2656 
2657     u8 bt_pre_rssi_state;
2658     u8 bt_pre_rssi_state1;
2659 
2660     u8 reg_bt_iso;
2661     u8 reg_bt_sco;
2662     bool balance_on;
2663     u8 bt_active_zero_cnt;
2664     bool cur_bt_disabled;
2665     bool pre_bt_disabled;
2666 
2667     u8 bt_profile_case;
2668     u8 bt_profile_action;
2669     bool bt_busy;
2670     bool hold_for_bt_operation;
2671     u8 lps_counter;
2672 };
2673 
2674 struct rtl_btc_ops {
2675     void (*btc_init_variables)(struct rtl_priv *rtlpriv);
2676     void (*btc_init_variables_wifi_only)(struct rtl_priv *rtlpriv);
2677     void (*btc_deinit_variables)(struct rtl_priv *rtlpriv);
2678     void (*btc_init_hal_vars)(struct rtl_priv *rtlpriv);
2679     void (*btc_power_on_setting)(struct rtl_priv *rtlpriv);
2680     void (*btc_init_hw_config)(struct rtl_priv *rtlpriv);
2681     void (*btc_init_hw_config_wifi_only)(struct rtl_priv *rtlpriv);
2682     void (*btc_ips_notify)(struct rtl_priv *rtlpriv, u8 type);
2683     void (*btc_lps_notify)(struct rtl_priv *rtlpriv, u8 type);
2684     void (*btc_scan_notify)(struct rtl_priv *rtlpriv, u8 scantype);
2685     void (*btc_scan_notify_wifi_only)(struct rtl_priv *rtlpriv,
2686                       u8 scantype);
2687     void (*btc_connect_notify)(struct rtl_priv *rtlpriv, u8 action);
2688     void (*btc_mediastatus_notify)(struct rtl_priv *rtlpriv,
2689                        enum rt_media_status mstatus);
2690     void (*btc_periodical)(struct rtl_priv *rtlpriv);
2691     void (*btc_halt_notify)(struct rtl_priv *rtlpriv);
2692     void (*btc_btinfo_notify)(struct rtl_priv *rtlpriv,
2693                   u8 *tmp_buf, u8 length);
2694     void (*btc_btmpinfo_notify)(struct rtl_priv *rtlpriv,
2695                     u8 *tmp_buf, u8 length);
2696     bool (*btc_is_limited_dig)(struct rtl_priv *rtlpriv);
2697     bool (*btc_is_disable_edca_turbo)(struct rtl_priv *rtlpriv);
2698     bool (*btc_is_bt_disabled)(struct rtl_priv *rtlpriv);
2699     void (*btc_special_packet_notify)(struct rtl_priv *rtlpriv,
2700                       u8 pkt_type);
2701     void (*btc_switch_band_notify)(struct rtl_priv *rtlpriv, u8 type,
2702                        bool scanning);
2703     void (*btc_switch_band_notify_wifi_only)(struct rtl_priv *rtlpriv,
2704                          u8 type, bool scanning);
2705     void (*btc_display_bt_coex_info)(struct rtl_priv *rtlpriv,
2706                      struct seq_file *m);
2707     void (*btc_record_pwr_mode)(struct rtl_priv *rtlpriv, u8 *buf, u8 len);
2708     u8   (*btc_get_lps_val)(struct rtl_priv *rtlpriv);
2709     u8   (*btc_get_rpwm_val)(struct rtl_priv *rtlpriv);
2710     bool (*btc_is_bt_ctrl_lps)(struct rtl_priv *rtlpriv);
2711     void (*btc_get_ampdu_cfg)(struct rtl_priv *rtlpriv, u8 *reject_agg,
2712                   u8 *ctrl_agg_size, u8 *agg_size);
2713     bool (*btc_is_bt_lps_on)(struct rtl_priv *rtlpriv);
2714 };
2715 
2716 struct proxim {
2717     bool proxim_on;
2718 
2719     void *proximity_priv;
2720     int (*proxim_rx)(struct ieee80211_hw *hw, struct rtl_stats *status,
2721              struct sk_buff *skb);
2722     u8  (*proxim_get_var)(struct ieee80211_hw *hw, u8 type);
2723 };
2724 
2725 struct rtl_c2hcmd {
2726     struct list_head list;
2727     u8 tag;
2728     u8 len;
2729     u8 *val;
2730 };
2731 
2732 struct rtl_bssid_entry {
2733     struct list_head list;
2734     u8 bssid[ETH_ALEN];
2735     u32 age;
2736 };
2737 
2738 struct rtl_scan_list {
2739     int num;
2740     struct list_head list;  /* sort by age */
2741 };
2742 
2743 struct rtl_priv {
2744     struct ieee80211_hw *hw;
2745     struct completion firmware_loading_complete;
2746     struct list_head list;
2747     struct rtl_priv *buddy_priv;
2748     struct rtl_global_var *glb_var;
2749     struct rtl_dualmac_easy_concurrent_ctl easy_concurrent_ctl;
2750     struct rtl_dmsp_ctl dmsp_ctl;
2751     struct rtl_locks locks;
2752     struct rtl_works works;
2753     struct rtl_mac mac80211;
2754     struct rtl_hal rtlhal;
2755     struct rtl_regulatory regd;
2756     struct rtl_rfkill rfkill;
2757     struct rtl_io io;
2758     struct rtl_phy phy;
2759     struct rtl_dm dm;
2760     struct rtl_security sec;
2761     struct rtl_efuse efuse;
2762     struct rtl_led_ctl ledctl;
2763     struct rtl_tx_report tx_report;
2764     struct rtl_scan_list scan_list;
2765 
2766     struct rtl_ps_ctl psc;
2767     struct rate_adaptive ra;
2768     struct dynamic_primary_cca primarycca;
2769     struct wireless_stats stats;
2770     struct rt_link_detect link_info;
2771     struct false_alarm_statistics falsealm_cnt;
2772 
2773     struct rtl_rate_priv *rate_priv;
2774 
2775     /* sta entry list for ap adhoc or mesh */
2776     struct list_head entry_list;
2777 
2778     /* c2hcmd list for kthread level access */
2779     struct sk_buff_head c2hcmd_queue;
2780 
2781     struct rtl_debug dbg;
2782     int max_fw_size;
2783 
2784     /* hal_cfg : for diff cards
2785      * intf_ops : for diff interrface usb/pcie
2786      */
2787     struct rtl_hal_cfg *cfg;
2788     const struct rtl_intf_ops *intf_ops;
2789 
2790     /* this var will be set by set_bit,
2791      * and was used to indicate status of
2792      * interface or hardware
2793      */
2794     unsigned long status;
2795 
2796     /* tables for dm */
2797     struct dig_t dm_digtable;
2798     struct ps_t dm_pstable;
2799 
2800     u32 reg_874;
2801     u32 reg_c70;
2802     u32 reg_85c;
2803     u32 reg_a74;
2804     bool reg_init;  /* true if regs saved */
2805     bool bt_operation_on;
2806     __le32 *usb_data;
2807     int usb_data_index;
2808     bool initialized;
2809     bool enter_ps;  /* true when entering PS */
2810     u8 rate_mask[5];
2811 
2812     /* intel Proximity, should be alloc mem
2813      * in intel Proximity module and can only
2814      * be used in intel Proximity mode
2815      */
2816     struct proxim proximity;
2817 
2818     /*for bt coexist use*/
2819     struct bt_coexist_info btcoexist;
2820 
2821     /* separate 92ee from other ICs,
2822      * 92ee use new trx flow.
2823      */
2824     bool use_new_trx_flow;
2825 
2826 #ifdef CONFIG_PM
2827     struct wiphy_wowlan_support wowlan;
2828 #endif
2829     /* This must be the last item so
2830      * that it points to the data allocated
2831      * beyond  this structure like:
2832      * rtl_pci_priv or rtl_usb_priv
2833      */
2834     u8 priv[0] __aligned(sizeof(void *));
2835 };
2836 
2837 #define rtl_priv(hw)        (((struct rtl_priv *)(hw)->priv))
2838 #define rtl_mac(rtlpriv)    (&((rtlpriv)->mac80211))
2839 #define rtl_hal(rtlpriv)    (&((rtlpriv)->rtlhal))
2840 #define rtl_efuse(rtlpriv)  (&((rtlpriv)->efuse))
2841 #define rtl_psc(rtlpriv)    (&((rtlpriv)->psc))
2842 
2843 /* Bluetooth Co-existence Related */
2844 
2845 enum bt_ant_num {
2846     ANT_X2 = 0,
2847     ANT_X1 = 1,
2848 };
2849 
2850 enum bt_ant_path {
2851     ANT_MAIN = 0,
2852     ANT_AUX = 1,
2853 };
2854 
2855 enum bt_co_type {
2856     BT_2WIRE = 0,
2857     BT_ISSC_3WIRE = 1,
2858     BT_ACCEL = 2,
2859     BT_CSR_BC4 = 3,
2860     BT_CSR_BC8 = 4,
2861     BT_RTL8756 = 5,
2862     BT_RTL8723A = 6,
2863     BT_RTL8821A = 7,
2864     BT_RTL8723B = 8,
2865     BT_RTL8192E = 9,
2866     BT_RTL8812A = 11,
2867 };
2868 
2869 enum bt_cur_state {
2870     BT_OFF = 0,
2871     BT_ON = 1,
2872 };
2873 
2874 enum bt_service_type {
2875     BT_SCO = 0,
2876     BT_A2DP = 1,
2877     BT_HID = 2,
2878     BT_HID_IDLE = 3,
2879     BT_SCAN = 4,
2880     BT_IDLE = 5,
2881     BT_OTHER_ACTION = 6,
2882     BT_BUSY = 7,
2883     BT_OTHERBUSY = 8,
2884     BT_PAN = 9,
2885 };
2886 
2887 enum bt_radio_shared {
2888     BT_RADIO_SHARED = 0,
2889     BT_RADIO_INDIVIDUAL = 1,
2890 };
2891 
2892 /****************************************
2893  *  mem access macro define start
2894  *  Call endian free function when
2895  *  1. Read/write packet content.
2896  *  2. Before write integer to IO.
2897  *  3. After read integer from IO.
2898  ****************************************/
2899 
2900 #define N_BYTE_ALIGMENT(__value, __aligment) ((__aligment == 1) ? \
2901     (__value) : (((__value + __aligment - 1) / __aligment) * __aligment))
2902 
2903 /* mem access macro define end */
2904 
2905 #define byte(x, n) ((x >> (8 * n)) & 0xff)
2906 
2907 #define packet_get_type(_packet) (EF1BYTE((_packet).octet[0]) & 0xFC)
2908 #define RTL_WATCH_DOG_TIME  2000
2909 #define MSECS(t)        msecs_to_jiffies(t)
2910 #define WLAN_FC_GET_VERS(fc)    (le16_to_cpu(fc) & IEEE80211_FCTL_VERS)
2911 #define WLAN_FC_GET_TYPE(fc)    (le16_to_cpu(fc) & IEEE80211_FCTL_FTYPE)
2912 #define WLAN_FC_GET_STYPE(fc)   (le16_to_cpu(fc) & IEEE80211_FCTL_STYPE)
2913 #define WLAN_FC_MORE_DATA(fc)   (le16_to_cpu(fc) & IEEE80211_FCTL_MOREDATA)
2914 #define rtl_dm(rtlpriv)     (&((rtlpriv)->dm))
2915 
2916 #define RT_RF_OFF_LEVL_ASPM     BIT(0)  /*PCI ASPM */
2917 #define RT_RF_OFF_LEVL_CLK_REQ      BIT(1)  /*PCI clock request */
2918 #define RT_RF_OFF_LEVL_PCI_D3       BIT(2)  /*PCI D3 mode */
2919 /*NIC halt, re-initialize hw parameters*/
2920 #define RT_RF_OFF_LEVL_HALT_NIC     BIT(3)
2921 #define RT_RF_OFF_LEVL_FREE_FW      BIT(4)  /*FW free, re-download the FW */
2922 #define RT_RF_OFF_LEVL_FW_32K       BIT(5)  /*FW in 32k */
2923 /*Always enable ASPM and Clock Req in initialization.*/
2924 #define RT_RF_PS_LEVEL_ALWAYS_ASPM  BIT(6)
2925 /* no matter RFOFF or SLEEP we set PS_ASPM_LEVL*/
2926 #define RT_PS_LEVEL_ASPM        BIT(7)
2927 /*When LPS is on, disable 2R if no packet is received or transmittd.*/
2928 #define RT_RF_LPS_DISALBE_2R        BIT(30)
2929 #define RT_RF_LPS_LEVEL_ASPM        BIT(31) /*LPS with ASPM */
2930 #define RT_IN_PS_LEVEL(ppsc, _ps_flg)       \
2931     ((ppsc->cur_ps_level & _ps_flg) ? true : false)
2932 #define RT_CLEAR_PS_LEVEL(ppsc, _ps_flg)    \
2933     (ppsc->cur_ps_level &= (~(_ps_flg)))
2934 #define RT_SET_PS_LEVEL(ppsc, _ps_flg)      \
2935     (ppsc->cur_ps_level |= _ps_flg)
2936 
2937 #define FILL_OCTET_STRING(_os, _octet, _len)    \
2938         (_os).octet = (u8 *)(_octet);       \
2939         (_os).length = (_len);
2940 
2941 #define CP_MACADDR(des, src)    \
2942     ((des)[0] = (src)[0], (des)[1] = (src)[1],\
2943     (des)[2] = (src)[2], (des)[3] = (src)[3],\
2944     (des)[4] = (src)[4], (des)[5] = (src)[5])
2945 
2946 #define LDPC_HT_ENABLE_RX           BIT(0)
2947 #define LDPC_HT_ENABLE_TX           BIT(1)
2948 #define LDPC_HT_TEST_TX_ENABLE          BIT(2)
2949 #define LDPC_HT_CAP_TX              BIT(3)
2950 
2951 #define STBC_HT_ENABLE_RX           BIT(0)
2952 #define STBC_HT_ENABLE_TX           BIT(1)
2953 #define STBC_HT_TEST_TX_ENABLE          BIT(2)
2954 #define STBC_HT_CAP_TX              BIT(3)
2955 
2956 #define LDPC_VHT_ENABLE_RX          BIT(0)
2957 #define LDPC_VHT_ENABLE_TX          BIT(1)
2958 #define LDPC_VHT_TEST_TX_ENABLE         BIT(2)
2959 #define LDPC_VHT_CAP_TX             BIT(3)
2960 
2961 #define STBC_VHT_ENABLE_RX          BIT(0)
2962 #define STBC_VHT_ENABLE_TX          BIT(1)
2963 #define STBC_VHT_TEST_TX_ENABLE         BIT(2)
2964 #define STBC_VHT_CAP_TX             BIT(3)
2965 
2966 extern u8 channel5g[CHANNEL_MAX_NUMBER_5G];
2967 
2968 extern u8 channel5g_80m[CHANNEL_MAX_NUMBER_5G_80M];
2969 
2970 static inline u8 rtl_read_byte(struct rtl_priv *rtlpriv, u32 addr)
2971 {
2972     return rtlpriv->io.read8_sync(rtlpriv, addr);
2973 }
2974 
2975 static inline u16 rtl_read_word(struct rtl_priv *rtlpriv, u32 addr)
2976 {
2977     return rtlpriv->io.read16_sync(rtlpriv, addr);
2978 }
2979 
2980 static inline u32 rtl_read_dword(struct rtl_priv *rtlpriv, u32 addr)
2981 {
2982     return rtlpriv->io.read32_sync(rtlpriv, addr);
2983 }
2984 
2985 static inline void rtl_write_byte(struct rtl_priv *rtlpriv, u32 addr, u8 val8)
2986 {
2987     rtlpriv->io.write8_async(rtlpriv, addr, val8);
2988 
2989     if (rtlpriv->cfg->write_readback)
2990         rtlpriv->io.read8_sync(rtlpriv, addr);
2991 }
2992 
2993 static inline void rtl_write_byte_with_val32(struct ieee80211_hw *hw,
2994                          u32 addr, u32 val8)
2995 {
2996     struct rtl_priv *rtlpriv = rtl_priv(hw);
2997 
2998     rtl_write_byte(rtlpriv, addr, (u8)val8);
2999 }
3000 
3001 static inline void rtl_write_word(struct rtl_priv *rtlpriv, u32 addr, u16 val16)
3002 {
3003     rtlpriv->io.write16_async(rtlpriv, addr, val16);
3004 
3005     if (rtlpriv->cfg->write_readback)
3006         rtlpriv->io.read16_sync(rtlpriv, addr);
3007 }
3008 
3009 static inline void rtl_write_dword(struct rtl_priv *rtlpriv,
3010                    u32 addr, u32 val32)
3011 {
3012     rtlpriv->io.write32_async(rtlpriv, addr, val32);
3013 
3014     if (rtlpriv->cfg->write_readback)
3015         rtlpriv->io.read32_sync(rtlpriv, addr);
3016 }
3017 
3018 static inline u32 rtl_get_bbreg(struct ieee80211_hw *hw,
3019                 u32 regaddr, u32 bitmask)
3020 {
3021     struct rtl_priv *rtlpriv = hw->priv;
3022 
3023     return rtlpriv->cfg->ops->get_bbreg(hw, regaddr, bitmask);
3024 }
3025 
3026 static inline void rtl_set_bbreg(struct ieee80211_hw *hw, u32 regaddr,
3027                  u32 bitmask, u32 data)
3028 {
3029     struct rtl_priv *rtlpriv = hw->priv;
3030 
3031     rtlpriv->cfg->ops->set_bbreg(hw, regaddr, bitmask, data);
3032 }
3033 
3034 static inline void rtl_set_bbreg_with_dwmask(struct ieee80211_hw *hw,
3035                          u32 regaddr, u32 data)
3036 {
3037     rtl_set_bbreg(hw, regaddr, 0xffffffff, data);
3038 }
3039 
3040 static inline u32 rtl_get_rfreg(struct ieee80211_hw *hw,
3041                 enum radio_path rfpath, u32 regaddr,
3042                 u32 bitmask)
3043 {
3044     struct rtl_priv *rtlpriv = hw->priv;
3045 
3046     return rtlpriv->cfg->ops->get_rfreg(hw, rfpath, regaddr, bitmask);
3047 }
3048 
3049 static inline void rtl_set_rfreg(struct ieee80211_hw *hw,
3050                  enum radio_path rfpath, u32 regaddr,
3051                  u32 bitmask, u32 data)
3052 {
3053     struct rtl_priv *rtlpriv = hw->priv;
3054 
3055     rtlpriv->cfg->ops->set_rfreg(hw, rfpath, regaddr, bitmask, data);
3056 }
3057 
3058 static inline bool is_hal_stop(struct rtl_hal *rtlhal)
3059 {
3060     return (_HAL_STATE_STOP == rtlhal->state);
3061 }
3062 
3063 static inline void set_hal_start(struct rtl_hal *rtlhal)
3064 {
3065     rtlhal->state = _HAL_STATE_START;
3066 }
3067 
3068 static inline void set_hal_stop(struct rtl_hal *rtlhal)
3069 {
3070     rtlhal->state = _HAL_STATE_STOP;
3071 }
3072 
3073 static inline u8 get_rf_type(struct rtl_phy *rtlphy)
3074 {
3075     return rtlphy->rf_type;
3076 }
3077 
3078 static inline struct ieee80211_hdr *rtl_get_hdr(struct sk_buff *skb)
3079 {
3080     return (struct ieee80211_hdr *)(skb->data);
3081 }
3082 
3083 static inline __le16 rtl_get_fc(struct sk_buff *skb)
3084 {
3085     return rtl_get_hdr(skb)->frame_control;
3086 }
3087 
3088 static inline u16 rtl_get_tid(struct sk_buff *skb)
3089 {
3090     return ieee80211_get_tid(rtl_get_hdr(skb));
3091 }
3092 
3093 static inline struct ieee80211_sta *get_sta(struct ieee80211_hw *hw,
3094                         struct ieee80211_vif *vif,
3095                         const u8 *bssid)
3096 {
3097     return ieee80211_find_sta(vif, bssid);
3098 }
3099 
3100 static inline struct ieee80211_sta *rtl_find_sta(struct ieee80211_hw *hw,
3101                          u8 *mac_addr)
3102 {
3103     struct rtl_mac *mac = rtl_mac(rtl_priv(hw));
3104 
3105     return ieee80211_find_sta(mac->vif, mac_addr);
3106 }
3107 
3108 #endif