root/drivers/net/wireless/ath/ath11k/debugfs.h
/* SPDX-License-Identifier: BSD-3-Clause-Clear */
/*
 * Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.
 * Copyright (c) 2021-2022, 2025 Qualcomm Innovation Center, Inc. All rights reserved.
 */

#ifndef _ATH11K_DEBUGFS_H_
#define _ATH11K_DEBUGFS_H_

#include "hal_tx.h"

#define ATH11K_TX_POWER_MAX_VAL 70
#define ATH11K_TX_POWER_MIN_VAL 0

/* htt_dbg_ext_stats_type */
enum ath11k_dbg_htt_ext_stats_type {
        ATH11K_DBG_HTT_EXT_STATS_RESET                      =  0,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_TX                    =  1,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_RX                    =  2,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_TX_HWQ                =  3,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_TX_SCHED              =  4,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_ERROR                 =  5,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_TQM                   =  6,
        ATH11K_DBG_HTT_EXT_STATS_TQM_CMDQ                   =  7,
        ATH11K_DBG_HTT_EXT_STATS_TX_DE_INFO                 =  8,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_TX_RATE               =  9,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_RX_RATE               =  10,
        ATH11K_DBG_HTT_EXT_STATS_PEER_INFO                  =  11,
        ATH11K_DBG_HTT_EXT_STATS_TX_SELFGEN_INFO            =  12,
        ATH11K_DBG_HTT_EXT_STATS_TX_MU_HWQ                  =  13,
        ATH11K_DBG_HTT_EXT_STATS_RING_IF_INFO               =  14,
        ATH11K_DBG_HTT_EXT_STATS_SRNG_INFO                  =  15,
        ATH11K_DBG_HTT_EXT_STATS_SFM_INFO                   =  16,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_TX_MU                 =  17,
        ATH11K_DBG_HTT_EXT_STATS_ACTIVE_PEERS_LIST          =  18,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_CCA_STATS             =  19,
        ATH11K_DBG_HTT_EXT_STATS_TWT_SESSIONS               =  20,
        ATH11K_DBG_HTT_EXT_STATS_REO_RESOURCE_STATS         =  21,
        ATH11K_DBG_HTT_EXT_STATS_TX_SOUNDING_INFO           =  22,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_OBSS_PD_STATS         =  23,
        ATH11K_DBG_HTT_EXT_STATS_RING_BACKPRESSURE_STATS    =  24,
        ATH11K_DBG_HTT_EXT_STATS_PEER_CTRL_PATH_TXRX_STATS  =  29,
        ATH11K_DBG_HTT_EXT_STATS_PDEV_TX_RATE_TXBF_STATS    =  31,
        ATH11K_DBG_HTT_EXT_STATS_TXBF_OFDMA                 =  32,
        ATH11K_DBG_HTT_EXT_PHY_COUNTERS_AND_PHY_STATS       =  37,

        /* keep this last */
        ATH11K_DBG_HTT_NUM_EXT_STATS,
};

#define ATH11K_DEBUG_DBR_ENTRIES_MAX 512

enum ath11k_dbg_dbr_event {
        ATH11K_DBG_DBR_EVENT_INVALID,
        ATH11K_DBG_DBR_EVENT_RX,
        ATH11K_DBG_DBR_EVENT_REPLENISH,
        ATH11K_DBG_DBR_EVENT_MAX,
};

struct ath11k_dbg_dbr_entry {
        u32 hp;
        u32 tp;
        u64 timestamp;
        enum ath11k_dbg_dbr_event event;
};

struct ath11k_dbg_dbr_data {
        /* protects ath11k_db_ring_debug data */
        spinlock_t lock;
        struct ath11k_dbg_dbr_entry *entries;
        u32 dbr_debug_idx;
        u32 num_ring_debug_entries;
};

struct ath11k_debug_dbr {
        struct ath11k_dbg_dbr_data dbr_dbg_data;
        struct dentry *dbr_debugfs;
        bool dbr_debug_enabled;
};

struct debug_htt_stats_req {
        bool done;
        u8 pdev_id;
        u8 type;
        u8 peer_addr[ETH_ALEN];
        struct completion cmpln;
        u32 buf_len;
        u8 buf[];
};

struct ath_pktlog_hdr {
        u16 flags;
        u16 missed_cnt;
        u16 log_type;
        u16 size;
        u32 timestamp;
        u32 type_specific_data;
        u8 payload[];
};

#define ATH11K_HTT_PEER_STATS_RESET BIT(16)

#define ATH11K_HTT_STATS_BUF_SIZE (1024 * 512)
#define ATH11K_FW_STATS_BUF_SIZE (1024 * 1024)

enum ath11k_pktlog_filter {
        ATH11K_PKTLOG_RX                = 0x000000001,
        ATH11K_PKTLOG_TX                = 0x000000002,
        ATH11K_PKTLOG_RCFIND            = 0x000000004,
        ATH11K_PKTLOG_RCUPDATE          = 0x000000008,
        ATH11K_PKTLOG_EVENT_SMART_ANT   = 0x000000020,
        ATH11K_PKTLOG_EVENT_SW          = 0x000000040,
        ATH11K_PKTLOG_ANY               = 0x00000006f,
};

enum ath11k_pktlog_mode {
        ATH11K_PKTLOG_MODE_LITE = 1,
        ATH11K_PKTLOG_MODE_FULL = 2,
};

enum ath11k_pktlog_enum {
        ATH11K_PKTLOG_TYPE_INVALID      = 0,
        ATH11K_PKTLOG_TYPE_TX_CTRL      = 1,
        ATH11K_PKTLOG_TYPE_TX_STAT      = 2,
        ATH11K_PKTLOG_TYPE_TX_MSDU_ID   = 3,
        ATH11K_PKTLOG_TYPE_RX_STAT      = 5,
        ATH11K_PKTLOG_TYPE_RC_FIND      = 6,
        ATH11K_PKTLOG_TYPE_RC_UPDATE    = 7,
        ATH11K_PKTLOG_TYPE_TX_VIRT_ADDR = 8,
        ATH11K_PKTLOG_TYPE_RX_CBF       = 10,
        ATH11K_PKTLOG_TYPE_RX_STATBUF   = 22,
        ATH11K_PKTLOG_TYPE_PPDU_STATS   = 23,
        ATH11K_PKTLOG_TYPE_LITE_RX      = 24,
};

enum ath11k_dbg_aggr_mode {
        ATH11K_DBG_AGGR_MODE_AUTO,
        ATH11K_DBG_AGGR_MODE_MANUAL,
        ATH11K_DBG_AGGR_MODE_MAX,
};

enum fw_dbglog_wlan_module_id {
        WLAN_MODULE_ID_MIN = 0,
        WLAN_MODULE_INF = WLAN_MODULE_ID_MIN,
        WLAN_MODULE_WMI,
        WLAN_MODULE_STA_PWRSAVE,
        WLAN_MODULE_WHAL,
        WLAN_MODULE_COEX,
        WLAN_MODULE_ROAM,
        WLAN_MODULE_RESMGR_CHAN_MANAGER,
        WLAN_MODULE_RESMGR,
        WLAN_MODULE_VDEV_MGR,
        WLAN_MODULE_SCAN,
        WLAN_MODULE_RATECTRL,
        WLAN_MODULE_AP_PWRSAVE,
        WLAN_MODULE_BLOCKACK,
        WLAN_MODULE_MGMT_TXRX,
        WLAN_MODULE_DATA_TXRX,
        WLAN_MODULE_HTT,
        WLAN_MODULE_HOST,
        WLAN_MODULE_BEACON,
        WLAN_MODULE_OFFLOAD,
        WLAN_MODULE_WAL,
        WLAN_WAL_MODULE_DE,
        WLAN_MODULE_PCIELP,
        WLAN_MODULE_RTT,
        WLAN_MODULE_RESOURCE,
        WLAN_MODULE_DCS,
        WLAN_MODULE_CACHEMGR,
        WLAN_MODULE_ANI,
        WLAN_MODULE_P2P,
        WLAN_MODULE_CSA,
        WLAN_MODULE_NLO,
        WLAN_MODULE_CHATTER,
        WLAN_MODULE_WOW,
        WLAN_MODULE_WAL_VDEV,
        WLAN_MODULE_WAL_PDEV,
        WLAN_MODULE_TEST,
        WLAN_MODULE_STA_SMPS,
        WLAN_MODULE_SWBMISS,
        WLAN_MODULE_WMMAC,
        WLAN_MODULE_TDLS,
        WLAN_MODULE_HB,
        WLAN_MODULE_TXBF,
        WLAN_MODULE_BATCH_SCAN,
        WLAN_MODULE_THERMAL_MGR,
        WLAN_MODULE_PHYERR_DFS,
        WLAN_MODULE_RMC,
        WLAN_MODULE_STATS,
        WLAN_MODULE_NAN,
        WLAN_MODULE_IBSS_PWRSAVE,
        WLAN_MODULE_HIF_UART,
        WLAN_MODULE_LPI,
        WLAN_MODULE_EXTSCAN,
        WLAN_MODULE_UNIT_TEST,
        WLAN_MODULE_MLME,
        WLAN_MODULE_SUPPL,
        WLAN_MODULE_ERE,
        WLAN_MODULE_OCB,
        WLAN_MODULE_RSSI_MONITOR,
        WLAN_MODULE_WPM,
        WLAN_MODULE_CSS,
        WLAN_MODULE_PPS,
        WLAN_MODULE_SCAN_CH_PREDICT,
        WLAN_MODULE_MAWC,
        WLAN_MODULE_CMC_QMIC,
        WLAN_MODULE_EGAP,
        WLAN_MODULE_NAN20,
        WLAN_MODULE_QBOOST,
        WLAN_MODULE_P2P_LISTEN_OFFLOAD,
        WLAN_MODULE_HALPHY,
        WLAN_WAL_MODULE_ENQ,
        WLAN_MODULE_GNSS,
        WLAN_MODULE_WAL_MEM,
        WLAN_MODULE_SCHED_ALGO,
        WLAN_MODULE_TX,
        WLAN_MODULE_RX,
        WLAN_MODULE_WLM,
        WLAN_MODULE_RU_ALLOCATOR,
        WLAN_MODULE_11K_OFFLOAD,
        WLAN_MODULE_STA_TWT,
        WLAN_MODULE_AP_TWT,
        WLAN_MODULE_UL_OFDMA,
        WLAN_MODULE_HPCS_PULSE,
        WLAN_MODULE_DTF,
        WLAN_MODULE_QUIET_IE,
        WLAN_MODULE_SHMEM_MGR,
        WLAN_MODULE_CFIR,
        WLAN_MODULE_CODE_COVER,
        WLAN_MODULE_SHO,
        WLAN_MODULE_MLO_MGR,
        WLAN_MODULE_PEER_INIT,
        WLAN_MODULE_STA_MLO_PS,

        WLAN_MODULE_ID_MAX,
        WLAN_MODULE_ID_INVALID = WLAN_MODULE_ID_MAX,
};

enum fw_dbglog_log_level {
        ATH11K_FW_DBGLOG_ML = 0,
        ATH11K_FW_DBGLOG_VERBOSE = 0,
        ATH11K_FW_DBGLOG_INFO,
        ATH11K_FW_DBGLOG_INFO_LVL_1,
        ATH11K_FW_DBGLOG_INFO_LVL_2,
        ATH11K_FW_DBGLOG_WARN,
        ATH11K_FW_DBGLOG_ERR,
        ATH11K_FW_DBGLOG_LVL_MAX
};

struct ath11k_fw_dbglog {
        enum wmi_debug_log_param param;
        union {
                struct {
                        /* log_level values are given in enum fw_dbglog_log_level */
                        u16 log_level;
                        /* module_id values are given in  enum fw_dbglog_wlan_module_id */
                        u16 module_id;
                };
                /* value is either log_level&module_id/vdev_id/vdev_id_bitmap/log_level
                 * according to param
                 */
                u32 value;
        };
};

#ifdef CONFIG_ATH11K_DEBUGFS
int ath11k_debugfs_soc_create(struct ath11k_base *ab);
void ath11k_debugfs_soc_destroy(struct ath11k_base *ab);
int ath11k_debugfs_pdev_create(struct ath11k_base *ab);
void ath11k_debugfs_pdev_destroy(struct ath11k_base *ab);
int ath11k_debugfs_register(struct ath11k *ar);
void ath11k_debugfs_unregister(struct ath11k *ar);
void ath11k_debugfs_fw_stats_process(struct ath11k *ar, struct ath11k_fw_stats *stats);

void ath11k_debugfs_fw_stats_init(struct ath11k *ar);

static inline bool ath11k_debugfs_is_pktlog_lite_mode_enabled(struct ath11k *ar)
{
        return (ar->debug.pktlog_mode == ATH11K_PKTLOG_MODE_LITE);
}

static inline bool ath11k_debugfs_is_pktlog_rx_stats_enabled(struct ath11k *ar)
{
        return (!ar->debug.pktlog_peer_valid && ar->debug.pktlog_mode);
}

static inline bool ath11k_debugfs_is_pktlog_peer_valid(struct ath11k *ar, u8 *addr)
{
        return (ar->debug.pktlog_peer_valid && ar->debug.pktlog_mode &&
                ether_addr_equal(addr, ar->debug.pktlog_peer_addr));
}

static inline int ath11k_debugfs_is_extd_tx_stats_enabled(struct ath11k *ar)
{
        return ar->debug.extd_tx_stats;
}

static inline int ath11k_debugfs_is_extd_rx_stats_enabled(struct ath11k *ar)
{
        return ar->debug.extd_rx_stats;
}

static inline int ath11k_debugfs_rx_filter(struct ath11k *ar)
{
        return ar->debug.rx_filter;
}

void ath11k_debugfs_op_vif_add(struct ieee80211_hw *hw,
                               struct ieee80211_vif *vif);
void ath11k_debugfs_add_dbring_entry(struct ath11k *ar,
                                     enum wmi_direct_buffer_module id,
                                     enum ath11k_dbg_dbr_event event,
                                     struct hal_srng *srng);

#else
static inline int ath11k_debugfs_soc_create(struct ath11k_base *ab)
{
        return 0;
}

static inline void ath11k_debugfs_soc_destroy(struct ath11k_base *ab)
{
}

static inline int ath11k_debugfs_pdev_create(struct ath11k_base *ab)
{
        return 0;
}

static inline void ath11k_debugfs_pdev_destroy(struct ath11k_base *ab)
{
}

static inline int ath11k_debugfs_register(struct ath11k *ar)
{
        return 0;
}

static inline void ath11k_debugfs_unregister(struct ath11k *ar)
{
}

static inline void ath11k_debugfs_fw_stats_process(struct ath11k *ar,
                                                   struct ath11k_fw_stats *stats)
{
}

static inline void ath11k_debugfs_fw_stats_init(struct ath11k *ar)
{
}

static inline int ath11k_debugfs_is_extd_tx_stats_enabled(struct ath11k *ar)
{
        return 0;
}

static inline int ath11k_debugfs_is_extd_rx_stats_enabled(struct ath11k *ar)
{
        return 0;
}

static inline bool ath11k_debugfs_is_pktlog_lite_mode_enabled(struct ath11k *ar)
{
        return false;
}

static inline bool ath11k_debugfs_is_pktlog_rx_stats_enabled(struct ath11k *ar)
{
        return false;
}

static inline bool ath11k_debugfs_is_pktlog_peer_valid(struct ath11k *ar, u8 *addr)
{
        return false;
}

static inline int ath11k_debugfs_rx_filter(struct ath11k *ar)
{
        return 0;
}

static inline void
ath11k_debugfs_add_dbring_entry(struct ath11k *ar,
                                enum wmi_direct_buffer_module id,
                                enum ath11k_dbg_dbr_event event,
                                struct hal_srng *srng)
{
}
#endif /* CONFIG_ATH11K_DEBUGFS*/

#endif /* _ATH11K_DEBUGFS_H_ */