1 /* SPDX-License-Identifier: BSD-3-Clause-Clear */ 2 /* 3 * Copyright (c) 2019-2021 The Linux Foundation. All rights reserved. 4 * Copyright (c) 2021-2022 Qualcomm Innovation Center, Inc. All rights reserved. 5 */ 6 7 #ifndef ATH12K_DBRING_H 8 #define ATH12K_DBRING_H 9 10 #include <linux/types.h> 11 #include <linux/idr.h> 12 #include <linux/spinlock.h> 13 #include "dp.h" 14 15 struct ath12k_dbring_element { 16 dma_addr_t paddr; 17 u8 payload[]; 18 }; 19 20 struct ath12k_dbring_data { 21 void *data; 22 u32 data_sz; 23 struct ath12k_wmi_dma_buf_release_meta_data_params meta; 24 }; 25 26 struct ath12k_dbring_buf_release_event { 27 struct ath12k_wmi_dma_buf_release_fixed_params fixed; 28 const struct ath12k_wmi_dma_buf_release_entry_params *buf_entry; 29 const struct ath12k_wmi_dma_buf_release_meta_data_params *meta_data; 30 u32 num_buf_entry; 31 u32 num_meta; 32 }; 33 34 struct ath12k_dbring_cap { 35 u32 pdev_id; 36 enum wmi_direct_buffer_module id; 37 u32 min_elem; 38 u32 min_buf_sz; 39 u32 min_buf_align; 40 }; 41 42 struct ath12k_dbring { 43 struct dp_srng refill_srng; 44 struct idr bufs_idr; 45 /* Protects bufs_idr */ 46 spinlock_t idr_lock; 47 dma_addr_t tp_addr; 48 dma_addr_t hp_addr; 49 int bufs_max; 50 u32 pdev_id; 51 u32 buf_sz; 52 u32 buf_align; 53 u32 num_resp_per_event; 54 u32 event_timeout_ms; 55 int (*handler)(struct ath12k *ar, struct ath12k_dbring_data *data); 56 }; 57 58 int ath12k_dbring_set_cfg(struct ath12k *ar, 59 struct ath12k_dbring *ring, 60 u32 num_resp_per_event, 61 u32 event_timeout_ms, 62 int (*handler)(struct ath12k *, 63 struct ath12k_dbring_data *)); 64 int ath12k_dbring_wmi_cfg_setup(struct ath12k *ar, 65 struct ath12k_dbring *ring, 66 enum wmi_direct_buffer_module id); 67 int ath12k_dbring_buf_setup(struct ath12k *ar, 68 struct ath12k_dbring *ring, 69 struct ath12k_dbring_cap *db_cap); 70 int ath12k_dbring_srng_setup(struct ath12k *ar, struct ath12k_dbring *ring, 71 int ring_num, int num_entries); 72 int ath12k_dbring_buffer_release_event(struct ath12k_base *ab, 73 struct ath12k_dbring_buf_release_event *ev); 74 int ath12k_dbring_get_cap(struct ath12k_base *ab, 75 u8 pdev_idx, 76 enum wmi_direct_buffer_module id, 77 struct ath12k_dbring_cap *db_cap); 78 void ath12k_dbring_srng_cleanup(struct ath12k *ar, struct ath12k_dbring *ring); 79 void ath12k_dbring_buf_cleanup(struct ath12k *ar, struct ath12k_dbring *ring); 80 #endif /* ATH12K_DBRING_H */ 81