1 /* SPDX-License-Identifier: GPL-2.0-only */
3 * aQuantia Corporation Network Driver
4 * Copyright (C) 2014-2019 aQuantia Corporation. All rights reserved
7 /* File aq_ring.h: Declaration of functions for Rx/Tx rings. */
12 #include "aq_common.h"
25 * +----------+----------+----------+-----------
26 * 8bytes|len l3,l4 | pa | pa | pa
27 * +----------+----------+----------+-----------
28 * 4/8bytes|len pkt |len pkt | | skb
29 * +----------+----------+----------+-----------
30 * 4/8bytes|is_gso |len,flags |len |len,is_eop
31 * +----------+----------+----------+-----------
33 * This aq_ring_buff_s doesn't have endianness dependency.
34 * It is __packed for cache line optimizations.
36 struct __packed aq_ring_buff_s {
46 struct aq_rxpage rxdata;
90 struct aq_ring_stats_rx_s {
101 struct aq_ring_stats_tx_s {
108 union aq_ring_stats_s {
109 struct aq_ring_stats_rx_s rx;
110 struct aq_ring_stats_tx_s tx;
119 struct aq_ring_buff_s *buff_ring;
120 u8 *dx_ring; /* descriptors ring, dma shared mem */
121 struct aq_nic_s *aq_nic;
122 unsigned int idx; /* for HW layer registers operations */
123 unsigned int hw_head;
124 unsigned int sw_head;
125 unsigned int sw_tail;
126 unsigned int size; /* descriptors number */
127 unsigned int dx_size; /* TX or RX descriptor size, */
128 /* stored here for fater math */
129 unsigned int page_order;
130 union aq_ring_stats_s stats;
131 dma_addr_t dx_ring_pa;
132 enum atl_ring_type ring_type;
135 struct aq_ring_param_s {
136 unsigned int vec_idx;
138 cpumask_t affinity_mask;
141 static inline void *aq_buf_vaddr(struct aq_rxpage *rxpage)
143 return page_to_virt(rxpage->page) + rxpage->pg_off;
146 static inline dma_addr_t aq_buf_daddr(struct aq_rxpage *rxpage)
148 return rxpage->daddr + rxpage->pg_off;
151 static inline unsigned int aq_ring_next_dx(struct aq_ring_s *self,
154 return (++dx >= self->size) ? 0U : dx;
157 static inline unsigned int aq_ring_avail_dx(struct aq_ring_s *self)
159 return (((self->sw_tail >= self->sw_head)) ?
160 (self->size - 1) - self->sw_tail + self->sw_head :
161 self->sw_head - self->sw_tail - 1);
164 struct aq_ring_s *aq_ring_tx_alloc(struct aq_ring_s *self,
165 struct aq_nic_s *aq_nic,
167 struct aq_nic_cfg_s *aq_nic_cfg);
168 struct aq_ring_s *aq_ring_rx_alloc(struct aq_ring_s *self,
169 struct aq_nic_s *aq_nic,
171 struct aq_nic_cfg_s *aq_nic_cfg);
172 int aq_ring_init(struct aq_ring_s *self, const enum atl_ring_type ring_type);
173 void aq_ring_rx_deinit(struct aq_ring_s *self);
174 void aq_ring_free(struct aq_ring_s *self);
175 void aq_ring_update_queue_state(struct aq_ring_s *ring);
176 void aq_ring_queue_wake(struct aq_ring_s *ring);
177 void aq_ring_queue_stop(struct aq_ring_s *ring);
178 bool aq_ring_tx_clean(struct aq_ring_s *self);
179 int aq_ring_rx_clean(struct aq_ring_s *self,
180 struct napi_struct *napi,
183 int aq_ring_rx_fill(struct aq_ring_s *self);
185 struct aq_ring_s *aq_ring_hwts_rx_alloc(struct aq_ring_s *self,
186 struct aq_nic_s *aq_nic, unsigned int idx,
187 unsigned int size, unsigned int dx_size);
188 void aq_ring_hwts_rx_clean(struct aq_ring_s *self, struct aq_nic_s *aq_nic);
190 unsigned int aq_ring_fill_stats_data(struct aq_ring_s *self, u64 *data);
192 #endif /* AQ_RING_H */