drivers/net/wireless/mediatek/mt76/mt7921/mcu.h

   1 /* SPDX-License-Identifier: ISC */
   2 /* Copyright (C) 2020 MediaTek Inc. */
   3
   4 #ifndef __MT7921_MCU_H
   5 #define __MT7921_MCU_H
   6
   7 #include "../mt76_connac_mcu.h"
   8
   9 struct mt7921_mcu_txd {
  10         __le32 txd[8];
  11
  12         __le16 len;
  13         __le16 pq_id;
  14
  15         u8 cid;
  16         u8 pkt_type;
  17         u8 set_query; /* FW don't care */
  18         u8 seq;
  19
  20         u8 uc_d2b0_rev;
  21         u8 ext_cid;
  22         u8 s2d_index;
  23         u8 ext_cid_ack;
  24
  25         u32 reserved[5];
  26 } __packed __aligned(4);
  27
  28 /**
  29  * struct mt7921_uni_txd - mcu command descriptor for firmware v3
  30  * @txd: hardware descriptor
  31  * @len: total length not including txd
  32  * @cid: command identifier
  33  * @pkt_type: must be 0xa0 (cmd packet by long format)
  34  * @frag_n: fragment number
  35  * @seq: sequence number
  36  * @checksum: 0 mean there is no checksum
  37  * @s2d_index: index for command source and destination
  38  *  Definition              | value | note
  39  *  CMD_S2D_IDX_H2N         | 0x00  | command from HOST to WM
  40  *  CMD_S2D_IDX_C2N         | 0x01  | command from WA to WM
  41  *  CMD_S2D_IDX_H2C         | 0x02  | command from HOST to WA
  42  *  CMD_S2D_IDX_H2N_AND_H2C | 0x03  | command from HOST to WA and WM
  43  *
  44  * @option: command option
  45  *  BIT[0]: UNI_CMD_OPT_BIT_ACK
  46  *          set to 1 to request a fw reply
  47  *          if UNI_CMD_OPT_BIT_0_ACK is set and UNI_CMD_OPT_BIT_2_SET_QUERY
  48  *          is set, mcu firmware will send response event EID = 0x01
  49  *          (UNI_EVENT_ID_CMD_RESULT) to the host.
  50  *  BIT[1]: UNI_CMD_OPT_BIT_UNI_CMD
  51  *          0: original command
  52  *          1: unified command
  53  *  BIT[2]: UNI_CMD_OPT_BIT_SET_QUERY
  54  *          0: QUERY command
  55  *          1: SET command
  56  */
  57 struct mt7921_uni_txd {
  58         __le32 txd[8];
  59
  60         /* DW1 */
  61         __le16 len;
  62         __le16 cid;
  63
  64         /* DW2 */
  65         u8 reserved;
  66         u8 pkt_type;
  67         u8 frag_n;
  68         u8 seq;
  69
  70         /* DW3 */
  71         __le16 checksum;
  72         u8 s2d_index;
  73         u8 option;
  74
  75         /* DW4 */
  76         u8 reserved2[4];
  77 } __packed __aligned(4);
  78
  79 /* event table */
  80 enum {
  81         MCU_EVENT_REG_ACCESS = 0x05,
  82         MCU_EVENT_LP_INFO = 0x07,
  83         MCU_EVENT_SCAN_DONE = 0x0d,
  84         MCU_EVENT_TX_DONE = 0x0f,
  85         MCU_EVENT_BSS_ABSENCE  = 0x11,
  86         MCU_EVENT_BSS_BEACON_LOSS = 0x13,
  87         MCU_EVENT_CH_PRIVILEGE = 0x18,
  88         MCU_EVENT_SCHED_SCAN_DONE = 0x23,
  89         MCU_EVENT_DBG_MSG = 0x27,
  90         MCU_EVENT_TXPWR = 0xd0,
  91         MCU_EVENT_COREDUMP = 0xf0,
  92 };
  93
  94 /* ext event table */
  95 enum {
  96         MCU_EXT_EVENT_RATE_REPORT = 0x87,
  97 };
  98
  99 struct mt7921_mcu_rxd {
 100         __le32 rxd[6];
 101
 102         __le16 len;
 103         __le16 pkt_type_id;
 104
 105         u8 eid;
 106         u8 seq;
 107         __le16 __rsv;
 108
 109         u8 ext_eid;
 110         u8 __rsv1[2];
 111         u8 s2d_index;
 112 };
 113
 114 struct mt7921_mcu_eeprom_info {
 115         __le32 addr;
 116         __le32 valid;
 117         u8 data[16];
 118 } __packed;
 119
 120 #define MT_RA_RATE_NSS                  GENMASK(8, 6)
 121 #define MT_RA_RATE_MCS                  GENMASK(3, 0)
 122 #define MT_RA_RATE_TX_MODE              GENMASK(12, 9)
 123 #define MT_RA_RATE_DCM_EN               BIT(4)
 124 #define MT_RA_RATE_BW                   GENMASK(14, 13)
 125
 126 #define MCU_PQ_ID(p, q)                 (((p) << 15) | ((q) << 10))
 127 #define MCU_PKT_ID                      0xa0
 128
 129 enum {
 130         MCU_Q_QUERY,
 131         MCU_Q_SET,
 132         MCU_Q_RESERVED,
 133         MCU_Q_NA
 134 };
 135
 136 enum {
 137         MCU_S2D_H2N,
 138         MCU_S2D_C2N,
 139         MCU_S2D_H2C,
 140         MCU_S2D_H2CN
 141 };
 142
 143 struct mt7921_mcu_uni_event {
 144         u8 cid;
 145         u8 pad[3];
 146         __le32 status; /* 0: success, others: fail */
 147 } __packed;
 148
 149 enum {
 150         PATCH_NOT_DL_SEM_FAIL,
 151         PATCH_IS_DL,
 152         PATCH_NOT_DL_SEM_SUCCESS,
 153         PATCH_REL_SEM_SUCCESS
 154 };
 155
 156 enum {
 157         FW_STATE_INITIAL,
 158         FW_STATE_FW_DOWNLOAD,
 159         FW_STATE_NORMAL_OPERATION,
 160         FW_STATE_NORMAL_TRX,
 161         FW_STATE_WACPU_RDY        = 7
 162 };
 163
 164 enum {
 165         EE_MODE_EFUSE,
 166         EE_MODE_BUFFER,
 167 };
 168
 169 enum {
 170         EE_FORMAT_BIN,
 171         EE_FORMAT_WHOLE,
 172         EE_FORMAT_MULTIPLE,
 173 };
 174
 175 enum {
 176         MCU_PHY_STATE_TX_RATE,
 177         MCU_PHY_STATE_RX_RATE,
 178         MCU_PHY_STATE_RSSI,
 179         MCU_PHY_STATE_CONTENTION_RX_RATE,
 180         MCU_PHY_STATE_OFDMLQ_CNINFO,
 181 };
 182
 183 struct sec_key {
 184         u8 cipher_id;
 185         u8 cipher_len;
 186         u8 key_id;
 187         u8 key_len;
 188         u8 key[32];
 189 } __packed;
 190
 191 struct sta_rec_sec {
 192         __le16 tag;
 193         __le16 len;
 194         u8 add;
 195         u8 n_cipher;
 196         u8 rsv[2];
 197
 198         struct sec_key key[2];
 199 } __packed;
 200
 201 enum mcu_cipher_type {
 202         MCU_CIPHER_WEP40 = 1,
 203         MCU_CIPHER_WEP104,
 204         MCU_CIPHER_WEP128,
 205         MCU_CIPHER_TKIP,
 206         MCU_CIPHER_AES_CCMP,
 207         MCU_CIPHER_CCMP_256,
 208         MCU_CIPHER_GCMP,
 209         MCU_CIPHER_GCMP_256,
 210         MCU_CIPHER_WAPI,
 211         MCU_CIPHER_BIP_CMAC_128,
 212 };
 213
 214 enum {
 215         CH_SWITCH_NORMAL = 0,
 216         CH_SWITCH_SCAN = 3,
 217         CH_SWITCH_MCC = 4,
 218         CH_SWITCH_DFS = 5,
 219         CH_SWITCH_BACKGROUND_SCAN_START = 6,
 220         CH_SWITCH_BACKGROUND_SCAN_RUNNING = 7,
 221         CH_SWITCH_BACKGROUND_SCAN_STOP = 8,
 222         CH_SWITCH_SCAN_BYPASS_DPD = 9
 223 };
 224
 225 enum {
 226         THERMAL_SENSOR_TEMP_QUERY,
 227         THERMAL_SENSOR_MANUAL_CTRL,
 228         THERMAL_SENSOR_INFO_QUERY,
 229         THERMAL_SENSOR_TASK_CTRL,
 230 };
 231
 232 enum {
 233         MT_EBF = BIT(0),        /* explicit beamforming */
 234         MT_IBF = BIT(1)         /* implicit beamforming */
 235 };
 236
 237 #define STA_CAP_WMM                     BIT(0)
 238 #define STA_CAP_SGI_20                  BIT(4)
 239 #define STA_CAP_SGI_40                  BIT(5)
 240 #define STA_CAP_TX_STBC                 BIT(6)
 241 #define STA_CAP_RX_STBC                 BIT(7)
 242 #define STA_CAP_VHT_SGI_80              BIT(16)
 243 #define STA_CAP_VHT_SGI_160             BIT(17)
 244 #define STA_CAP_VHT_TX_STBC             BIT(18)
 245 #define STA_CAP_VHT_RX_STBC             BIT(19)
 246 #define STA_CAP_VHT_LDPC                BIT(23)
 247 #define STA_CAP_LDPC                    BIT(24)
 248 #define STA_CAP_HT                      BIT(26)
 249 #define STA_CAP_VHT                     BIT(27)
 250 #define STA_CAP_HE                      BIT(28)
 251
 252 struct mt7921_mcu_reg_event {
 253         __le32 reg;
 254         __le32 val;
 255 } __packed;
 256
 257 struct mt7921_mcu_ant_id_config {
 258         u8 ant_id[4];
 259 } __packed;
 260
 261 struct mt7921_mcu_peer_cap {
 262         struct mt7921_mcu_ant_id_config ant_id_config;
 263
 264         u8 power_offset;
 265         u8 bw_selector;
 266         u8 change_bw_rate_n;
 267         u8 bw;
 268         u8 spe_idx;
 269
 270         u8 g2;
 271         u8 g4;
 272         u8 g8;
 273         u8 g16;
 274
 275         u8 mmss;
 276         u8 ampdu_factor;
 277         u8 rsv[1];
 278 } __packed;
 279
 280 struct mt7921_txpwr_req {
 281         u8 ver;
 282         u8 action;
 283         __le16 len;
 284         u8 dbdc_idx;
 285         u8 rsv[3];
 286 } __packed;
 287
 288 struct mt7921_txpwr_event {
 289         u8 ver;
 290         u8 action;
 291         __le16 len;
 292         struct mt7921_txpwr txpwr;
 293 } __packed;
 294
 295 struct mt7921_mcu_tx_done_event {
 296         u8 pid;
 297         u8 status;
 298         u16 seq;
 299
 300         u8 wlan_idx;
 301         u8 tx_cnt;
 302         u16 tx_rate;
 303
 304         u8 flag;
 305         u8 tid;
 306         u8 rsp_rate;
 307         u8 mcs;
 308
 309         u8 bw;
 310         u8 tx_pwr;
 311         u8 reason;
 312         u8 rsv0[1];
 313
 314         u32 delay;
 315         u32 timestamp;
 316         u32 applied_flag;
 317
 318         u8 txs[28];
 319
 320         u8 rsv1[32];
 321 } __packed;
 322 #endif