162306a36Sopenharmony_ci/* SPDX-License-Identifier: BSD-3-Clause-Clear */
262306a36Sopenharmony_ci/*
362306a36Sopenharmony_ci * Copyright (c) 2019-2021 The Linux Foundation. All rights reserved.
462306a36Sopenharmony_ci * Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. All rights reserved.
562306a36Sopenharmony_ci */
662306a36Sopenharmony_ci
762306a36Sopenharmony_ci#ifndef ATH12K_DBRING_H
862306a36Sopenharmony_ci#define ATH12K_DBRING_H
962306a36Sopenharmony_ci
1062306a36Sopenharmony_ci#include <linux/types.h>
1162306a36Sopenharmony_ci#include <linux/idr.h>
1262306a36Sopenharmony_ci#include <linux/spinlock.h>
1362306a36Sopenharmony_ci#include "dp.h"
1462306a36Sopenharmony_ci
1562306a36Sopenharmony_cistruct ath12k_dbring_element {
1662306a36Sopenharmony_ci	dma_addr_t paddr;
1762306a36Sopenharmony_ci	u8 payload[];
1862306a36Sopenharmony_ci};
1962306a36Sopenharmony_ci
2062306a36Sopenharmony_cistruct ath12k_dbring_data {
2162306a36Sopenharmony_ci	void *data;
2262306a36Sopenharmony_ci	u32 data_sz;
2362306a36Sopenharmony_ci	struct ath12k_wmi_dma_buf_release_meta_data_params meta;
2462306a36Sopenharmony_ci};
2562306a36Sopenharmony_ci
2662306a36Sopenharmony_cistruct ath12k_dbring_buf_release_event {
2762306a36Sopenharmony_ci	struct ath12k_wmi_dma_buf_release_fixed_params fixed;
2862306a36Sopenharmony_ci	const struct ath12k_wmi_dma_buf_release_entry_params *buf_entry;
2962306a36Sopenharmony_ci	const struct ath12k_wmi_dma_buf_release_meta_data_params *meta_data;
3062306a36Sopenharmony_ci	u32 num_buf_entry;
3162306a36Sopenharmony_ci	u32 num_meta;
3262306a36Sopenharmony_ci};
3362306a36Sopenharmony_ci
3462306a36Sopenharmony_cistruct ath12k_dbring_cap {
3562306a36Sopenharmony_ci	u32 pdev_id;
3662306a36Sopenharmony_ci	enum wmi_direct_buffer_module id;
3762306a36Sopenharmony_ci	u32 min_elem;
3862306a36Sopenharmony_ci	u32 min_buf_sz;
3962306a36Sopenharmony_ci	u32 min_buf_align;
4062306a36Sopenharmony_ci};
4162306a36Sopenharmony_ci
4262306a36Sopenharmony_cistruct ath12k_dbring {
4362306a36Sopenharmony_ci	struct dp_srng refill_srng;
4462306a36Sopenharmony_ci	struct idr bufs_idr;
4562306a36Sopenharmony_ci	/* Protects bufs_idr */
4662306a36Sopenharmony_ci	spinlock_t idr_lock;
4762306a36Sopenharmony_ci	dma_addr_t tp_addr;
4862306a36Sopenharmony_ci	dma_addr_t hp_addr;
4962306a36Sopenharmony_ci	int bufs_max;
5062306a36Sopenharmony_ci	u32 pdev_id;
5162306a36Sopenharmony_ci	u32 buf_sz;
5262306a36Sopenharmony_ci	u32 buf_align;
5362306a36Sopenharmony_ci	u32 num_resp_per_event;
5462306a36Sopenharmony_ci	u32 event_timeout_ms;
5562306a36Sopenharmony_ci	int (*handler)(struct ath12k *ar, struct ath12k_dbring_data *data);
5662306a36Sopenharmony_ci};
5762306a36Sopenharmony_ci
5862306a36Sopenharmony_ciint ath12k_dbring_set_cfg(struct ath12k *ar,
5962306a36Sopenharmony_ci			  struct ath12k_dbring *ring,
6062306a36Sopenharmony_ci			  u32 num_resp_per_event,
6162306a36Sopenharmony_ci			  u32 event_timeout_ms,
6262306a36Sopenharmony_ci			  int (*handler)(struct ath12k *,
6362306a36Sopenharmony_ci					 struct ath12k_dbring_data *));
6462306a36Sopenharmony_ciint ath12k_dbring_wmi_cfg_setup(struct ath12k *ar,
6562306a36Sopenharmony_ci				struct ath12k_dbring *ring,
6662306a36Sopenharmony_ci				enum wmi_direct_buffer_module id);
6762306a36Sopenharmony_ciint ath12k_dbring_buf_setup(struct ath12k *ar,
6862306a36Sopenharmony_ci			    struct ath12k_dbring *ring,
6962306a36Sopenharmony_ci			    struct ath12k_dbring_cap *db_cap);
7062306a36Sopenharmony_ciint ath12k_dbring_srng_setup(struct ath12k *ar, struct ath12k_dbring *ring,
7162306a36Sopenharmony_ci			     int ring_num, int num_entries);
7262306a36Sopenharmony_ciint ath12k_dbring_buffer_release_event(struct ath12k_base *ab,
7362306a36Sopenharmony_ci				       struct ath12k_dbring_buf_release_event *ev);
7462306a36Sopenharmony_ciint ath12k_dbring_get_cap(struct ath12k_base *ab,
7562306a36Sopenharmony_ci			  u8 pdev_idx,
7662306a36Sopenharmony_ci			  enum wmi_direct_buffer_module id,
7762306a36Sopenharmony_ci			  struct ath12k_dbring_cap *db_cap);
7862306a36Sopenharmony_civoid ath12k_dbring_srng_cleanup(struct ath12k *ar, struct ath12k_dbring *ring);
7962306a36Sopenharmony_civoid ath12k_dbring_buf_cleanup(struct ath12k *ar, struct ath12k_dbring *ring);
8062306a36Sopenharmony_ci#endif /* ATH12K_DBRING_H */
81