drivers/net/wireless/ath/ath11k/ce.h

   1 /* SPDX-License-Identifier: BSD-3-Clause-Clear */
   2 /*
   3  * Copyright (c) 2018-2019 The Linux Foundation. All rights reserved.
   4  */
   5
   6 #ifndef ATH11K_CE_H
   7 #define ATH11K_CE_H
   8
   9 #define CE_COUNT_MAX 12
  10
  11 /* Byte swap data words */
  12 #define CE_ATTR_BYTE_SWAP_DATA 2
  13
  14 /* no interrupt on copy completion */
  15 #define CE_ATTR_DIS_INTR                8
  16
  17 /* Host software's Copy Engine configuration. */
  18 #ifdef __BIG_ENDIAN
  19 #define CE_ATTR_FLAGS CE_ATTR_BYTE_SWAP_DATA
  20 #else
  21 #define CE_ATTR_FLAGS 0
  22 #endif
  23
  24 /* Threshold to poll for tx completion in case of Interrupt disabled CE's */
  25 #define ATH11K_CE_USAGE_THRESHOLD 32
  26
  27 void ath11k_ce_byte_swap(void *mem, u32 len);
  28
  29 /*
  30  * Directions for interconnect pipe configuration.
  31  * These definitions may be used during configuration and are shared
  32  * between Host and Target.
  33  *
  34  * Pipe Directions are relative to the Host, so PIPEDIR_IN means
  35  * "coming IN over air through Target to Host" as with a WiFi Rx operation.
  36  * Conversely, PIPEDIR_OUT means "going OUT from Host through Target over air"
  37  * as with a WiFi Tx operation. This is somewhat awkward for the "middle-man"
  38  * Target since things that are "PIPEDIR_OUT" are coming IN to the Target
  39  * over the interconnect.
  40  */
  41 #define PIPEDIR_NONE            0
  42 #define PIPEDIR_IN              1 /* Target-->Host, WiFi Rx direction */
  43 #define PIPEDIR_OUT             2 /* Host->Target, WiFi Tx direction */
  44 #define PIPEDIR_INOUT           3 /* bidirectional */
  45 #define PIPEDIR_INOUT_H2H       4 /* bidirectional, host to host */
  46
  47 /* CE address/mask */
  48 #define CE_HOST_IE_ADDRESS      0x00A1803C
  49 #define CE_HOST_IE_2_ADDRESS    0x00A18040
  50 #define CE_HOST_IE_3_ADDRESS    CE_HOST_IE_ADDRESS
  51
  52 #define CE_HOST_IE_3_SHIFT      0xC
  53
  54 #define CE_RING_IDX_INCR(nentries_mask, idx) (((idx) + 1) & (nentries_mask))
  55
  56 #define ATH11K_CE_RX_POST_RETRY_JIFFIES 50
  57
  58 struct ath11k_base;
  59
  60 /*
  61  * Establish a mapping between a service/direction and a pipe.
  62  * Configuration information for a Copy Engine pipe and services.
  63  * Passed from Host to Target through QMI message and must be in
  64  * little endian format.
  65  */
  66 struct service_to_pipe {
  67         __le32 service_id;
  68         __le32 pipedir;
  69         __le32 pipenum;
  70 };
  71
  72 /*
  73  * Configuration information for a Copy Engine pipe.
  74  * Passed from Host to Target through QMI message during startup (one per CE).
  75  *
  76  * NOTE: Structure is shared between Host software and Target firmware!
  77  */
  78 struct ce_pipe_config {
  79         __le32 pipenum;
  80         __le32 pipedir;
  81         __le32 nentries;
  82         __le32 nbytes_max;
  83         __le32 flags;
  84         __le32 reserved;
  85 };
  86
  87 struct ce_attr {
  88         /* CE_ATTR_* values */
  89         unsigned int flags;
  90
  91         /* #entries in source ring - Must be a power of 2 */
  92         unsigned int src_nentries;
  93
  94         /*
  95          * Max source send size for this CE.
  96          * This is also the minimum size of a destination buffer.
  97          */
  98         unsigned int src_sz_max;
  99
 100         /* #entries in destination ring - Must be a power of 2 */
 101         unsigned int dest_nentries;
 102
 103         void (*recv_cb)(struct ath11k_base *, struct sk_buff *);
 104         void (*send_cb)(struct ath11k_base *, struct sk_buff *);
 105 };
 106
 107 #define CE_DESC_RING_ALIGN 8
 108
 109 struct ath11k_ce_ring {
 110         /* Number of entries in this ring; must be power of 2 */
 111         unsigned int nentries;
 112         unsigned int nentries_mask;
 113
 114         /* For dest ring, this is the next index to be processed
 115          * by software after it was/is received into.
 116          *
 117          * For src ring, this is the last descriptor that was sent
 118          * and completion processed by software.
 119          *
 120          * Regardless of src or dest ring, this is an invariant
 121          * (modulo ring size):
 122          *     write index >= read index >= sw_index
 123          */
 124         unsigned int sw_index;
 125         /* cached copy */
 126         unsigned int write_index;
 127
 128         /* Start of DMA-coherent area reserved for descriptors */
 129         /* Host address space */
 130         void *base_addr_owner_space_unaligned;
 131         /* CE address space */
 132         u32 base_addr_ce_space_unaligned;
 133
 134         /* Actual start of descriptors.
 135          * Aligned to descriptor-size boundary.
 136          * Points into reserved DMA-coherent area, above.
 137          */
 138         /* Host address space */
 139         void *base_addr_owner_space;
 140
 141         /* CE address space */
 142         u32 base_addr_ce_space;
 143
 144         /* HAL ring id */
 145         u32 hal_ring_id;
 146
 147         /* keep last */
 148         struct sk_buff *skb[];
 149 };
 150
 151 struct ath11k_ce_pipe {
 152         struct ath11k_base *ab;
 153         u16 pipe_num;
 154         unsigned int attr_flags;
 155         unsigned int buf_sz;
 156         unsigned int rx_buf_needed;
 157
 158         void (*send_cb)(struct ath11k_base *, struct sk_buff *);
 159         void (*recv_cb)(struct ath11k_base *, struct sk_buff *);
 160
 161         struct tasklet_struct intr_tq;
 162         struct ath11k_ce_ring *src_ring;
 163         struct ath11k_ce_ring *dest_ring;
 164         struct ath11k_ce_ring *status_ring;
 165         u64 timestamp;
 166 };
 167
 168 struct ath11k_ce {
 169         struct ath11k_ce_pipe ce_pipe[CE_COUNT_MAX];
 170         /* Protects rings of all ce pipes */
 171         spinlock_t ce_lock;
 172         struct ath11k_hp_update_timer hp_timer[CE_COUNT_MAX];
 173 };
 174
 175 extern const struct ce_attr ath11k_host_ce_config_ipq8074[];
 176 extern const struct ce_attr ath11k_host_ce_config_qca6390[];
 177 extern const struct ce_attr ath11k_host_ce_config_qcn9074[];
 178
 179 void ath11k_ce_cleanup_pipes(struct ath11k_base *ab);
 180 void ath11k_ce_rx_replenish_retry(struct timer_list *t);
 181 void ath11k_ce_per_engine_service(struct ath11k_base *ab, u16 ce_id);
 182 int ath11k_ce_send(struct ath11k_base *ab, struct sk_buff *skb, u8 pipe_id,
 183                    u16 transfer_id);
 184 void ath11k_ce_rx_post_buf(struct ath11k_base *ab);
 185 int ath11k_ce_init_pipes(struct ath11k_base *ab);
 186 int ath11k_ce_alloc_pipes(struct ath11k_base *ab);
 187 void ath11k_ce_free_pipes(struct ath11k_base *ab);
 188 int ath11k_ce_get_attr_flags(struct ath11k_base *ab, int ce_id);
 189 void ath11k_ce_poll_send_completed(struct ath11k_base *ab, u8 pipe_id);
 190 int ath11k_ce_map_service_to_pipe(struct ath11k_base *ab, u16 service_id,
 191                                   u8 *ul_pipe, u8 *dl_pipe);
 192 int ath11k_ce_attr_attach(struct ath11k_base *ab);
 193 void ath11k_ce_get_shadow_config(struct ath11k_base *ab,
 194                                  u32 **shadow_cfg, u32 *shadow_cfg_len);
 195 void ath11k_ce_stop_shadow_timers(struct ath11k_base *ab);
 196
 197 #endif