1  /*
2   * Copyright (c) 2013-2018 The Linux Foundation. All rights reserved.
3   * Copyright (c) 2022-2023 Qualcomm Innovation Center, Inc. All rights reserved.
4   *
5   * Permission to use, copy, modify, and/or distribute this software for
6   * any purpose with or without fee is hereby granted, provided that the
7   * above copyright notice and this permission notice appear in all
8   * copies.
9   *
10   * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
11   * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
12   * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
13   * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
14   * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
15   * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
16   * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
17   * PERFORMANCE OF THIS SOFTWARE.
18   */
19  
20  /**
21   * DOC: wlan_hdd_debugfs_llstat.h
22   *
23   * WLAN Host Device Driver implementation to update
24   * debugfs with Link Layer statistics
25   */
26  
27  #ifndef _WLAN_HDD_DEBUGFS_LLSTAT_H
28  #define _WLAN_HDD_DEBUGFS_LLSTAT_H
29  
30  #include <wlan_hdd_main.h>
31  
32  #if defined(WLAN_FEATURE_11BE_MLO) && defined(CFG80211_11BE_BASIC)
33  #define DEBUGFS_LLSTATS_BUF_SIZE 32768
34  #else
35  #define DEBUGFS_LLSTATS_BUF_SIZE 16384
36  #endif
37  
38  #define DEBUGFS_LLSTATS_REQID   4294967295UL
39  #define DEBUGFS_LLSTATS_REQMASK 0x7
40  
41  #if defined(WLAN_FEATURE_LINK_LAYER_STATS) && defined(WLAN_DEBUGFS)
42  /**
43   * hdd_debugfs_process_peer_stats() - Parse Peer stats and add it to buffer
44   * @adapter: Pointer to device adapter
45   * @data: Pointer to stats data
46   *
47   * Receiving Link Layer peer statistics from FW. This function stores the
48   * firmware data in a buffer to be written into debugfs.
49   *
50   * Return: None
51   */
52  void hdd_debugfs_process_peer_stats(struct hdd_adapter *adapter, void *data);
53  
54  /**
55   * hdd_debugfs_process_radio_stats() - Parse Radio stats and add it to buffer
56   * @adapter: Pointer to device adapter
57   * @more_data: More data
58   * @data: Pointer to stats data
59   * @num_radio: Number of radios
60   *
61   * Receiving Link Layer Radio statistics from FW. This function stores the
62   * firmware data in a buffer to be written into debugfs.
63   *
64   * Return: None
65   */
66  void hdd_debugfs_process_radio_stats(struct hdd_adapter *adapter,
67  		uint32_t more_data, void *data, uint32_t num_radio);
68  
69  /**
70   * hdd_debugfs_process_iface_stats() - This function is called after
71   * @link_info: Link info pointer in HDD adapter
72   * @data: Pointer to stats data
73   * @num_peers: Number of peers
74   *
75   * Receiving Link Layer Interface statistics from FW.This function converts
76   * the firmware data to the NL data and sends the same to the kernel/upper
77   * layers.
78   *
79   * Return: None
80   */
81  void hdd_debugfs_process_iface_stats(struct wlan_hdd_link_info *link_info,
82  				     void *data, uint32_t num_peers);
83  
84  /**
85   * wlan_hdd_create_ll_stats_file() - API to create Link Layer stats file
86   * @adapter: interface adapter pointer
87   *
88   * Return: 0 on success and errno on failure
89   */
90  int wlan_hdd_create_ll_stats_file(struct hdd_adapter *adapter);
91  #else
hdd_debugfs_process_peer_stats(struct hdd_adapter * adapter,void * data)92  static inline void hdd_debugfs_process_peer_stats(struct hdd_adapter *adapter,
93  						  void *data)
94  {
95  }
96  
hdd_debugfs_process_radio_stats(struct hdd_adapter * adapter,uint32_t more_data,void * data,uint32_t num_radio)97  static inline void hdd_debugfs_process_radio_stats(
98  			struct hdd_adapter *adapter,
99  			uint32_t more_data, void *data, uint32_t num_radio)
100  {
101  }
102  
103  static inline void
hdd_debugfs_process_iface_stats(struct wlan_hdd_link_info * link_info,void * data,uint32_t num_peers)104  hdd_debugfs_process_iface_stats(struct wlan_hdd_link_info *link_info,
105  				void *data, uint32_t num_peers)
106  {
107  }
108  
wlan_hdd_create_ll_stats_file(struct hdd_adapter * adapter)109  static inline int wlan_hdd_create_ll_stats_file(struct hdd_adapter *adapter)
110  {
111  	return 0;
112  }
113  #endif
114  #endif /* #ifndef _WLAN_HDD_DEBUGFS_LLSTAT_H */
115