xref: /OK3568_Linux_fs/kernel/drivers/net/wireless/ath/ath11k/dbring.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /* SPDX-License-Identifier: BSD-3-Clause-Clear */
2*4882a593Smuzhiyun /*
3*4882a593Smuzhiyun  * Copyright (c) 2019-2020 The Linux Foundation. All rights reserved.
4*4882a593Smuzhiyun  */
5*4882a593Smuzhiyun 
6*4882a593Smuzhiyun #ifndef ATH11K_DBRING_H
7*4882a593Smuzhiyun #define ATH11K_DBRING_H
8*4882a593Smuzhiyun 
9*4882a593Smuzhiyun #include <linux/types.h>
10*4882a593Smuzhiyun #include <linux/idr.h>
11*4882a593Smuzhiyun #include <linux/spinlock.h>
12*4882a593Smuzhiyun #include "dp.h"
13*4882a593Smuzhiyun 
14*4882a593Smuzhiyun struct ath11k_dbring_element {
15*4882a593Smuzhiyun 	dma_addr_t paddr;
16*4882a593Smuzhiyun 	u8 payload[0];
17*4882a593Smuzhiyun };
18*4882a593Smuzhiyun 
19*4882a593Smuzhiyun struct ath11k_dbring_data {
20*4882a593Smuzhiyun 	void *data;
21*4882a593Smuzhiyun 	u32 data_sz;
22*4882a593Smuzhiyun 	struct wmi_dma_buf_release_meta_data meta;
23*4882a593Smuzhiyun };
24*4882a593Smuzhiyun 
25*4882a593Smuzhiyun struct ath11k_dbring_buf_release_event {
26*4882a593Smuzhiyun 	struct ath11k_wmi_dma_buf_release_fixed_param fixed;
27*4882a593Smuzhiyun 	struct wmi_dma_buf_release_entry *buf_entry;
28*4882a593Smuzhiyun 	struct wmi_dma_buf_release_meta_data *meta_data;
29*4882a593Smuzhiyun 	u32 num_buf_entry;
30*4882a593Smuzhiyun 	u32 num_meta;
31*4882a593Smuzhiyun };
32*4882a593Smuzhiyun 
33*4882a593Smuzhiyun struct ath11k_dbring_cap {
34*4882a593Smuzhiyun 	u32 pdev_id;
35*4882a593Smuzhiyun 	enum wmi_direct_buffer_module id;
36*4882a593Smuzhiyun 	u32 min_elem;
37*4882a593Smuzhiyun 	u32 min_buf_sz;
38*4882a593Smuzhiyun 	u32 min_buf_align;
39*4882a593Smuzhiyun };
40*4882a593Smuzhiyun 
41*4882a593Smuzhiyun struct ath11k_dbring {
42*4882a593Smuzhiyun 	struct dp_srng refill_srng;
43*4882a593Smuzhiyun 	struct idr bufs_idr;
44*4882a593Smuzhiyun 	/* Protects bufs_idr */
45*4882a593Smuzhiyun 	spinlock_t idr_lock;
46*4882a593Smuzhiyun 	dma_addr_t tp_addr;
47*4882a593Smuzhiyun 	dma_addr_t hp_addr;
48*4882a593Smuzhiyun 	int bufs_max;
49*4882a593Smuzhiyun 	u32 pdev_id;
50*4882a593Smuzhiyun 	u32 buf_sz;
51*4882a593Smuzhiyun 	u32 buf_align;
52*4882a593Smuzhiyun 	u32 num_resp_per_event;
53*4882a593Smuzhiyun 	u32 event_timeout_ms;
54*4882a593Smuzhiyun 	int (*handler)(struct ath11k *, struct ath11k_dbring_data *);
55*4882a593Smuzhiyun };
56*4882a593Smuzhiyun 
57*4882a593Smuzhiyun int ath11k_dbring_set_cfg(struct ath11k *ar,
58*4882a593Smuzhiyun 			  struct ath11k_dbring *ring,
59*4882a593Smuzhiyun 			  u32 num_resp_per_event,
60*4882a593Smuzhiyun 			  u32 event_timeout_ms,
61*4882a593Smuzhiyun 			  int (*handler)(struct ath11k *,
62*4882a593Smuzhiyun 					 struct ath11k_dbring_data *));
63*4882a593Smuzhiyun int ath11k_dbring_wmi_cfg_setup(struct ath11k *ar,
64*4882a593Smuzhiyun 				struct ath11k_dbring *ring,
65*4882a593Smuzhiyun 				enum wmi_direct_buffer_module id);
66*4882a593Smuzhiyun int ath11k_dbring_buf_setup(struct ath11k *ar,
67*4882a593Smuzhiyun 			    struct ath11k_dbring *ring,
68*4882a593Smuzhiyun 			    struct ath11k_dbring_cap *db_cap);
69*4882a593Smuzhiyun int ath11k_dbring_srng_setup(struct ath11k *ar, struct ath11k_dbring *ring,
70*4882a593Smuzhiyun 			     int ring_num, int num_entries);
71*4882a593Smuzhiyun int ath11k_dbring_buffer_release_event(struct ath11k_base *ab,
72*4882a593Smuzhiyun 				       struct ath11k_dbring_buf_release_event *ev);
73*4882a593Smuzhiyun int ath11k_dbring_get_cap(struct ath11k_base *ab,
74*4882a593Smuzhiyun 			  u8 pdev_idx,
75*4882a593Smuzhiyun 			  enum wmi_direct_buffer_module id,
76*4882a593Smuzhiyun 			  struct ath11k_dbring_cap *db_cap);
77*4882a593Smuzhiyun void ath11k_dbring_srng_cleanup(struct ath11k *ar, struct ath11k_dbring *ring);
78*4882a593Smuzhiyun void ath11k_dbring_buf_cleanup(struct ath11k *ar, struct ath11k_dbring *ring);
79*4882a593Smuzhiyun #endif /* ATH11K_DBRING_H */
80