ath10k: document cycle count related counters

They are not necessarily named in an intuitive manner,
so at least add some comments to help the next person.

Signed-off-by: Ben Greear <greearb@candelatech.com>
Signed-off-by: Kalle Valo <kvalo@qca.qualcomm.com>

diff --git a/drivers/net/wireless/ath/ath10k/core.h b/drivers/net/wireless/ath/ath10k/core.h
index 6ec9495..dda49af 100644 (file)
--- a/drivers/net/wireless/ath/ath10k/core.h
+++ b/drivers/net/wireless/ath/ath10k/core.h
@@ -201,10 +201,10 @@ struct ath10k_fw_stats_pdev {
 
        /* PDEV stats */
        s32 ch_noise_floor;
-       u32 tx_frame_count;
-       u32 rx_frame_count;
-       u32 rx_clear_count;
-       u32 cycle_count;
+       u32 tx_frame_count; /* Cycles spent transmitting frames */
+       u32 rx_frame_count; /* Cycles spent receiving frames */
+       u32 rx_clear_count; /* Total channel busy time, evidently */
+       u32 cycle_count; /* Total on-channel time */
        u32 phy_err_count;
        u32 chan_tx_power;
        u32 ack_rx_bad;

diff --git a/drivers/net/wireless/ath/ath10k/wmi.h b/drivers/net/wireless/ath/ath10k/wmi.h
index 6a68817..1b243c8 100644 (file)
--- a/drivers/net/wireless/ath/ath10k/wmi.h
+++ b/drivers/net/wireless/ath/ath10k/wmi.h
@@ -4222,10 +4222,10 @@ struct wmi_10_2_stats_event {
  */
 struct wmi_pdev_stats_base {
        __le32 chan_nf;
-       __le32 tx_frame_count;
-       __le32 rx_frame_count;
-       __le32 rx_clear_count;
-       __le32 cycle_count;
+       __le32 tx_frame_count; /* Cycles spent transmitting frames */
+       __le32 rx_frame_count; /* Cycles spent receiving frames */
+       __le32 rx_clear_count; /* Total channel busy time, evidently */
+       __le32 cycle_count; /* Total on-channel time */
        __le32 phy_err_count;
        __le32 chan_tx_pwr;
 } __packed;