1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3 * Definitions for Xilinx Axi Ethernet device driver.
4 *
5 * Copyright (c) 2009 Secret Lab Technologies, Ltd.
6 * Copyright (c) 2010 - 2012 Xilinx, Inc. All rights reserved.
7 */
8
9 #ifndef XILINX_AXIENET_H
10 #define XILINX_AXIENET_H
11
12 #include <linux/netdevice.h>
13 #include <linux/spinlock.h>
14 #include <linux/interrupt.h>
15 #include <linux/if_vlan.h>
16 #include <linux/phylink.h>
17
18 /* Packet size info */
19 #define XAE_HDR_SIZE 14 /* Size of Ethernet header */
20 #define XAE_TRL_SIZE 4 /* Size of Ethernet trailer (FCS) */
21 #define XAE_MTU 1500 /* Max MTU of an Ethernet frame */
22 #define XAE_JUMBO_MTU 9000 /* Max MTU of a jumbo Eth. frame */
23
24 #define XAE_MAX_FRAME_SIZE (XAE_MTU + XAE_HDR_SIZE + XAE_TRL_SIZE)
25 #define XAE_MAX_VLAN_FRAME_SIZE (XAE_MTU + VLAN_ETH_HLEN + XAE_TRL_SIZE)
26 #define XAE_MAX_JUMBO_FRAME_SIZE (XAE_JUMBO_MTU + XAE_HDR_SIZE + XAE_TRL_SIZE)
27
28 /* Configuration options */
29
30 /* Accept all incoming packets. Default: disabled (cleared) */
31 #define XAE_OPTION_PROMISC (1 << 0)
32
33 /* Jumbo frame support for Tx & Rx. Default: disabled (cleared) */
34 #define XAE_OPTION_JUMBO (1 << 1)
35
36 /* VLAN Rx & Tx frame support. Default: disabled (cleared) */
37 #define XAE_OPTION_VLAN (1 << 2)
38
39 /* Enable recognition of flow control frames on Rx. Default: enabled (set) */
40 #define XAE_OPTION_FLOW_CONTROL (1 << 4)
41
42 /* Strip FCS and PAD from incoming frames. Note: PAD from VLAN frames is not
43 * stripped. Default: disabled (set)
44 */
45 #define XAE_OPTION_FCS_STRIP (1 << 5)
46
47 /* Generate FCS field and add PAD automatically for outgoing frames.
48 * Default: enabled (set)
49 */
50 #define XAE_OPTION_FCS_INSERT (1 << 6)
51
52 /* Enable Length/Type error checking for incoming frames. When this option is
53 * set, the MAC will filter frames that have a mismatched type/length field
54 * and if XAE_OPTION_REPORT_RXERR is set, the user is notified when these
55 * types of frames are encountered. When this option is cleared, the MAC will
56 * allow these types of frames to be received. Default: enabled (set)
57 */
58 #define XAE_OPTION_LENTYPE_ERR (1 << 7)
59
60 /* Enable the transmitter. Default: enabled (set) */
61 #define XAE_OPTION_TXEN (1 << 11)
62
63 /* Enable the receiver. Default: enabled (set) */
64 #define XAE_OPTION_RXEN (1 << 12)
65
66 /* Default options set when device is initialized or reset */
67 #define XAE_OPTION_DEFAULTS \
68 (XAE_OPTION_TXEN | \
69 XAE_OPTION_FLOW_CONTROL | \
70 XAE_OPTION_RXEN)
71
72 /* Axi DMA Register definitions */
73
74 #define XAXIDMA_TX_CR_OFFSET 0x00000000 /* Channel control */
75 #define XAXIDMA_TX_SR_OFFSET 0x00000004 /* Status */
76 #define XAXIDMA_TX_CDESC_OFFSET 0x00000008 /* Current descriptor pointer */
77 #define XAXIDMA_TX_TDESC_OFFSET 0x00000010 /* Tail descriptor pointer */
78
79 #define XAXIDMA_RX_CR_OFFSET 0x00000030 /* Channel control */
80 #define XAXIDMA_RX_SR_OFFSET 0x00000034 /* Status */
81 #define XAXIDMA_RX_CDESC_OFFSET 0x00000038 /* Current descriptor pointer */
82 #define XAXIDMA_RX_TDESC_OFFSET 0x00000040 /* Tail descriptor pointer */
83
84 #define XAXIDMA_CR_RUNSTOP_MASK 0x00000001 /* Start/stop DMA channel */
85 #define XAXIDMA_CR_RESET_MASK 0x00000004 /* Reset DMA engine */
86
87 #define XAXIDMA_SR_HALT_MASK 0x00000001 /* Indicates DMA channel halted */
88
89 #define XAXIDMA_BD_NDESC_OFFSET 0x00 /* Next descriptor pointer */
90 #define XAXIDMA_BD_BUFA_OFFSET 0x08 /* Buffer address */
91 #define XAXIDMA_BD_CTRL_LEN_OFFSET 0x18 /* Control/buffer length */
92 #define XAXIDMA_BD_STS_OFFSET 0x1C /* Status */
93 #define XAXIDMA_BD_USR0_OFFSET 0x20 /* User IP specific word0 */
94 #define XAXIDMA_BD_USR1_OFFSET 0x24 /* User IP specific word1 */
95 #define XAXIDMA_BD_USR2_OFFSET 0x28 /* User IP specific word2 */
96 #define XAXIDMA_BD_USR3_OFFSET 0x2C /* User IP specific word3 */
97 #define XAXIDMA_BD_USR4_OFFSET 0x30 /* User IP specific word4 */
98 #define XAXIDMA_BD_ID_OFFSET 0x34 /* Sw ID */
99 #define XAXIDMA_BD_HAS_STSCNTRL_OFFSET 0x38 /* Whether has stscntrl strm */
100 #define XAXIDMA_BD_HAS_DRE_OFFSET 0x3C /* Whether has DRE */
101
102 #define XAXIDMA_BD_HAS_DRE_SHIFT 8 /* Whether has DRE shift */
103 #define XAXIDMA_BD_HAS_DRE_MASK 0xF00 /* Whether has DRE mask */
104 #define XAXIDMA_BD_WORDLEN_MASK 0xFF /* Whether has DRE mask */
105
106 #define XAXIDMA_BD_CTRL_LENGTH_MASK 0x007FFFFF /* Requested len */
107 #define XAXIDMA_BD_CTRL_TXSOF_MASK 0x08000000 /* First tx packet */
108 #define XAXIDMA_BD_CTRL_TXEOF_MASK 0x04000000 /* Last tx packet */
109 #define XAXIDMA_BD_CTRL_ALL_MASK 0x0C000000 /* All control bits */
110
111 #define XAXIDMA_DELAY_MASK 0xFF000000 /* Delay timeout counter */
112 #define XAXIDMA_COALESCE_MASK 0x00FF0000 /* Coalesce counter */
113
114 #define XAXIDMA_DELAY_SHIFT 24
115 #define XAXIDMA_COALESCE_SHIFT 16
116
117 #define XAXIDMA_IRQ_IOC_MASK 0x00001000 /* Completion intr */
118 #define XAXIDMA_IRQ_DELAY_MASK 0x00002000 /* Delay interrupt */
119 #define XAXIDMA_IRQ_ERROR_MASK 0x00004000 /* Error interrupt */
120 #define XAXIDMA_IRQ_ALL_MASK 0x00007000 /* All interrupts */
121
122 /* Default TX/RX Threshold and delay timer values for SGDMA mode */
123 #define XAXIDMA_DFT_TX_THRESHOLD 24
124 #define XAXIDMA_DFT_TX_USEC 50
125 #define XAXIDMA_DFT_RX_THRESHOLD 1
126 #define XAXIDMA_DFT_RX_USEC 50
127
128 #define XAXIDMA_BD_CTRL_TXSOF_MASK 0x08000000 /* First tx packet */
129 #define XAXIDMA_BD_CTRL_TXEOF_MASK 0x04000000 /* Last tx packet */
130 #define XAXIDMA_BD_CTRL_ALL_MASK 0x0C000000 /* All control bits */
131
132 #define XAXIDMA_BD_STS_ACTUAL_LEN_MASK 0x007FFFFF /* Actual len */
133 #define XAXIDMA_BD_STS_COMPLETE_MASK 0x80000000 /* Completed */
134 #define XAXIDMA_BD_STS_DEC_ERR_MASK 0x40000000 /* Decode error */
135 #define XAXIDMA_BD_STS_SLV_ERR_MASK 0x20000000 /* Slave error */
136 #define XAXIDMA_BD_STS_INT_ERR_MASK 0x10000000 /* Internal err */
137 #define XAXIDMA_BD_STS_ALL_ERR_MASK 0x70000000 /* All errors */
138 #define XAXIDMA_BD_STS_RXSOF_MASK 0x08000000 /* First rx pkt */
139 #define XAXIDMA_BD_STS_RXEOF_MASK 0x04000000 /* Last rx pkt */
140 #define XAXIDMA_BD_STS_ALL_MASK 0xFC000000 /* All status bits */
141
142 #define XAXIDMA_BD_MINIMUM_ALIGNMENT 0x40
143
144 /* Axi Ethernet registers definition */
145 #define XAE_RAF_OFFSET 0x00000000 /* Reset and Address filter */
146 #define XAE_TPF_OFFSET 0x00000004 /* Tx Pause Frame */
147 #define XAE_IFGP_OFFSET 0x00000008 /* Tx Inter-frame gap adjustment*/
148 #define XAE_IS_OFFSET 0x0000000C /* Interrupt status */
149 #define XAE_IP_OFFSET 0x00000010 /* Interrupt pending */
150 #define XAE_IE_OFFSET 0x00000014 /* Interrupt enable */
151 #define XAE_TTAG_OFFSET 0x00000018 /* Tx VLAN TAG */
152 #define XAE_RTAG_OFFSET 0x0000001C /* Rx VLAN TAG */
153 #define XAE_UAWL_OFFSET 0x00000020 /* Unicast address word lower */
154 #define XAE_UAWU_OFFSET 0x00000024 /* Unicast address word upper */
155 #define XAE_TPID0_OFFSET 0x00000028 /* VLAN TPID0 register */
156 #define XAE_TPID1_OFFSET 0x0000002C /* VLAN TPID1 register */
157 #define XAE_PPST_OFFSET 0x00000030 /* PCS PMA Soft Temac Status Reg */
158 #define XAE_RCW0_OFFSET 0x00000400 /* Rx Configuration Word 0 */
159 #define XAE_RCW1_OFFSET 0x00000404 /* Rx Configuration Word 1 */
160 #define XAE_TC_OFFSET 0x00000408 /* Tx Configuration */
161 #define XAE_FCC_OFFSET 0x0000040C /* Flow Control Configuration */
162 #define XAE_EMMC_OFFSET 0x00000410 /* MAC speed configuration */
163 #define XAE_PHYC_OFFSET 0x00000414 /* RX Max Frame Configuration */
164 #define XAE_ID_OFFSET 0x000004F8 /* Identification register */
165 #define XAE_MDIO_MC_OFFSET 0x00000500 /* MDIO Setup */
166 #define XAE_MDIO_MCR_OFFSET 0x00000504 /* MDIO Control */
167 #define XAE_MDIO_MWD_OFFSET 0x00000508 /* MDIO Write Data */
168 #define XAE_MDIO_MRD_OFFSET 0x0000050C /* MDIO Read Data */
169 #define XAE_UAW0_OFFSET 0x00000700 /* Unicast address word 0 */
170 #define XAE_UAW1_OFFSET 0x00000704 /* Unicast address word 1 */
171 #define XAE_FMI_OFFSET 0x00000708 /* Frame Filter Control */
172 #define XAE_FFE_OFFSET 0x0000070C /* Frame Filter Enable */
173 #define XAE_AF0_OFFSET 0x00000710 /* Address Filter 0 */
174 #define XAE_AF1_OFFSET 0x00000714 /* Address Filter 1 */
175
176 #define XAE_TX_VLAN_DATA_OFFSET 0x00004000 /* TX VLAN data table address */
177 #define XAE_RX_VLAN_DATA_OFFSET 0x00008000 /* RX VLAN data table address */
178 #define XAE_MCAST_TABLE_OFFSET 0x00020000 /* Multicast table address */
179
180 /* Bit Masks for Axi Ethernet RAF register */
181 /* Reject receive multicast destination address */
182 #define XAE_RAF_MCSTREJ_MASK 0x00000002
183 /* Reject receive broadcast destination address */
184 #define XAE_RAF_BCSTREJ_MASK 0x00000004
185 #define XAE_RAF_TXVTAGMODE_MASK 0x00000018 /* Tx VLAN TAG mode */
186 #define XAE_RAF_RXVTAGMODE_MASK 0x00000060 /* Rx VLAN TAG mode */
187 #define XAE_RAF_TXVSTRPMODE_MASK 0x00000180 /* Tx VLAN STRIP mode */
188 #define XAE_RAF_RXVSTRPMODE_MASK 0x00000600 /* Rx VLAN STRIP mode */
189 #define XAE_RAF_NEWFNCENBL_MASK 0x00000800 /* New function mode */
190 /* Extended Multicast Filtering mode */
191 #define XAE_RAF_EMULTIFLTRENBL_MASK 0x00001000
192 #define XAE_RAF_STATSRST_MASK 0x00002000 /* Stats. Counter Reset */
193 #define XAE_RAF_RXBADFRMEN_MASK 0x00004000 /* Recv Bad Frame Enable */
194 #define XAE_RAF_TXVTAGMODE_SHIFT 3 /* Tx Tag mode shift bits */
195 #define XAE_RAF_RXVTAGMODE_SHIFT 5 /* Rx Tag mode shift bits */
196 #define XAE_RAF_TXVSTRPMODE_SHIFT 7 /* Tx strip mode shift bits*/
197 #define XAE_RAF_RXVSTRPMODE_SHIFT 9 /* Rx Strip mode shift bits*/
198
199 /* Bit Masks for Axi Ethernet TPF and IFGP registers */
200 #define XAE_TPF_TPFV_MASK 0x0000FFFF /* Tx pause frame value */
201 /* Transmit inter-frame gap adjustment value */
202 #define XAE_IFGP0_IFGP_MASK 0x0000007F
203
204 /* Bit Masks for Axi Ethernet IS, IE and IP registers, Same masks apply
205 * for all 3 registers.
206 */
207 /* Hard register access complete */
208 #define XAE_INT_HARDACSCMPLT_MASK 0x00000001
209 /* Auto negotiation complete */
210 #define XAE_INT_AUTONEG_MASK 0x00000002
211 #define XAE_INT_RXCMPIT_MASK 0x00000004 /* Rx complete */
212 #define XAE_INT_RXRJECT_MASK 0x00000008 /* Rx frame rejected */
213 #define XAE_INT_RXFIFOOVR_MASK 0x00000010 /* Rx fifo overrun */
214 #define XAE_INT_TXCMPIT_MASK 0x00000020 /* Tx complete */
215 #define XAE_INT_RXDCMLOCK_MASK 0x00000040 /* Rx Dcm Lock */
216 #define XAE_INT_MGTRDY_MASK 0x00000080 /* MGT clock Lock */
217 #define XAE_INT_PHYRSTCMPLT_MASK 0x00000100 /* Phy Reset complete */
218 #define XAE_INT_ALL_MASK 0x0000003F /* All the ints */
219
220 /* INT bits that indicate receive errors */
221 #define XAE_INT_RECV_ERROR_MASK \
222 (XAE_INT_RXRJECT_MASK | XAE_INT_RXFIFOOVR_MASK)
223
224 /* Bit masks for Axi Ethernet VLAN TPID Word 0 register */
225 #define XAE_TPID_0_MASK 0x0000FFFF /* TPID 0 */
226 #define XAE_TPID_1_MASK 0xFFFF0000 /* TPID 1 */
227
228 /* Bit masks for Axi Ethernet VLAN TPID Word 1 register */
229 #define XAE_TPID_2_MASK 0x0000FFFF /* TPID 0 */
230 #define XAE_TPID_3_MASK 0xFFFF0000 /* TPID 1 */
231
232 /* Bit masks for Axi Ethernet RCW1 register */
233 #define XAE_RCW1_RST_MASK 0x80000000 /* Reset */
234 #define XAE_RCW1_JUM_MASK 0x40000000 /* Jumbo frame enable */
235 /* In-Band FCS enable (FCS not stripped) */
236 #define XAE_RCW1_FCS_MASK 0x20000000
237 #define XAE_RCW1_RX_MASK 0x10000000 /* Receiver enable */
238 #define XAE_RCW1_VLAN_MASK 0x08000000 /* VLAN frame enable */
239 /* Length/type field valid check disable */
240 #define XAE_RCW1_LT_DIS_MASK 0x02000000
241 /* Control frame Length check disable */
242 #define XAE_RCW1_CL_DIS_MASK 0x01000000
243 /* Pause frame source address bits [47:32]. Bits [31:0] are
244 * stored in register RCW0
245 */
246 #define XAE_RCW1_PAUSEADDR_MASK 0x0000FFFF
247
248 /* Bit masks for Axi Ethernet TC register */
249 #define XAE_TC_RST_MASK 0x80000000 /* Reset */
250 #define XAE_TC_JUM_MASK 0x40000000 /* Jumbo frame enable */
251 /* In-Band FCS enable (FCS not generated) */
252 #define XAE_TC_FCS_MASK 0x20000000
253 #define XAE_TC_TX_MASK 0x10000000 /* Transmitter enable */
254 #define XAE_TC_VLAN_MASK 0x08000000 /* VLAN frame enable */
255 /* Inter-frame gap adjustment enable */
256 #define XAE_TC_IFG_MASK 0x02000000
257
258 /* Bit masks for Axi Ethernet FCC register */
259 #define XAE_FCC_FCRX_MASK 0x20000000 /* Rx flow control enable */
260 #define XAE_FCC_FCTX_MASK 0x40000000 /* Tx flow control enable */
261
262 /* Bit masks for Axi Ethernet EMMC register */
263 #define XAE_EMMC_LINKSPEED_MASK 0xC0000000 /* Link speed */
264 #define XAE_EMMC_RGMII_MASK 0x20000000 /* RGMII mode enable */
265 #define XAE_EMMC_SGMII_MASK 0x10000000 /* SGMII mode enable */
266 #define XAE_EMMC_GPCS_MASK 0x08000000 /* 1000BaseX mode enable */
267 #define XAE_EMMC_HOST_MASK 0x04000000 /* Host interface enable */
268 #define XAE_EMMC_TX16BIT 0x02000000 /* 16 bit Tx client enable */
269 #define XAE_EMMC_RX16BIT 0x01000000 /* 16 bit Rx client enable */
270 #define XAE_EMMC_LINKSPD_10 0x00000000 /* Link Speed mask for 10 Mbit */
271 #define XAE_EMMC_LINKSPD_100 0x40000000 /* Link Speed mask for 100 Mbit */
272 #define XAE_EMMC_LINKSPD_1000 0x80000000 /* Link Speed mask for 1000 Mbit */
273
274 /* Bit masks for Axi Ethernet PHYC register */
275 #define XAE_PHYC_SGMIILINKSPEED_MASK 0xC0000000 /* SGMII link speed mask*/
276 #define XAE_PHYC_RGMIILINKSPEED_MASK 0x0000000C /* RGMII link speed */
277 #define XAE_PHYC_RGMIIHD_MASK 0x00000002 /* RGMII Half-duplex */
278 #define XAE_PHYC_RGMIILINK_MASK 0x00000001 /* RGMII link status */
279 #define XAE_PHYC_RGLINKSPD_10 0x00000000 /* RGMII link 10 Mbit */
280 #define XAE_PHYC_RGLINKSPD_100 0x00000004 /* RGMII link 100 Mbit */
281 #define XAE_PHYC_RGLINKSPD_1000 0x00000008 /* RGMII link 1000 Mbit */
282 #define XAE_PHYC_SGLINKSPD_10 0x00000000 /* SGMII link 10 Mbit */
283 #define XAE_PHYC_SGLINKSPD_100 0x40000000 /* SGMII link 100 Mbit */
284 #define XAE_PHYC_SGLINKSPD_1000 0x80000000 /* SGMII link 1000 Mbit */
285
286 /* Bit masks for Axi Ethernet MDIO interface MC register */
287 #define XAE_MDIO_MC_MDIOEN_MASK 0x00000040 /* MII management enable */
288 #define XAE_MDIO_MC_CLOCK_DIVIDE_MAX 0x3F /* Maximum MDIO divisor */
289
290 /* Bit masks for Axi Ethernet MDIO interface MCR register */
291 #define XAE_MDIO_MCR_PHYAD_MASK 0x1F000000 /* Phy Address Mask */
292 #define XAE_MDIO_MCR_PHYAD_SHIFT 24 /* Phy Address Shift */
293 #define XAE_MDIO_MCR_REGAD_MASK 0x001F0000 /* Reg Address Mask */
294 #define XAE_MDIO_MCR_REGAD_SHIFT 16 /* Reg Address Shift */
295 #define XAE_MDIO_MCR_OP_MASK 0x0000C000 /* Operation Code Mask */
296 #define XAE_MDIO_MCR_OP_SHIFT 13 /* Operation Code Shift */
297 #define XAE_MDIO_MCR_OP_READ_MASK 0x00008000 /* Op Code Read Mask */
298 #define XAE_MDIO_MCR_OP_WRITE_MASK 0x00004000 /* Op Code Write Mask */
299 #define XAE_MDIO_MCR_INITIATE_MASK 0x00000800 /* Ready Mask */
300 #define XAE_MDIO_MCR_READY_MASK 0x00000080 /* Ready Mask */
301
302 /* Bit masks for Axi Ethernet MDIO interface MIS, MIP, MIE, MIC registers */
303 #define XAE_MDIO_INT_MIIM_RDY_MASK 0x00000001 /* MIIM Interrupt */
304
305 /* Bit masks for Axi Ethernet UAW1 register */
306 /* Station address bits [47:32]; Station address
307 * bits [31:0] are stored in register UAW0
308 */
309 #define XAE_UAW1_UNICASTADDR_MASK 0x0000FFFF
310
311 /* Bit masks for Axi Ethernet FMC register */
312 #define XAE_FMI_PM_MASK 0x80000000 /* Promis. mode enable */
313 #define XAE_FMI_IND_MASK 0x00000003 /* Index Mask */
314
315 #define XAE_MDIO_DIV_DFT 29 /* Default MDIO clock divisor */
316
317 /* Defines for different options for C_PHY_TYPE parameter in Axi Ethernet IP */
318 #define XAE_PHY_TYPE_MII 0
319 #define XAE_PHY_TYPE_GMII 1
320 #define XAE_PHY_TYPE_RGMII_1_3 2
321 #define XAE_PHY_TYPE_RGMII_2_0 3
322 #define XAE_PHY_TYPE_SGMII 4
323 #define XAE_PHY_TYPE_1000BASE_X 5
324
325 /* Total number of entries in the hardware multicast table. */
326 #define XAE_MULTICAST_CAM_TABLE_NUM 4
327
328 /* Axi Ethernet Synthesis features */
329 #define XAE_FEATURE_PARTIAL_RX_CSUM (1 << 0)
330 #define XAE_FEATURE_PARTIAL_TX_CSUM (1 << 1)
331 #define XAE_FEATURE_FULL_RX_CSUM (1 << 2)
332 #define XAE_FEATURE_FULL_TX_CSUM (1 << 3)
333 #define XAE_FEATURE_DMA_64BIT (1 << 4)
334
335 #define XAE_NO_CSUM_OFFLOAD 0
336
337 #define XAE_FULL_CSUM_STATUS_MASK 0x00000038
338 #define XAE_IP_UDP_CSUM_VALIDATED 0x00000003
339 #define XAE_IP_TCP_CSUM_VALIDATED 0x00000002
340
341 #define DELAY_OF_ONE_MILLISEC 1000
342
343 /* Xilinx PCS/PMA PHY register for switching 1000BaseX or SGMII */
344 #define XLNX_MII_STD_SELECT_REG 0x11
345 #define XLNX_MII_STD_SELECT_SGMII BIT(0)
346
347 /**
348 * struct axidma_bd - Axi Dma buffer descriptor layout
349 * @next: MM2S/S2MM Next Descriptor Pointer
350 * @next_msb: MM2S/S2MM Next Descriptor Pointer (high 32 bits)
351 * @phys: MM2S/S2MM Buffer Address
352 * @phys_msb: MM2S/S2MM Buffer Address (high 32 bits)
353 * @reserved3: Reserved and not used
354 * @reserved4: Reserved and not used
355 * @cntrl: MM2S/S2MM Control value
356 * @status: MM2S/S2MM Status value
357 * @app0: MM2S/S2MM User Application Field 0.
358 * @app1: MM2S/S2MM User Application Field 1.
359 * @app2: MM2S/S2MM User Application Field 2.
360 * @app3: MM2S/S2MM User Application Field 3.
361 * @app4: MM2S/S2MM User Application Field 4.
362 */
363 struct axidma_bd {
364 u32 next; /* Physical address of next buffer descriptor */
365 u32 next_msb; /* high 32 bits for IP >= v7.1, reserved on older IP */
366 u32 phys;
367 u32 phys_msb; /* for IP >= v7.1, reserved for older IP */
368 u32 reserved3;
369 u32 reserved4;
370 u32 cntrl;
371 u32 status;
372 u32 app0;
373 u32 app1; /* TX start << 16 | insert */
374 u32 app2; /* TX csum seed */
375 u32 app3;
376 u32 app4; /* Last field used by HW */
377 struct sk_buff *skb;
378 } __aligned(XAXIDMA_BD_MINIMUM_ALIGNMENT);
379
380 #define XAE_NUM_MISC_CLOCKS 3
381
382 /**
383 * struct axienet_local - axienet private per device data
384 * @ndev: Pointer for net_device to which it will be attached.
385 * @dev: Pointer to device structure
386 * @phy_node: Pointer to device node structure
387 * @phylink: Pointer to phylink instance
388 * @phylink_config: phylink configuration settings
389 * @pcs_phy: Reference to PCS/PMA PHY if used
390 * @pcs: phylink pcs structure for PCS PHY
391 * @switch_x_sgmii: Whether switchable 1000BaseX/SGMII mode is enabled in the core
392 * @axi_clk: AXI4-Lite bus clock
393 * @misc_clks: Misc ethernet clocks (AXI4-Stream, Ref, MGT clocks)
394 * @mii_bus: Pointer to MII bus structure
395 * @mii_clk_div: MII bus clock divider value
396 * @regs_start: Resource start for axienet device addresses
397 * @regs: Base address for the axienet_local device address space
398 * @dma_regs: Base address for the axidma device address space
399 * @napi_rx: NAPI RX control structure
400 * @rx_dma_cr: Nominal content of RX DMA control register
401 * @rx_bd_v: Virtual address of the RX buffer descriptor ring
402 * @rx_bd_p: Physical address(start address) of the RX buffer descr. ring
403 * @rx_bd_num: Size of RX buffer descriptor ring
404 * @rx_bd_ci: Stores the index of the Rx buffer descriptor in the ring being
405 * accessed currently.
406 * @rx_packets: RX packet count for statistics
407 * @rx_bytes: RX byte count for statistics
408 * @rx_stat_sync: Synchronization object for RX stats
409 * @napi_tx: NAPI TX control structure
410 * @tx_dma_cr: Nominal content of TX DMA control register
411 * @tx_bd_v: Virtual address of the TX buffer descriptor ring
412 * @tx_bd_p: Physical address(start address) of the TX buffer descr. ring
413 * @tx_bd_num: Size of TX buffer descriptor ring
414 * @tx_bd_ci: Stores the next Tx buffer descriptor in the ring that may be
415 * complete. Only updated at runtime by TX NAPI poll.
416 * @tx_bd_tail: Stores the index of the next Tx buffer descriptor in the ring
417 * to be populated.
418 * @tx_packets: TX packet count for statistics
419 * @tx_bytes: TX byte count for statistics
420 * @tx_stat_sync: Synchronization object for TX stats
421 * @dma_err_task: Work structure to process Axi DMA errors
422 * @stopping: Set when @dma_err_task shouldn't do anything because we are
423 * about to stop the device.
424 * @tx_irq: Axidma TX IRQ number
425 * @rx_irq: Axidma RX IRQ number
426 * @eth_irq: Ethernet core IRQ number
427 * @phy_mode: Phy type to identify between MII/GMII/RGMII/SGMII/1000 Base-X
428 * @options: AxiEthernet option word
429 * @features: Stores the extended features supported by the axienet hw
430 * @max_frm_size: Stores the maximum size of the frame that can be that
431 * Txed/Rxed in the existing hardware. If jumbo option is
432 * supported, the maximum frame size would be 9k. Else it is
433 * 1522 bytes (assuming support for basic VLAN)
434 * @rxmem: Stores rx memory size for jumbo frame handling.
435 * @csum_offload_on_tx_path: Stores the checksum selection on TX side.
436 * @csum_offload_on_rx_path: Stores the checksum selection on RX side.
437 * @coalesce_count_rx: Store the irq coalesce on RX side.
438 * @coalesce_usec_rx: IRQ coalesce delay for RX
439 * @coalesce_count_tx: Store the irq coalesce on TX side.
440 * @coalesce_usec_tx: IRQ coalesce delay for TX
441 */
442 struct axienet_local {
443 struct net_device *ndev;
444 struct device *dev;
445
446 struct phylink *phylink;
447 struct phylink_config phylink_config;
448
449 struct mdio_device *pcs_phy;
450 struct phylink_pcs pcs;
451
452 bool switch_x_sgmii;
453
454 struct clk *axi_clk;
455 struct clk_bulk_data misc_clks[XAE_NUM_MISC_CLOCKS];
456
457 struct mii_bus *mii_bus;
458 u8 mii_clk_div;
459
460 resource_size_t regs_start;
461 void __iomem *regs;
462 void __iomem *dma_regs;
463
464 struct napi_struct napi_rx;
465 u32 rx_dma_cr;
466 struct axidma_bd *rx_bd_v;
467 dma_addr_t rx_bd_p;
468 u32 rx_bd_num;
469 u32 rx_bd_ci;
470 u64_stats_t rx_packets;
471 u64_stats_t rx_bytes;
472 struct u64_stats_sync rx_stat_sync;
473
474 struct napi_struct napi_tx;
475 u32 tx_dma_cr;
476 struct axidma_bd *tx_bd_v;
477 dma_addr_t tx_bd_p;
478 u32 tx_bd_num;
479 u32 tx_bd_ci;
480 u32 tx_bd_tail;
481 u64_stats_t tx_packets;
482 u64_stats_t tx_bytes;
483 struct u64_stats_sync tx_stat_sync;
484
485 struct work_struct dma_err_task;
486 bool stopping;
487
488 int tx_irq;
489 int rx_irq;
490 int eth_irq;
491 phy_interface_t phy_mode;
492
493 u32 options;
494 u32 features;
495
496 u32 max_frm_size;
497 u32 rxmem;
498
499 int csum_offload_on_tx_path;
500 int csum_offload_on_rx_path;
501
502 u32 coalesce_count_rx;
503 u32 coalesce_usec_rx;
504 u32 coalesce_count_tx;
505 u32 coalesce_usec_tx;
506 };
507
508 /**
509 * struct axiethernet_option - Used to set axi ethernet hardware options
510 * @opt: Option to be set.
511 * @reg: Register offset to be written for setting the option
512 * @m_or: Mask to be ORed for setting the option in the register
513 */
514 struct axienet_option {
515 u32 opt;
516 u32 reg;
517 u32 m_or;
518 };
519
520 /**
521 * axienet_ior - Memory mapped Axi Ethernet register read
522 * @lp: Pointer to axienet local structure
523 * @offset: Address offset from the base address of Axi Ethernet core
524 *
525 * Return: The contents of the Axi Ethernet register
526 *
527 * This function returns the contents of the corresponding register.
528 */
axienet_ior(struct axienet_local * lp,off_t offset)529 static inline u32 axienet_ior(struct axienet_local *lp, off_t offset)
530 {
531 return ioread32(lp->regs + offset);
532 }
533
axinet_ior_read_mcr(struct axienet_local * lp)534 static inline u32 axinet_ior_read_mcr(struct axienet_local *lp)
535 {
536 return axienet_ior(lp, XAE_MDIO_MCR_OFFSET);
537 }
538
axienet_lock_mii(struct axienet_local * lp)539 static inline void axienet_lock_mii(struct axienet_local *lp)
540 {
541 if (lp->mii_bus)
542 mutex_lock(&lp->mii_bus->mdio_lock);
543 }
544
axienet_unlock_mii(struct axienet_local * lp)545 static inline void axienet_unlock_mii(struct axienet_local *lp)
546 {
547 if (lp->mii_bus)
548 mutex_unlock(&lp->mii_bus->mdio_lock);
549 }
550
551 /**
552 * axienet_iow - Memory mapped Axi Ethernet register write
553 * @lp: Pointer to axienet local structure
554 * @offset: Address offset from the base address of Axi Ethernet core
555 * @value: Value to be written into the Axi Ethernet register
556 *
557 * This function writes the desired value into the corresponding Axi Ethernet
558 * register.
559 */
axienet_iow(struct axienet_local * lp,off_t offset,u32 value)560 static inline void axienet_iow(struct axienet_local *lp, off_t offset,
561 u32 value)
562 {
563 iowrite32(value, lp->regs + offset);
564 }
565
566 /**
567 * axienet_dma_out32 - Memory mapped Axi DMA register write.
568 * @lp: Pointer to axienet local structure
569 * @reg: Address offset from the base address of the Axi DMA core
570 * @value: Value to be written into the Axi DMA register
571 *
572 * This function writes the desired value into the corresponding Axi DMA
573 * register.
574 */
575
axienet_dma_out32(struct axienet_local * lp,off_t reg,u32 value)576 static inline void axienet_dma_out32(struct axienet_local *lp,
577 off_t reg, u32 value)
578 {
579 iowrite32(value, lp->dma_regs + reg);
580 }
581
582 #if defined(CONFIG_64BIT) && defined(iowrite64)
583 /**
584 * axienet_dma_out64 - Memory mapped Axi DMA register write.
585 * @lp: Pointer to axienet local structure
586 * @reg: Address offset from the base address of the Axi DMA core
587 * @value: Value to be written into the Axi DMA register
588 *
589 * This function writes the desired value into the corresponding Axi DMA
590 * register.
591 */
axienet_dma_out64(struct axienet_local * lp,off_t reg,u64 value)592 static inline void axienet_dma_out64(struct axienet_local *lp,
593 off_t reg, u64 value)
594 {
595 iowrite64(value, lp->dma_regs + reg);
596 }
597
axienet_dma_out_addr(struct axienet_local * lp,off_t reg,dma_addr_t addr)598 static inline void axienet_dma_out_addr(struct axienet_local *lp, off_t reg,
599 dma_addr_t addr)
600 {
601 if (lp->features & XAE_FEATURE_DMA_64BIT)
602 axienet_dma_out64(lp, reg, addr);
603 else
604 axienet_dma_out32(lp, reg, lower_32_bits(addr));
605 }
606
607 #else /* CONFIG_64BIT */
608
axienet_dma_out_addr(struct axienet_local * lp,off_t reg,dma_addr_t addr)609 static inline void axienet_dma_out_addr(struct axienet_local *lp, off_t reg,
610 dma_addr_t addr)
611 {
612 axienet_dma_out32(lp, reg, lower_32_bits(addr));
613 }
614
615 #endif /* CONFIG_64BIT */
616
617 /* Function prototypes visible in xilinx_axienet_mdio.c for other files */
618 int axienet_mdio_setup(struct axienet_local *lp);
619 void axienet_mdio_teardown(struct axienet_local *lp);
620
621 #endif /* XILINX_AXI_ENET_H */
622