drivers/net/wireless/ath/ath12k/dbring.h

   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 */