1 /* SPDX-License-Identifier: ISC */
2 /* Copyright (C) 2019 MediaTek Inc. */
7 struct mt7615_mcu_txd {
15 u8 set_query; /* FW don't care */
24 } __packed __aligned(4);
27 * struct mt7615_uni_txd - mcu command descriptor for firmware v3
28 * @txd: hardware descriptor
29 * @len: total length not including txd
30 * @cid: command identifier
31 * @pkt_type: must be 0xa0 (cmd packet by long format)
32 * @frag_n: fragment number
33 * @seq: sequence number
34 * @checksum: 0 mean there is no checksum
35 * @s2d_index: index for command source and destination
36 * Definition | value | note
37 * CMD_S2D_IDX_H2N | 0x00 | command from HOST to WM
38 * CMD_S2D_IDX_C2N | 0x01 | command from WA to WM
39 * CMD_S2D_IDX_H2C | 0x02 | command from HOST to WA
40 * CMD_S2D_IDX_H2N_AND_H2C | 0x03 | command from HOST to WA and WM
42 * @option: command option
43 * BIT[0]: UNI_CMD_OPT_BIT_ACK
44 * set to 1 to request a fw reply
45 * if UNI_CMD_OPT_BIT_0_ACK is set and UNI_CMD_OPT_BIT_2_SET_QUERY
46 * is set, mcu firmware will send response event EID = 0x01
47 * (UNI_EVENT_ID_CMD_RESULT) to the host.
48 * BIT[1]: UNI_CMD_OPT_BIT_UNI_CMD
51 * BIT[2]: UNI_CMD_OPT_BIT_SET_QUERY
55 struct mt7615_uni_txd {
75 } __packed __aligned(4);
79 MCU_EVENT_TARGET_ADDRESS_LEN = 0x01,
80 MCU_EVENT_FW_START = 0x01,
81 MCU_EVENT_GENERIC = 0x01,
82 MCU_EVENT_ACCESS_REG = 0x02,
83 MCU_EVENT_MT_PATCH_SEM = 0x04,
84 MCU_EVENT_SCAN_DONE = 0x0d,
85 MCU_EVENT_BSS_ABSENCE = 0x11,
86 MCU_EVENT_CH_PRIVILEGE = 0x18,
87 MCU_EVENT_SCHED_SCAN_DONE = 0x23,
89 MCU_EVENT_RESTART_DL = 0xef,
94 MCU_EXT_EVENT_PS_SYNC = 0x5,
95 MCU_EXT_EVENT_FW_LOG_2_HOST = 0x13,
96 MCU_EXT_EVENT_THERMAL_PROTECT = 0x22,
97 MCU_EXT_EVENT_ASSERT_DUMP = 0x23,
98 MCU_EXT_EVENT_RDD_REPORT = 0x3a,
99 MCU_EXT_EVENT_CSA_NOTIFY = 0x4f,
112 MT_SKU_HT20_1_2_9_10,
113 MT_SKU_HT20_3_4_11_12,
119 MT_SKU_HT40_1_2_9_10,
120 MT_SKU_HT40_3_4_11_12,
158 struct mt7615_mcu_rxd {
173 struct mt7615_mcu_rdd_report {
174 struct mt7615_mcu_rxd rxd;
178 u8 constant_prf_detected;
179 u8 staggered_prf_detected;
181 u8 periodic_pulse_num;
195 __le32 out_pri_const;
196 __le32 out_pri_stg[3];
208 } periodic_pulse[32];
219 #define MCU_PQ_ID(p, q) (((p) << 15) | ((q) << 10))
220 #define MCU_PKT_ID 0xa0
236 #define MCU_FW_PREFIX BIT(31)
237 #define MCU_UNI_PREFIX BIT(30)
238 #define MCU_CE_PREFIX BIT(29)
239 #define MCU_CMD_MASK ~(MCU_FW_PREFIX | MCU_UNI_PREFIX | \
243 MCU_CMD_TARGET_ADDRESS_LEN_REQ = MCU_FW_PREFIX | 0x01,
244 MCU_CMD_FW_START_REQ = MCU_FW_PREFIX | 0x02,
245 MCU_CMD_INIT_ACCESS_REG = 0x3,
246 MCU_CMD_PATCH_START_REQ = 0x05,
247 MCU_CMD_PATCH_FINISH_REQ = MCU_FW_PREFIX | 0x07,
248 MCU_CMD_PATCH_SEM_CONTROL = MCU_FW_PREFIX | 0x10,
249 MCU_CMD_EXT_CID = 0xED,
250 MCU_CMD_FW_SCATTER = MCU_FW_PREFIX | 0xEE,
251 MCU_CMD_RESTART_DL_REQ = MCU_FW_PREFIX | 0xEF,
255 MCU_EXT_CMD_PM_STATE_CTRL = 0x07,
256 MCU_EXT_CMD_CHANNEL_SWITCH = 0x08,
257 MCU_EXT_CMD_SET_TX_POWER_CTRL = 0x11,
258 MCU_EXT_CMD_FW_LOG_2_HOST = 0x13,
259 MCU_EXT_CMD_EFUSE_BUFFER_MODE = 0x21,
260 MCU_EXT_CMD_STA_REC_UPDATE = 0x25,
261 MCU_EXT_CMD_BSS_INFO_UPDATE = 0x26,
262 MCU_EXT_CMD_EDCA_UPDATE = 0x27,
263 MCU_EXT_CMD_DEV_INFO_UPDATE = 0x2A,
264 MCU_EXT_CMD_GET_TEMP = 0x2c,
265 MCU_EXT_CMD_WTBL_UPDATE = 0x32,
266 MCU_EXT_CMD_SET_RDD_CTRL = 0x3a,
267 MCU_EXT_CMD_PROTECT_CTRL = 0x3e,
268 MCU_EXT_CMD_DBDC_CTRL = 0x45,
269 MCU_EXT_CMD_MAC_INIT_CTRL = 0x46,
270 MCU_EXT_CMD_BCN_OFFLOAD = 0x49,
271 MCU_EXT_CMD_SET_RX_PATH = 0x4e,
272 MCU_EXT_CMD_TX_POWER_FEATURE_CTRL = 0x58,
273 MCU_EXT_CMD_RXDCOC_CAL = 0x59,
274 MCU_EXT_CMD_TXDPD_CAL = 0x60,
275 MCU_EXT_CMD_SET_RDD_TH = 0x7c,
276 MCU_EXT_CMD_SET_RDD_PATTERN = 0x7d,
280 MCU_UNI_CMD_DEV_INFO_UPDATE = MCU_UNI_PREFIX | 0x01,
281 MCU_UNI_CMD_BSS_INFO_UPDATE = MCU_UNI_PREFIX | 0x02,
282 MCU_UNI_CMD_STA_REC_UPDATE = MCU_UNI_PREFIX | 0x03,
285 struct mt7615_mcu_scan_ssid {
287 u8 ssid[IEEE80211_MAX_SSID_LEN];
290 struct mt7615_mcu_scan_channel {
291 u8 band; /* 1: 2.4GHz
298 struct mt7615_mcu_scan_match {
300 u8 ssid[IEEE80211_MAX_SSID_LEN];
305 struct mt7615_hw_scan_req {
308 u8 scan_type; /* 0: PASSIVE SCAN
311 u8 ssid_type; /* BIT(0) wildcard SSID
312 * BIT(1) P2P wildcard SSID
313 * BIT(2) specified SSID
316 u8 probe_req_num; /* Number of probe request for each SSID */
317 u8 scan_func; /* BIT(0) Enable random MAC scan
318 * BIT(1) Disable DBDC scan type 1~3.
319 * BIT(2) Use DBDC scan type 3 (dedicated one RF to scan).
321 u8 version; /* 0: Not support fields after ies.
322 * 1: Support fields after ies.
324 struct mt7615_mcu_scan_ssid ssids[4];
325 __le16 probe_delay_time;
326 __le16 channel_dwell_time; /* channel Dwell interval */
327 __le16 timeout_value;
328 u8 channel_type; /* 0: Full channels
329 * 1: Only 2.4GHz channels
330 * 2: Only 5GHz channels
331 * 3: P2P social channel only (channel #1, #6 and #11)
332 * 4: Specified channels
335 u8 channels_num; /* valid when channel_type is 4 */
336 /* valid when channels_num is set */
337 struct mt7615_mcu_scan_channel channels[32];
339 u8 ies[MT7615_SCAN_IE_LEN];
340 /* following fields are valid if version > 0 */
343 __le16 channel_min_dwell_time;
344 struct mt7615_mcu_scan_channel ext_channels[32];
345 struct mt7615_mcu_scan_ssid ext_ssids[6];
347 u8 random_mac[ETH_ALEN]; /* valid when BIT(1) in scan_func is set. */
351 #define SCAN_DONE_EVENT_MAX_CHANNEL_NUM 64
352 struct mt7615_hw_scan_done {
354 u8 sparse_channel_num;
355 struct mt7615_mcu_scan_channel sparse_channel;
356 u8 complete_channel_num;
360 __le32 beacon_scan_num;
363 u8 sparse_channel_valid_num;
365 u8 channel_num[SCAN_DONE_EVENT_MAX_CHANNEL_NUM];
366 /* idle format for channel_idle_time
367 * 0: first bytes: idle time(ms) 2nd byte: dwell time(ms)
368 * 1: first bytes: idle time(8ms) 2nd byte: dwell time(8ms)
369 * 2: dwell time (16us)
371 __le16 channel_idle_time[SCAN_DONE_EVENT_MAX_CHANNEL_NUM];
372 /* beacon and probe response count */
373 u8 beacon_probe_num[SCAN_DONE_EVENT_MAX_CHANNEL_NUM];
374 u8 mdrdy_count[SCAN_DONE_EVENT_MAX_CHANNEL_NUM];
375 __le32 beacon_2g_num;
376 __le32 beacon_5g_num;
379 struct mt7615_sched_scan_req {
387 struct mt7615_mcu_scan_ssid ssids[MT7615_MAX_SCHED_SCAN_SSID];
388 struct mt7615_mcu_scan_match match[MT7615_MAX_SCAN_MATCH];
393 struct mt7615_mcu_scan_channel channels[64];
394 __le16 intervals[MT7615_MAX_SCHED_SCAN_INTERVAL];
398 struct nt7615_sched_scan_done {
400 u8 status; /* 0: ssid found */
404 struct mt7615_mcu_bss_event {
411 /* offload mcu commands */
413 MCU_CMD_START_HW_SCAN = MCU_CE_PREFIX | 0x03,
414 MCU_CMD_SET_CHAN_DOMAIN = MCU_CE_PREFIX | 0x0f,
415 MCU_CMD_CANCEL_HW_SCAN = MCU_CE_PREFIX | 0x1b,
416 MCU_CMD_SCHED_SCAN_ENABLE = MCU_CE_PREFIX | 0x61,
417 MCU_CMD_SCHED_SCAN_REQ = MCU_CE_PREFIX | 0x62,
420 #define MCU_CMD_ACK BIT(0)
421 #define MCU_CMD_UNI BIT(1)
422 #define MCU_CMD_QUERY BIT(2)
424 #define MCU_CMD_UNI_EXT_ACK (MCU_CMD_ACK | MCU_CMD_UNI | MCU_CMD_QUERY)
427 UNI_BSS_INFO_BASIC = 0,
428 UNI_BSS_INFO_RLM = 2,
429 UNI_BSS_INFO_BCN_CONTENT = 7,
433 PATCH_SEM_RELEASE = 0x0,
438 PATCH_NOT_DL_SEM_FAIL = 0x0,
440 PATCH_NOT_DL_SEM_SUCCESS = 0x2,
441 PATCH_REL_SEM_SUCCESS = 0x3
445 FW_STATE_INITIAL = 0,
446 FW_STATE_FW_DOWNLOAD = 1,
447 FW_STATE_NORMAL_OPERATION = 2,
448 FW_STATE_NORMAL_TRX = 3,
452 #define STA_TYPE_STA BIT(0)
453 #define STA_TYPE_AP BIT(1)
454 #define STA_TYPE_ADHOC BIT(2)
455 #define STA_TYPE_WDS BIT(4)
456 #define STA_TYPE_BC BIT(5)
458 #define NETWORK_INFRA BIT(16)
459 #define NETWORK_P2P BIT(17)
460 #define NETWORK_IBSS BIT(18)
461 #define NETWORK_WDS BIT(21)
463 #define CONNECTION_INFRA_STA (STA_TYPE_STA | NETWORK_INFRA)
464 #define CONNECTION_INFRA_AP (STA_TYPE_AP | NETWORK_INFRA)
465 #define CONNECTION_P2P_GC (STA_TYPE_STA | NETWORK_P2P)
466 #define CONNECTION_P2P_GO (STA_TYPE_AP | NETWORK_P2P)
467 #define CONNECTION_IBSS_ADHOC (STA_TYPE_ADHOC | NETWORK_IBSS)
468 #define CONNECTION_WDS (STA_TYPE_WDS | NETWORK_WDS)
469 #define CONNECTION_INFRA_BC (STA_TYPE_BC | NETWORK_INFRA)
471 #define CONN_STATE_DISCONNECT 0
472 #define CONN_STATE_CONNECT 1
473 #define CONN_STATE_PORT_SECURE 2
497 struct bss_info_omac {
508 struct bss_info_basic {
519 u8 cipher; /* not used */
520 u8 phymode; /* not used */
524 struct bss_info_rf_ch {
533 struct bss_info_ext_bss {
536 __le32 mbss_tsf_offset; /* in unit of us */
543 BSS_INFO_RF_CH, /* optional, for BT/LTE coex */
544 BSS_INFO_PM, /* sta only */
545 BSS_INFO_UAPSD, /* sta only */
546 BSS_INFO_ROAM_DETECTION, /* obsoleted */
547 BSS_INFO_LQ_RM, /* obsoleted */
549 BSS_INFO_BMC_INFO, /* for bmc rate control in CR4 */
550 BSS_INFO_SYNC_MODE, /* obsoleted */
556 WTBL_RESET_AND_SET = 1,
562 struct wtbl_req_hdr {
569 struct wtbl_generic {
572 u8 peer_addr[ETH_ALEN];
621 struct wtbl_hdr_trans {
632 MT_BA_TYPE_ORIGINATOR,
637 RST_BA_MAC_TID_MATCH,
649 /* originator only */
655 u8 peer_addr[ETH_ALEN];
706 #define MT7615_WTBL_UPDATE_MAX_SIZE (sizeof(struct wtbl_req_hdr) + \
707 sizeof(struct wtbl_generic) + \
708 sizeof(struct wtbl_rx) + \
709 sizeof(struct wtbl_ht) + \
710 sizeof(struct wtbl_vht) + \
711 sizeof(struct wtbl_tx_ps) + \
712 sizeof(struct wtbl_hdr_trans) +\
713 sizeof(struct wtbl_ba) + \
714 sizeof(struct wtbl_bf) + \
715 sizeof(struct wtbl_smps) + \
716 sizeof(struct wtbl_pn) + \
717 sizeof(struct wtbl_spe))
719 #define MT7615_STA_UPDATE_MAX_SIZE (sizeof(struct sta_req_hdr) + \
720 sizeof(struct sta_rec_basic) + \
721 sizeof(struct sta_rec_ht) + \
722 sizeof(struct sta_rec_vht) + \
723 sizeof(struct tlv) + \
724 MT7615_WTBL_UPDATE_MAX_SIZE)
726 #define MT7615_WTBL_UPDATE_BA_SIZE (sizeof(struct wtbl_req_hdr) + \
727 sizeof(struct wtbl_ba))
734 WTBL_PEER_PS, /* not used */
739 WTBL_RDG, /* obsoleted */
740 WTBL_PROTECT, /* not used */
741 WTBL_CLEAR, /* not used */
744 WTBL_RAW_DATA, /* debug only */
750 struct sta_ntlv_hdr {
764 struct sta_rec_state {
773 struct sta_rec_basic {
780 u8 peer_addr[ETH_ALEN];
781 #define EXTRA_INFO_VER BIT(0)
782 #define EXTRA_INFO_NEW BIT(1)
797 __le16 vht_rx_mcs_map;
798 __le16 vht_tx_mcs_map;
818 STA_REC_AMSDU, /* for CR4 */
821 STA_REC_TX_PROC, /* for hdr trans and CSO in CR4 */
840 CH_SWITCH_NORMAL = 0,
844 CH_SWITCH_BACKGROUND_SCAN_START = 6,
845 CH_SWITCH_BACKGROUND_SCAN_RUNNING = 7,
846 CH_SWITCH_BACKGROUND_SCAN_STOP = 8,
847 CH_SWITCH_SCAN_BYPASS_DPD = 9