1 /* SPDX-License-Identifier: ISC */
3 * Copyright (c) 2005-2011 Atheros Communications Inc.
4 * Copyright (c) 2011-2017 Qualcomm Atheros, Inc.
5 * Copyright (c) 2018-2019, The Linux Foundation. All rights reserved.
6 * Copyright (c) 2022 Qualcomm Innovation Center, Inc. All rights reserved.
12 #include <linux/completion.h>
13 #include <linux/if_ether.h>
14 #include <linux/types.h>
15 #include <linux/pci.h>
16 #include <linux/uuid.h>
17 #include <linux/time.h>
22 #include "targaddrs.h"
26 #include "../dfs_pattern_detector.h"
32 #define MS(_v, _f) (((_v) & _f##_MASK) >> _f##_LSB)
33 #define SM(_v, _f) (((_v) << _f##_LSB) & _f##_MASK)
34 #define WO(_f) ((_f##_OFFSET) >> 2)
36 #define ATH10K_SCAN_ID 0
37 #define ATH10K_SCAN_CHANNEL_SWITCH_WMI_EVT_OVERHEAD 10 /* msec */
38 #define WMI_READY_TIMEOUT (5 * HZ)
39 #define ATH10K_FLUSH_TIMEOUT_HZ (5 * HZ)
40 #define ATH10K_CONNECTION_LOSS_HZ (3 * HZ)
41 #define ATH10K_NUM_CHANS 41
42 #define ATH10K_MAX_5G_CHAN 173
44 /* Antenna noise floor */
45 #define ATH10K_DEFAULT_NOISE_FLOOR -95
47 #define ATH10K_INVALID_RSSI 128
49 #define ATH10K_MAX_NUM_MGMT_PENDING 128
51 /* number of failed packets (20 packets with 16 sw reties each) */
52 #define ATH10K_KICKOUT_THRESHOLD (20 * 16)
55 * Use insanely high numbers to make sure that the firmware implementation
56 * won't start, we have the same functionality already in hostapd. Unit
59 #define ATH10K_KEEPALIVE_MIN_IDLE 3747
60 #define ATH10K_KEEPALIVE_MAX_IDLE 3895
61 #define ATH10K_KEEPALIVE_MAX_UNRESPONSIVE 3900
63 /* SMBIOS type containing Board Data File Name Extension */
64 #define ATH10K_SMBIOS_BDF_EXT_TYPE 0xF8
66 /* SMBIOS type structure length (excluding strings-set) */
67 #define ATH10K_SMBIOS_BDF_EXT_LENGTH 0x9
69 /* Offset pointing to Board Data File Name Extension */
70 #define ATH10K_SMBIOS_BDF_EXT_OFFSET 0x8
72 /* Board Data File Name Extension string length.
73 * String format: BDF_<Customer ID>_<Extension>\0
75 #define ATH10K_SMBIOS_BDF_EXT_STR_LENGTH 0x20
77 /* The magic used by QCA spec */
78 #define ATH10K_SMBIOS_BDF_EXT_MAGIC "BDF_"
80 /* Default Airtime weight multiplier (Tuned for multiclient performance) */
81 #define ATH10K_AIRTIME_WEIGHT_MULTIPLIER 4
83 #define ATH10K_MAX_RETRY_COUNT 30
85 #define ATH10K_ITER_NORMAL_FLAGS (IEEE80211_IFACE_ITER_NORMAL | \
86 IEEE80211_IFACE_SKIP_SDATA_NOT_IN_DRIVER)
87 #define ATH10K_ITER_RESUME_FLAGS (IEEE80211_IFACE_ITER_RESUME_ALL |\
88 IEEE80211_IFACE_SKIP_SDATA_NOT_IN_DRIVER)
92 static inline const char *ath10k_bus_str(enum ath10k_bus bus)
103 case ATH10K_BUS_SNOC:
110 enum ath10k_skb_flags {
111 ATH10K_SKB_F_NO_HWCRYPT = BIT(0),
112 ATH10K_SKB_F_DTIM_ZERO = BIT(1),
113 ATH10K_SKB_F_DELIVER_CAB = BIT(2),
114 ATH10K_SKB_F_MGMT = BIT(3),
115 ATH10K_SKB_F_QOS = BIT(4),
116 ATH10K_SKB_F_RAW_TX = BIT(5),
117 ATH10K_SKB_F_NOACK_TID = BIT(6),
120 struct ath10k_skb_cb {
126 struct ieee80211_vif *vif;
127 struct ieee80211_txq *txq;
131 struct ath10k_skb_rxcb {
133 struct hlist_node hlist;
137 static inline struct ath10k_skb_cb *ATH10K_SKB_CB(struct sk_buff *skb)
139 BUILD_BUG_ON(sizeof(struct ath10k_skb_cb) >
140 IEEE80211_TX_INFO_DRIVER_DATA_SIZE);
141 return (struct ath10k_skb_cb *)&IEEE80211_SKB_CB(skb)->driver_data;
144 static inline struct ath10k_skb_rxcb *ATH10K_SKB_RXCB(struct sk_buff *skb)
146 BUILD_BUG_ON(sizeof(struct ath10k_skb_rxcb) > sizeof(skb->cb));
147 return (struct ath10k_skb_rxcb *)skb->cb;
150 #define ATH10K_RXCB_SKB(rxcb) \
151 container_of((void *)rxcb, struct sk_buff, cb)
153 static inline u32 host_interest_item_address(u32 item_offset)
155 return QCA988X_HOST_INTEREST_ADDRESS + item_offset;
158 enum ath10k_phy_mode {
159 ATH10K_PHY_MODE_LEGACY = 0,
160 ATH10K_PHY_MODE_HT = 1,
161 ATH10K_PHY_MODE_VHT = 2,
164 /* Data rate 100KBPS based on IE Index */
165 struct ath10k_index_ht_data_rate_type {
166 u8 beacon_rate_index;
167 u16 supported_rate[4];
170 /* Data rate 100KBPS based on IE Index */
171 struct ath10k_index_vht_data_rate_type {
172 u8 beacon_rate_index;
173 u16 supported_VHT80_rate[2];
174 u16 supported_VHT40_rate[2];
175 u16 supported_VHT20_rate[2];
182 struct ath10k_mem_chunk {
190 enum ath10k_htc_ep_id eid;
191 struct completion service_ready;
192 struct completion unified_ready;
193 struct completion barrier;
194 struct completion radar_confirm;
195 wait_queue_head_t tx_credits_wq;
196 DECLARE_BITMAP(svc_map, WMI_SERVICE_MAX);
197 struct wmi_cmd_map *cmd;
198 struct wmi_vdev_param_map *vdev_param;
199 struct wmi_pdev_param_map *pdev_param;
200 struct wmi_peer_param_map *peer_param;
201 const struct wmi_ops *ops;
202 const struct wmi_peer_flags_map *peer_flags;
204 u32 mgmt_max_num_pending_tx;
206 /* Protected by data_lock */
207 struct idr mgmt_pending_tx;
211 struct ath10k_mem_chunk mem_chunks[WMI_MAX_MEM_REQS];
214 struct ath10k_fw_stats_peer {
215 struct list_head list;
217 u8 peer_macaddr[ETH_ALEN];
220 u32 peer_rx_rate; /* 10x only */
224 struct ath10k_fw_extd_stats_peer {
225 struct list_head list;
227 u8 peer_macaddr[ETH_ALEN];
231 struct ath10k_fw_stats_vdev {
232 struct list_head list;
237 u32 num_tx_frames[4];
239 u32 num_tx_frames_retries[4];
240 u32 num_tx_frames_failures[4];
245 u32 num_tx_not_acked;
246 u32 tx_rate_history[10];
247 u32 beacon_rssi_history[10];
250 struct ath10k_fw_stats_vdev_extd {
251 struct list_head list;
257 u32 ppdu_nonaggr_cnt;
258 u32 mpdu_sw_requeued;
260 u32 mpdu_suc_multitry;
263 u32 tx_ftm_suc_retry;
268 u32 rx_iftmr_dup_cnt;
271 struct ath10k_fw_stats_pdev {
272 struct list_head list;
276 u32 tx_frame_count; /* Cycles spent transmitting frames */
277 u32 rx_frame_count; /* Cycles spent receiving frames */
278 u32 rx_clear_count; /* Total channel busy time, evidently */
279 u32 cycle_count; /* Total on-channel time */
306 u32 sw_retry_failure;
307 u32 illgl_rate_phy_err;
308 u32 pdev_cont_xretry;
314 u32 seq_failed_queueing;
321 u32 mpdus_ack_failed;
325 s32 mid_ppdu_route_change;
342 struct ath10k_fw_stats {
344 struct list_head pdevs;
345 struct list_head vdevs;
346 struct list_head peers;
347 struct list_head peers_extd;
350 #define ATH10K_TPC_TABLE_TYPE_FLAG 1
351 #define ATH10K_TPC_PREAM_TABLE_END 0xFFFF
353 struct ath10k_tpc_table {
354 u32 pream_idx[WMI_TPC_RATE_MAX];
355 u8 rate_code[WMI_TPC_RATE_MAX];
356 char tpc_value[WMI_TPC_RATE_MAX][WMI_TPC_TX_N_CHAIN * WMI_TPC_BUF_SIZE];
359 struct ath10k_tpc_stats {
363 u32 twice_antenna_reduction;
364 u32 twice_max_rd_power;
365 s32 twice_antenna_gain;
370 u8 flag[WMI_TPC_FLAG];
371 struct ath10k_tpc_table tpc_table[WMI_TPC_FLAG];
374 struct ath10k_tpc_table_final {
375 u32 pream_idx[WMI_TPC_FINAL_RATE_MAX];
376 u8 rate_code[WMI_TPC_FINAL_RATE_MAX];
377 char tpc_value[WMI_TPC_FINAL_RATE_MAX][WMI_TPC_TX_N_CHAIN * WMI_TPC_BUF_SIZE];
380 struct ath10k_tpc_stats_final {
384 u32 twice_antenna_reduction;
385 u32 twice_max_rd_power;
386 s32 twice_antenna_gain;
391 u8 flag[WMI_TPC_FLAG];
392 struct ath10k_tpc_table_final tpc_table_final[WMI_TPC_FLAG];
395 struct ath10k_dfs_stats {
399 u32 pulses_discarded;
403 enum ath10k_radar_confirmation_state {
404 ATH10K_RADAR_CONFIRMATION_IDLE = 0,
405 ATH10K_RADAR_CONFIRMATION_INPROGRESS,
406 ATH10K_RADAR_CONFIRMATION_STOPPED,
409 struct ath10k_radar_found_info {
418 #define ATH10K_MAX_NUM_PEER_IDS (1 << 11) /* htt rx_desc limit */
421 struct list_head list;
422 struct ieee80211_vif *vif;
423 struct ieee80211_sta *sta;
428 DECLARE_BITMAP(peer_ids, ATH10K_MAX_NUM_PEER_IDS);
430 /* protected by ar->data_lock */
431 struct ieee80211_key_conf *keys[WMI_MAX_KEY_INDEX + 1];
432 union htt_rx_pn_t tids_last_pn[ATH10K_TXRX_NUM_EXT_TIDS];
433 bool tids_last_pn_valid[ATH10K_TXRX_NUM_EXT_TIDS];
434 union htt_rx_pn_t frag_tids_last_pn[ATH10K_TXRX_NUM_EXT_TIDS];
435 u32 frag_tids_seq[ATH10K_TXRX_NUM_EXT_TIDS];
437 enum htt_security_types sec_type;
439 } rx_pn[ATH10K_HTT_TXRX_PEER_SECURITY_MAX];
443 struct list_head list;
444 unsigned long num_fw_queued;
445 unsigned long num_push_allowed;
448 enum ath10k_pkt_rx_err {
449 ATH10K_PKT_RX_ERR_FCS,
450 ATH10K_PKT_RX_ERR_TKIP,
451 ATH10K_PKT_RX_ERR_CRYPT,
452 ATH10K_PKT_RX_ERR_PEER_IDX_INVAL,
453 ATH10K_PKT_RX_ERR_MAX,
456 enum ath10k_ampdu_subfrm_num {
457 ATH10K_AMPDU_SUBFRM_NUM_10,
458 ATH10K_AMPDU_SUBFRM_NUM_20,
459 ATH10K_AMPDU_SUBFRM_NUM_30,
460 ATH10K_AMPDU_SUBFRM_NUM_40,
461 ATH10K_AMPDU_SUBFRM_NUM_50,
462 ATH10K_AMPDU_SUBFRM_NUM_60,
463 ATH10K_AMPDU_SUBFRM_NUM_MORE,
464 ATH10K_AMPDU_SUBFRM_NUM_MAX,
467 enum ath10k_amsdu_subfrm_num {
468 ATH10K_AMSDU_SUBFRM_NUM_1,
469 ATH10K_AMSDU_SUBFRM_NUM_2,
470 ATH10K_AMSDU_SUBFRM_NUM_3,
471 ATH10K_AMSDU_SUBFRM_NUM_4,
472 ATH10K_AMSDU_SUBFRM_NUM_MORE,
473 ATH10K_AMSDU_SUBFRM_NUM_MAX,
476 struct ath10k_sta_tid_stats {
477 unsigned long rx_pkt_from_fw;
478 unsigned long rx_pkt_unchained;
479 unsigned long rx_pkt_drop_chained;
480 unsigned long rx_pkt_drop_filter;
481 unsigned long rx_pkt_err[ATH10K_PKT_RX_ERR_MAX];
482 unsigned long rx_pkt_queued_for_mac;
483 unsigned long rx_pkt_ampdu[ATH10K_AMPDU_SUBFRM_NUM_MAX];
484 unsigned long rx_pkt_amsdu[ATH10K_AMSDU_SUBFRM_NUM_MAX];
487 enum ath10k_counter_type {
488 ATH10K_COUNTER_TYPE_BYTES,
489 ATH10K_COUNTER_TYPE_PKTS,
490 ATH10K_COUNTER_TYPE_MAX,
493 enum ath10k_stats_type {
494 ATH10K_STATS_TYPE_SUCC,
495 ATH10K_STATS_TYPE_FAIL,
496 ATH10K_STATS_TYPE_RETRY,
497 ATH10K_STATS_TYPE_AMPDU,
498 ATH10K_STATS_TYPE_MAX,
501 struct ath10k_htt_data_stats {
502 u64 legacy[ATH10K_COUNTER_TYPE_MAX][ATH10K_LEGACY_NUM];
503 u64 ht[ATH10K_COUNTER_TYPE_MAX][ATH10K_HT_MCS_NUM];
504 u64 vht[ATH10K_COUNTER_TYPE_MAX][ATH10K_VHT_MCS_NUM];
505 u64 bw[ATH10K_COUNTER_TYPE_MAX][ATH10K_BW_NUM];
506 u64 nss[ATH10K_COUNTER_TYPE_MAX][ATH10K_NSS_NUM];
507 u64 gi[ATH10K_COUNTER_TYPE_MAX][ATH10K_GI_NUM];
508 u64 rate_table[ATH10K_COUNTER_TYPE_MAX][ATH10K_RATE_TABLE_NUM];
511 struct ath10k_htt_tx_stats {
512 struct ath10k_htt_data_stats stats[ATH10K_STATS_TYPE_MAX];
518 #define ATH10K_TID_MAX 8
521 struct ath10k_vif *arvif;
523 /* the following are protected by ar->data_lock */
524 u32 changed; /* IEEE80211_RC_* */
529 struct rate_info txrate;
530 struct ieee80211_tx_info tx_info;
539 struct work_struct update_wk;
541 struct ath10k_htt_tx_stats *tx_stats;
544 #ifdef CONFIG_MAC80211_DEBUGFS
545 /* protected by conf_mutex */
548 /* Protected with ar->data_lock */
549 struct ath10k_sta_tid_stats tid_stats[IEEE80211_NUM_TIDS + 1];
551 /* Protected with ar->data_lock */
553 struct work_struct tid_config_wk;
554 int noack[ATH10K_TID_MAX];
555 int retry_long[ATH10K_TID_MAX];
556 int ampdu[ATH10K_TID_MAX];
557 u8 rate_ctrl[ATH10K_TID_MAX];
558 u32 rate_code[ATH10K_TID_MAX];
559 int rtscts[ATH10K_TID_MAX];
562 #define ATH10K_VDEV_SETUP_TIMEOUT_HZ (5 * HZ)
563 #define ATH10K_VDEV_DELETE_TIMEOUT_HZ (5 * HZ)
565 enum ath10k_beacon_state {
566 ATH10K_BEACON_SCHEDULED = 0,
567 ATH10K_BEACON_SENDING,
572 struct list_head list;
576 enum wmi_vdev_type vdev_type;
577 enum wmi_vdev_subtype vdev_subtype;
580 struct sk_buff *beacon;
581 /* protected by data_lock */
582 enum ath10k_beacon_state beacon_state;
584 dma_addr_t beacon_paddr;
585 unsigned long tx_paused; /* arbitrary values defined by target */
588 struct ieee80211_vif *vif;
592 bool spectral_enabled;
597 struct ieee80211_key_conf *wep_keys[WMI_MAX_KEY_INDEX + 1];
611 u8 ssid[IEEE80211_MAX_SSID_LEN] __nonstring;
613 /* P2P_IE with NoA attribute for P2P_GO case */
621 int num_legacy_stations;
624 struct wmi_wmm_params_all_arg wmm_params;
625 struct work_struct ap_csa_work;
626 struct delayed_work connection_loss_work;
627 struct cfg80211_bitrate_mask bitrate_mask;
629 /* For setting VHT peer fixed rate, protected by conf_mutex */
632 u32 tid_conf_changed[ATH10K_TID_MAX];
633 int noack[ATH10K_TID_MAX];
634 int retry_long[ATH10K_TID_MAX];
635 int ampdu[ATH10K_TID_MAX];
636 u8 rate_ctrl[ATH10K_TID_MAX];
637 u32 rate_code[ATH10K_TID_MAX];
638 int rtscts[ATH10K_TID_MAX];
642 struct ath10k_vif_iter {
644 struct ath10k_vif *arvif;
647 /* Copy Engine register dump, protected by ce-lock */
648 struct ath10k_ce_crash_data {
656 struct ath10k_ce_crash_hdr {
658 __le32 reserved[3]; /* for future use */
659 struct ath10k_ce_crash_data entries[];
662 #define MAX_MEM_DUMP_TYPE 5
664 /* used for crash-dump storage, protected by data-lock */
665 struct ath10k_fw_crash_data {
667 struct timespec64 timestamp;
668 __le32 registers[REG_DUMP_COUNT_QCA988X];
669 struct ath10k_ce_crash_data ce_crash_data[CE_COUNT_MAX];
672 size_t ramdump_buf_len;
675 struct ath10k_debug {
676 struct dentry *debugfs_phy;
678 struct ath10k_fw_stats fw_stats;
679 struct completion fw_stats_complete;
682 unsigned long htt_stats_mask;
683 unsigned long reset_htt_stats;
684 struct delayed_work htt_stats_dwork;
685 struct ath10k_dfs_stats dfs_stats;
686 struct ath_dfs_pool_stats dfs_pool_stats;
688 /* used for tpc-dump storage, protected by data-lock */
689 struct ath10k_tpc_stats *tpc_stats;
690 struct ath10k_tpc_stats_final *tpc_stats_final;
692 struct completion tpc_complete;
694 /* protected by conf_mutex */
700 u32 enable_extd_tx_stats;
705 ATH10K_STATE_OFF = 0,
708 /* When doing firmware recovery the device is first powered down.
709 * mac80211 is supposed to call in to start() hook later on. It is
710 * however possible that driver unloading and firmware crash overlap.
711 * mac80211 can wait on conf_mutex in stop() while the device is
712 * stopped in ath10k_core_restart() work holding conf_mutex. The state
713 * RESTARTED means that the device is up and mac80211 has started hw
714 * reconfiguration. Once mac80211 is done with the reconfiguration we
715 * set the state to STATE_ON in reconfig_complete().
717 ATH10K_STATE_RESTARTING,
718 ATH10K_STATE_RESTARTED,
720 /* The device has crashed while restarting hw. This state is like ON
721 * but commands are blocked in HTC and -ECOMM response is given. This
722 * prevents completion timeouts and makes the driver more responsive to
723 * userspace commands. This is also prevents recursive recovery.
731 enum ath10k_firmware_mode {
732 /* the default mode, standard 802.11 functionality */
733 ATH10K_FIRMWARE_MODE_NORMAL,
735 /* factory tests etc */
736 ATH10K_FIRMWARE_MODE_UTF,
739 enum ath10k_fw_features {
740 /* wmi_mgmt_rx_hdr contains extra RSSI information */
741 ATH10K_FW_FEATURE_EXT_WMI_MGMT_RX = 0,
743 /* Firmware from 10X branch. Deprecated, don't use in new code. */
744 ATH10K_FW_FEATURE_WMI_10X = 1,
746 /* firmware support tx frame management over WMI, otherwise it's HTT */
747 ATH10K_FW_FEATURE_HAS_WMI_MGMT_TX = 2,
749 /* Firmware does not support P2P */
750 ATH10K_FW_FEATURE_NO_P2P = 3,
752 /* Firmware 10.2 feature bit. The ATH10K_FW_FEATURE_WMI_10X feature
753 * bit is required to be set as well. Deprecated, don't use in new
756 ATH10K_FW_FEATURE_WMI_10_2 = 4,
758 /* Some firmware revisions lack proper multi-interface client powersave
759 * implementation. Enabling PS could result in connection drops,
760 * traffic stalls, etc.
762 ATH10K_FW_FEATURE_MULTI_VIF_PS_SUPPORT = 5,
764 /* Some firmware revisions have an incomplete WoWLAN implementation
765 * despite WMI service bit being advertised. This feature flag is used
766 * to distinguish whether WoWLAN is really supported or not.
768 ATH10K_FW_FEATURE_WOWLAN_SUPPORT = 6,
770 /* Don't trust error code from otp.bin */
771 ATH10K_FW_FEATURE_IGNORE_OTP_RESULT = 7,
773 /* Some firmware revisions pad 4th hw address to 4 byte boundary making
774 * it 8 bytes long in Native Wifi Rx decap.
776 ATH10K_FW_FEATURE_NO_NWIFI_DECAP_4ADDR_PADDING = 8,
778 /* Firmware supports bypassing PLL setting on init. */
779 ATH10K_FW_FEATURE_SUPPORTS_SKIP_CLOCK_INIT = 9,
781 /* Raw mode support. If supported, FW supports receiving and trasmitting
782 * frames in raw mode.
784 ATH10K_FW_FEATURE_RAW_MODE_SUPPORT = 10,
786 /* Firmware Supports Adaptive CCA*/
787 ATH10K_FW_FEATURE_SUPPORTS_ADAPTIVE_CCA = 11,
789 /* Firmware supports management frame protection */
790 ATH10K_FW_FEATURE_MFP_SUPPORT = 12,
792 /* Firmware supports pull-push model where host shares it's software
793 * queue state with firmware and firmware generates fetch requests
794 * telling host which queues to dequeue tx from.
796 * Primary function of this is improved MU-MIMO performance with
799 ATH10K_FW_FEATURE_PEER_FLOW_CONTROL = 13,
801 /* Firmware supports BT-Coex without reloading firmware via pdev param.
802 * To support Bluetooth coexistence pdev param, WMI_COEX_GPIO_SUPPORT of
803 * extended resource config should be enabled always. This firmware IE
804 * is used to configure WMI_COEX_GPIO_SUPPORT.
806 ATH10K_FW_FEATURE_BTCOEX_PARAM = 14,
808 /* Unused flag and proven to be not working, enable this if you want
809 * to experiment sending NULL func data frames in HTT TX
811 ATH10K_FW_FEATURE_SKIP_NULL_FUNC_WAR = 15,
813 /* Firmware allow other BSS mesh broadcast/multicast frames without
814 * creating monitor interface. Appropriate rxfilters are programmed for
815 * mesh vdev by firmware itself. This feature flags will be used for
816 * not creating monitor vdev while configuring mesh node.
818 ATH10K_FW_FEATURE_ALLOWS_MESH_BCAST = 16,
820 /* Firmware does not support power save in station mode. */
821 ATH10K_FW_FEATURE_NO_PS = 17,
823 /* Firmware allows management tx by reference instead of by value. */
824 ATH10K_FW_FEATURE_MGMT_TX_BY_REF = 18,
826 /* Firmware load is done externally, not by bmi */
827 ATH10K_FW_FEATURE_NON_BMI = 19,
829 /* Firmware sends only one chan_info event per channel */
830 ATH10K_FW_FEATURE_SINGLE_CHAN_INFO_PER_CHANNEL = 20,
832 /* Firmware allows setting peer fixed rate */
833 ATH10K_FW_FEATURE_PEER_FIXED_RATE = 21,
835 /* Firmware support IRAM recovery */
836 ATH10K_FW_FEATURE_IRAM_RECOVERY = 22,
839 ATH10K_FW_FEATURE_COUNT,
842 enum ath10k_dev_flags {
843 /* Indicates that ath10k device is during CAC phase of DFS */
845 ATH10K_FLAG_CORE_REGISTERED,
847 /* Device has crashed and needs to restart. This indicates any pending
848 * waiters should immediately cancel instead of waiting for a time out.
850 ATH10K_FLAG_CRASH_FLUSH,
852 /* Use Raw mode instead of native WiFi Tx/Rx encap mode.
853 * Raw mode supports both hardware and software crypto. Native WiFi only
854 * supports hardware crypto.
856 ATH10K_FLAG_RAW_MODE,
858 /* Disable HW crypto engine */
859 ATH10K_FLAG_HW_CRYPTO_DISABLED,
861 /* Bluetooth coexistence enabled */
864 /* Per Station statistics service */
865 ATH10K_FLAG_PEER_STATS,
867 /* Indicates that ath10k device is during recovery process and not complete */
868 ATH10K_FLAG_RESTARTING,
870 /* protected by conf_mutex */
871 ATH10K_FLAG_NAPI_ENABLED,
874 enum ath10k_cal_mode {
875 ATH10K_CAL_MODE_FILE,
878 ATH10K_CAL_MODE_NVMEM,
879 ATH10K_PRE_CAL_MODE_FILE,
880 ATH10K_PRE_CAL_MODE_DT,
881 ATH10K_PRE_CAL_MODE_NVMEM,
882 ATH10K_CAL_MODE_EEPROM,
885 enum ath10k_crypt_mode {
886 /* Only use hardware crypto engine */
887 ATH10K_CRYPT_MODE_HW,
888 /* Only use software crypto engine */
889 ATH10K_CRYPT_MODE_SW,
892 static inline const char *ath10k_cal_mode_str(enum ath10k_cal_mode mode)
895 case ATH10K_CAL_MODE_FILE:
897 case ATH10K_CAL_MODE_OTP:
899 case ATH10K_CAL_MODE_DT:
901 case ATH10K_CAL_MODE_NVMEM:
903 case ATH10K_PRE_CAL_MODE_FILE:
904 return "pre-cal-file";
905 case ATH10K_PRE_CAL_MODE_DT:
907 case ATH10K_PRE_CAL_MODE_NVMEM:
908 return "pre-cal-nvmem";
909 case ATH10K_CAL_MODE_EEPROM:
916 enum ath10k_scan_state {
918 ATH10K_SCAN_STARTING,
920 ATH10K_SCAN_ABORTING,
923 static inline const char *ath10k_scan_state_str(enum ath10k_scan_state state)
926 case ATH10K_SCAN_IDLE:
928 case ATH10K_SCAN_STARTING:
930 case ATH10K_SCAN_RUNNING:
932 case ATH10K_SCAN_ABORTING:
939 enum ath10k_tx_pause_reason {
940 ATH10K_TX_PAUSE_Q_FULL,
944 struct ath10k_fw_file {
945 const struct firmware *firmware;
947 char fw_version[ETHTOOL_FWVERS_LEN];
949 DECLARE_BITMAP(fw_features, ATH10K_FW_FEATURE_COUNT);
951 enum ath10k_fw_wmi_op_version wmi_op_version;
952 enum ath10k_fw_htt_op_version htt_op_version;
954 const void *firmware_data;
957 const void *otp_data;
960 const void *codeswap_data;
963 /* The original idea of struct ath10k_fw_file was that it only
964 * contains struct firmware and pointers to various parts (actual
965 * firmware binary, otp, metadata etc) of the file. This seg_info
966 * is actually created separate but as this is used similarly as
967 * the other firmware components it's more convenient to have it
970 struct ath10k_swap_code_seg_info *firmware_swap_code_seg_info;
973 struct ath10k_fw_components {
974 const struct firmware *board;
975 const void *board_data;
977 const struct firmware *ext_board;
978 const void *ext_board_data;
979 size_t ext_board_len;
981 struct ath10k_fw_file fw_file;
984 struct ath10k_per_peer_tx_stats {
999 enum ath10k_dev_type {
1004 struct ath10k_bus_params {
1006 enum ath10k_dev_type dev_type;
1007 bool link_can_suspend;
1012 struct ath_common ath_common;
1013 struct ieee80211_hw *hw;
1014 struct ieee80211_ops *ops;
1021 u8 mac_addr[ETH_ALEN];
1023 enum ath10k_hw_rev hw_rev;
1027 u8 fw_version_major;
1028 u32 fw_version_minor;
1029 u16 fw_version_release;
1030 u16 fw_version_build;
1031 u32 fw_stats_req_mask;
1033 u32 hw_min_tx_power;
1034 u32 hw_max_tx_power;
1040 u32 max_spatial_stream;
1041 /* protected by conf_mutex */
1049 /* protected by data_lock */
1052 /* protected by conf_mutex */
1059 enum ath10k_bus bus;
1060 const struct ath10k_hif_ops *ops;
1063 struct completion target_suspend;
1064 struct completion driver_recovery;
1066 const struct ath10k_hw_regs *regs;
1067 const struct ath10k_hw_ce_regs *hw_ce_regs;
1068 const struct ath10k_hw_values *hw_values;
1069 struct ath10k_bmi bmi;
1070 struct ath10k_wmi wmi;
1071 struct ath10k_htc htc;
1072 struct ath10k_htt htt;
1074 struct ath10k_hw_params hw_params;
1076 /* contains the firmware images used with ATH10K_FIRMWARE_MODE_NORMAL */
1077 struct ath10k_fw_components normal_mode_fw;
1079 /* READ-ONLY images of the running firmware, which can be either
1080 * normal or UTF. Do not modify, release etc!
1082 const struct ath10k_fw_components *running_fw;
1084 const struct firmware *pre_cal_file;
1085 const struct firmware *cal_file;
1090 u32 subsystem_vendor;
1091 u32 subsystem_device;
1100 bool ext_bid_supported;
1102 char bdf_ext[ATH10K_SMBIOS_BDF_EXT_STR_LENGTH];
1107 enum ath10k_cal_mode cal_mode;
1110 struct completion started;
1111 struct completion completed;
1112 struct completion on_channel;
1113 struct delayed_work timeout;
1114 enum ath10k_scan_state state;
1122 struct ieee80211_supported_band sbands[NUM_NL80211_BANDS];
1125 /* should never be NULL; needed for regular htt rx */
1126 struct ieee80211_channel *rx_channel;
1128 /* valid during scan; needed for mgmt rx during scan */
1129 struct ieee80211_channel *scan_channel;
1131 /* current operating channel definition */
1132 struct cfg80211_chan_def chandef;
1134 /* currently configured operating channel in firmware */
1135 struct ieee80211_channel *tgt_oper_chan;
1137 unsigned long long free_vdev_map;
1138 struct ath10k_vif *monitor_arvif;
1140 int monitor_vdev_id;
1141 bool monitor_started;
1142 unsigned int filter_flags;
1143 unsigned long dev_flags;
1144 bool dfs_block_radar_events;
1146 /* protected by conf_mutex */
1148 int num_started_vdevs;
1150 /* Protected by conf-mutex */
1151 u8 cfg_tx_chainmask;
1152 u8 cfg_rx_chainmask;
1154 struct completion install_key_done;
1156 int last_wmi_vdev_start_status;
1157 struct completion vdev_setup_done;
1158 struct completion vdev_delete_done;
1159 struct completion peer_stats_info_complete;
1161 struct workqueue_struct *workqueue;
1162 /* Auxiliary workqueue */
1163 struct workqueue_struct *workqueue_aux;
1164 struct workqueue_struct *workqueue_tx_complete;
1165 /* prevents concurrent FW reconfiguration */
1166 struct mutex conf_mutex;
1168 /* protects coredump data */
1169 struct mutex dump_mutex;
1171 /* protects shared structure data */
1172 spinlock_t data_lock;
1174 /* serialize wake_tx_queue calls per ac */
1175 spinlock_t queue_lock[IEEE80211_NUM_ACS];
1177 struct list_head arvifs;
1178 struct list_head peers;
1179 struct ath10k_peer *peer_map[ATH10K_MAX_NUM_PEER_IDS];
1180 wait_queue_head_t peer_mapping_wq;
1182 /* protected by conf_mutex */
1187 int max_num_stations;
1189 int max_num_tdls_vdevs;
1190 int num_active_peers;
1193 struct work_struct svc_rdy_work;
1194 struct sk_buff *svc_rdy_skb;
1196 struct work_struct offchan_tx_work;
1197 struct sk_buff_head offchan_tx_queue;
1198 struct completion offchan_tx_completed;
1199 struct sk_buff *offchan_tx_skb;
1201 struct work_struct wmi_mgmt_tx_work;
1202 struct sk_buff_head wmi_mgmt_tx_queue;
1204 enum ath10k_state state;
1206 struct work_struct register_work;
1207 struct work_struct restart_work;
1208 struct work_struct bundle_tx_work;
1209 struct work_struct tx_complete_work;
1211 /* cycle count is reported twice for each visited channel during scan.
1212 * access protected by data_lock
1214 u32 survey_last_rx_clear_count;
1215 u32 survey_last_cycle_count;
1216 struct survey_info survey[ATH10K_NUM_CHANS];
1218 /* Channel info events are expected to come in pairs without and with
1219 * COMPLETE flag set respectively for each channel visit during scan.
1221 * However there are deviations from this rule. This flag is used to
1222 * avoid reporting garbage data.
1224 bool ch_info_can_report_survey;
1225 struct completion bss_survey_done;
1227 struct dfs_pattern_detector *dfs_detector;
1229 unsigned long tx_paused; /* see ATH10K_TX_PAUSE_ */
1231 #ifdef CONFIG_ATH10K_DEBUGFS
1232 struct ath10k_debug debug;
1234 /* relay(fs) channel for spectral scan */
1235 struct rchan *rfs_chan_spec_scan;
1237 /* spectral_mode and spec_config are protected by conf_mutex */
1238 enum ath10k_spectral_mode mode;
1239 struct ath10k_spec_scan config;
1245 #ifdef CONFIG_DEV_COREDUMP
1247 struct ath10k_fw_crash_data *fw_crash_data;
1252 /* protected by conf_mutex */
1253 struct ath10k_fw_components utf_mode_fw;
1255 /* protected by data_lock */
1260 /* protected by data_lock */
1261 u32 rx_crc_err_drop;
1262 u32 fw_crash_counter;
1263 u32 fw_warm_reset_counter;
1264 u32 fw_cold_reset_counter;
1267 struct ath10k_thermal thermal;
1268 struct ath10k_wow wow;
1269 struct ath10k_per_peer_tx_stats peer_tx_stats;
1272 struct net_device napi_dev;
1273 struct napi_struct napi;
1275 struct work_struct set_coverage_class_work;
1276 /* protected by conf_mutex */
1278 /* writing also protected by data_lock */
1282 u32 reg_slottime_conf;
1283 u32 reg_slottime_orig;
1284 u32 reg_ack_cts_timeout_conf;
1285 u32 reg_ack_cts_timeout_orig;
1288 u32 ampdu_reference;
1290 const u8 *wmi_key_cipher;
1293 u32 sta_tid_stats_mask;
1295 /* protected by data_lock */
1296 enum ath10k_radar_confirmation_state radar_conf_state;
1297 struct ath10k_radar_found_info last_radar_info;
1298 struct work_struct radar_confirmation_work;
1299 struct ath10k_bus_params bus_param;
1300 struct completion peer_delete_done;
1305 s32 tx_power_2g_limit;
1306 s32 tx_power_5g_limit;
1309 u8 drv_priv[] __aligned(sizeof(void *));
1312 static inline bool ath10k_peer_stats_enabled(struct ath10k *ar)
1314 if (test_bit(ATH10K_FLAG_PEER_STATS, &ar->dev_flags) &&
1315 test_bit(WMI_SERVICE_PEER_STATS, ar->wmi.svc_map))
1321 extern unsigned int ath10k_frame_mode;
1322 extern unsigned long ath10k_coredump_mask;
1324 void ath10k_core_napi_sync_disable(struct ath10k *ar);
1325 void ath10k_core_napi_enable(struct ath10k *ar);
1326 struct ath10k *ath10k_core_create(size_t priv_size, struct device *dev,
1327 enum ath10k_bus bus,
1328 enum ath10k_hw_rev hw_rev,
1329 const struct ath10k_hif_ops *hif_ops);
1330 void ath10k_core_destroy(struct ath10k *ar);
1331 void ath10k_core_get_fw_features_str(struct ath10k *ar,
1334 int ath10k_core_fetch_firmware_api_n(struct ath10k *ar, const char *name,
1335 struct ath10k_fw_file *fw_file);
1337 int ath10k_core_start(struct ath10k *ar, enum ath10k_firmware_mode mode,
1338 const struct ath10k_fw_components *fw_components);
1339 int ath10k_wait_for_suspend(struct ath10k *ar, u32 suspend_opt);
1340 void ath10k_core_stop(struct ath10k *ar);
1341 void ath10k_core_start_recovery(struct ath10k *ar);
1342 int ath10k_core_register(struct ath10k *ar,
1343 const struct ath10k_bus_params *bus_params);
1344 void ath10k_core_unregister(struct ath10k *ar);
1345 int ath10k_core_fetch_board_file(struct ath10k *ar, int bd_ie_type);
1346 int ath10k_core_check_dt(struct ath10k *ar);
1347 void ath10k_core_free_board_files(struct ath10k *ar);
1349 #endif /* _CORE_H_ */