[PATCH ath-next 3/8] wifi: ath12k: add TCL ring TX buffer allocation failure counter

[Jeff Johnson]

On 7/23/2026 5:54 AM, Pardeep Kaur wrote:
> From: Hariharan Ramanathan <hariharan.ramanathan at oss.qualcomm.com>
> 
> When ath12k_dp_tx_assign_buffer() fails, the TX path returns -ENOMEM
> silently with no per-ring visibility into how often this occurs.
> Without a counter, buffer pool exhaustion on a specific TCL ring is
> invisible during debugging.
> 
> Add txbuf_na[] to ath12k_device_dp_tx_err_stats to track per-ring TX
> buffer allocation failures and increment it on assign failure in the
> TX path. Expose the per-ring counts in debugfs under a new 'TCL Ring
> Buffer Alloc Failures' section.

Is this counting the right thing?

One of my review agents has the observation:
The txbuf_na counter is indexed by ring_id but the exhaustion it measures is
from tx_desc[pool_id]

So I drilled down with another agent and got:
The commit message intent is to answer "why was this frame dropped", which is
valid. The practical question is whether ring_id or pool_id is more useful for
diagnosis:
  - pool_id = skb_get_queue_mapping(skb) & 3 — a property of the traffic
class/queue
  - ring_id = smp_processor_id() % max_tx_ring — a property of which CPU
processed it

If a pool is exhausted, pool_id tells you which traffic class is
backpressured. ring_id tells you which CPU happened to observe it — less
actionable. So the other finding is a genuine semantic improvement, not just
pedantry. The fix (txbuf_na[pool_id]++) would make the stat correctly answer
"which traffic class ran out of TX descriptors."

So does tracking by ring_id or pool_id make the most sense?

> 
> Tested-on: QCN9274 hw2.0 PCI WLAN.WBE.1.6.r1-00402-QCAHKSWPL_SILICONZ-1
> 
> Signed-off-by: Hariharan Ramanathan <hariharan.ramanathan at oss.qualcomm.com>
> Co-developed-by: Pardeep Kaur <pardeep.kaur at oss.qualcomm.com>
> Signed-off-by: Pardeep Kaur <pardeep.kaur at oss.qualcomm.com>
> ---
>  drivers/net/wireless/ath/ath12k/debugfs.c     | 5 +++++
>  drivers/net/wireless/ath/ath12k/dp.h          | 2 ++
>  drivers/net/wireless/ath/ath12k/wifi7/dp_tx.c | 4 +++-
>  3 files changed, 10 insertions(+), 1 deletion(-)
> 
> diff --git a/drivers/net/wireless/ath/ath12k/debugfs.c b/drivers/net/wireless/ath/ath12k/debugfs.c
> index d54995b7adb2..0f8b458200a8 100644
> --- a/drivers/net/wireless/ath/ath12k/debugfs.c
> +++ b/drivers/net/wireless/ath/ath12k/debugfs.c
> @@ -1117,6 +1117,11 @@ static ssize_t ath12k_debugfs_dump_device_dp_stats(struct file *file,
>  		len += scnprintf(buf + len, size - len, "ring%d: %u\n",
>  				 i, device_stats->tx_err.desc_na[i]);
>  
> +	len += scnprintf(buf + len, size - len, "\nTCL Ring Buffer Alloc Failures:\n");
> +	for (i = 0; i < DP_TCL_NUM_RING_MAX; i++)
> +		len += scnprintf(buf + len, size - len, "ring%d: %u\n",
> +				 i, device_stats->tx_err.txbuf_na[i]);
> +
>  	len += scnprintf(buf + len, size - len,
>  			 "\nMisc Transmit Failures: %d\n",
>  			 atomic_read(&device_stats->tx_err.misc_fail));
> diff --git a/drivers/net/wireless/ath/ath12k/dp.h b/drivers/net/wireless/ath/ath12k/dp.h
> index a94bbc337df4..ac125adde258 100644
> --- a/drivers/net/wireless/ath/ath12k/dp.h
> +++ b/drivers/net/wireless/ath/ath12k/dp.h
> @@ -428,6 +428,8 @@ struct ath12k_dp_arch_ops {
>  struct ath12k_device_dp_tx_err_stats {
>  	/* TCL Ring Descriptor unavailable */
>  	u32 desc_na[DP_TCL_NUM_RING_MAX];
> +	/* TCL Ring Buffers unavailable */
> +	u32 txbuf_na[DP_TCL_NUM_RING_MAX];
>  	/* Other failures during dp_tx due to mem allocation failure
>  	 * idr unavailable etc.
>  	 */
> diff --git a/drivers/net/wireless/ath/ath12k/wifi7/dp_tx.c b/drivers/net/wireless/ath/ath12k/wifi7/dp_tx.c
> index a0e409452a19..ca0e1369af21 100644
> --- a/drivers/net/wireless/ath/ath12k/wifi7/dp_tx.c
> +++ b/drivers/net/wireless/ath/ath12k/wifi7/dp_tx.c
> @@ -123,8 +123,10 @@ int ath12k_wifi7_dp_tx(struct ath12k_pdev_dp *dp_pdev, struct ath12k_link_vif *a
>  	tx_ring = &dp->tx_ring[ti.ring_id];
>  
>  	tx_desc = ath12k_dp_tx_assign_buffer(dp, pool_id);
> -	if (!tx_desc)
> +	if (!tx_desc) {
> +		dp->device_stats.tx_err.txbuf_na[ti.ring_id]++;
>  		return -ENOMEM;
> +	}
>  
>  	dp_link_vif = ath12k_dp_vif_to_dp_link_vif(&ahvif->dp_vif, arvif->link_id);
>