2 * aQuantia Corporation Network Driver
3 * Copyright (C) 2014-2017 aQuantia Corporation. All rights reserved
5 * This program is free software; you can redistribute it and/or modify it
6 * under the terms and conditions of the GNU General Public License,
7 * version 2, as published by the Free Software Foundation.
10 /* File aq_ring.h: Declaration of functions for Rx/Tx rings. */
15 #include "aq_common.h"
20 * +----------+----------+----------+-----------
21 * 8bytes|len l3,l4 | pa | pa | pa
22 * +----------+----------+----------+-----------
23 * 4/8bytes|len pkt |len pkt | | skb
24 * +----------+----------+----------+-----------
25 * 4/8bytes|is_txc |len,flags |len |len,is_eop
26 * +----------+----------+----------+-----------
28 * This aq_ring_buff_s doesn't have endianness dependency.
29 * It is __packed for cache line optimizations.
31 struct __packed aq_ring_buff_s {
85 struct aq_ring_stats_rx_s {
93 struct aq_ring_stats_tx_s {
99 union aq_ring_stats_s {
100 struct aq_ring_stats_rx_s rx;
101 struct aq_ring_stats_tx_s tx;
105 struct aq_obj_s header;
106 struct aq_ring_buff_s *buff_ring;
107 u8 *dx_ring; /* descriptors ring, dma shared mem */
108 struct aq_nic_s *aq_nic;
109 unsigned int idx; /* for HW layer registers operations */
110 unsigned int hw_head;
111 unsigned int sw_head;
112 unsigned int sw_tail;
113 unsigned int size; /* descriptors number */
114 unsigned int dx_size; /* TX or RX descriptor size, */
115 /* stored here for fater math */
116 union aq_ring_stats_s stats;
117 dma_addr_t dx_ring_pa;
120 struct aq_ring_param_s {
121 unsigned int vec_idx;
123 cpumask_t affinity_mask;
126 static inline unsigned int aq_ring_next_dx(struct aq_ring_s *self,
129 return (++dx >= self->size) ? 0U : dx;
132 static inline unsigned int aq_ring_avail_dx(struct aq_ring_s *self)
134 return (((self->sw_tail >= self->sw_head)) ?
135 (self->size - 1) - self->sw_tail + self->sw_head :
136 self->sw_head - self->sw_tail - 1);
139 struct aq_ring_s *aq_ring_tx_alloc(struct aq_ring_s *self,
140 struct aq_nic_s *aq_nic,
142 struct aq_nic_cfg_s *aq_nic_cfg);
143 struct aq_ring_s *aq_ring_rx_alloc(struct aq_ring_s *self,
144 struct aq_nic_s *aq_nic,
146 struct aq_nic_cfg_s *aq_nic_cfg);
147 int aq_ring_init(struct aq_ring_s *self);
148 void aq_ring_rx_deinit(struct aq_ring_s *self);
149 void aq_ring_free(struct aq_ring_s *self);
150 void aq_ring_tx_clean(struct aq_ring_s *self);
151 int aq_ring_rx_clean(struct aq_ring_s *self,
152 struct napi_struct *napi,
155 int aq_ring_rx_fill(struct aq_ring_s *self);
157 #endif /* AQ_RING_H */