PM / Freezer / Docs: Update documentation about freezing of tasks
[linux-flexiantxendom0-3.2.10.git] / drivers / net / ethernet / xilinx / xilinx_axienet.h
1 /*
2  * Definitions for Xilinx Axi Ethernet device driver.
3  *
4  * Copyright (c) 2009 Secret Lab Technologies, Ltd.
5  * Copyright (c) 2010 Xilinx, Inc. All rights reserved.
6  * Copyright (c) 2012 Daniel Borkmann, <daniel.borkmann@tik.ee.ethz.ch>
7  * Copyright (c) 2012 Ariane Keller, <ariane.keller@tik.ee.ethz.ch>
8  */
9
10 #ifndef XILINX_AXIENET_H
11 #define XILINX_AXIENET_H
12
13 #include <linux/netdevice.h>
14 #include <linux/spinlock.h>
15 #include <linux/interrupt.h>
16
17 /* Packet size info */
18 #define XAE_HDR_SIZE                    14 /* Size of Ethernet header */
19 #define XAE_HDR_VLAN_SIZE               18 /* Size of an Ethernet hdr + VLAN */
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 + XAE_HDR_VLAN_SIZE + 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 #define XAE_OPTION_FCS_STRIP                    (1 << 5)
45
46 /* Generate FCS field and add PAD automatically for outgoing frames.
47  * Default: enabled (set) */
48 #define XAE_OPTION_FCS_INSERT                   (1 << 6)
49
50 /* Enable Length/Type error checking for incoming frames. When this option is
51  * set, the MAC will filter frames that have a mismatched type/length field
52  * and if XAE_OPTION_REPORT_RXERR is set, the user is notified when these
53  * types of frames are encountered. When this option is cleared, the MAC will
54  * allow these types of frames to be received. Default: enabled (set) */
55 #define XAE_OPTION_LENTYPE_ERR                  (1 << 7)
56
57 /* Enable the transmitter. Default: enabled (set) */
58 #define XAE_OPTION_TXEN                         (1 << 11)
59
60 /*  Enable the receiver. Default: enabled (set) */
61 #define XAE_OPTION_RXEN                         (1 << 12)
62
63 /*  Default options set when device is initialized or reset */
64 #define XAE_OPTION_DEFAULTS                                \
65                                 (XAE_OPTION_TXEN |         \
66                                  XAE_OPTION_FLOW_CONTROL | \
67                                  XAE_OPTION_RXEN)
68
69 /* Axi DMA Register definitions */
70
71 #define XAXIDMA_TX_CR_OFFSET    0x00000000 /* Channel control */
72 #define XAXIDMA_TX_SR_OFFSET    0x00000004 /* Status */
73 #define XAXIDMA_TX_CDESC_OFFSET 0x00000008 /* Current descriptor pointer */
74 #define XAXIDMA_TX_TDESC_OFFSET 0x00000010 /* Tail descriptor pointer */
75
76 #define XAXIDMA_RX_CR_OFFSET    0x00000030 /* Channel control */
77 #define XAXIDMA_RX_SR_OFFSET    0x00000034 /* Status */
78 #define XAXIDMA_RX_CDESC_OFFSET 0x00000038 /* Current descriptor pointer */
79 #define XAXIDMA_RX_TDESC_OFFSET 0x00000040 /* Tail descriptor pointer */
80
81 #define XAXIDMA_CR_RUNSTOP_MASK 0x00000001 /* Start/stop DMA channel */
82 #define XAXIDMA_CR_RESET_MASK   0x00000004 /* Reset DMA engine */
83
84 #define XAXIDMA_BD_NDESC_OFFSET         0x00 /* Next descriptor pointer */
85 #define XAXIDMA_BD_BUFA_OFFSET          0x08 /* Buffer address */
86 #define XAXIDMA_BD_CTRL_LEN_OFFSET      0x18 /* Control/buffer length */
87 #define XAXIDMA_BD_STS_OFFSET           0x1C /* Status */
88 #define XAXIDMA_BD_USR0_OFFSET          0x20 /* User IP specific word0 */
89 #define XAXIDMA_BD_USR1_OFFSET          0x24 /* User IP specific word1 */
90 #define XAXIDMA_BD_USR2_OFFSET          0x28 /* User IP specific word2 */
91 #define XAXIDMA_BD_USR3_OFFSET          0x2C /* User IP specific word3 */
92 #define XAXIDMA_BD_USR4_OFFSET          0x30 /* User IP specific word4 */
93 #define XAXIDMA_BD_ID_OFFSET            0x34 /* Sw ID */
94 #define XAXIDMA_BD_HAS_STSCNTRL_OFFSET  0x38 /* Whether has stscntrl strm */
95 #define XAXIDMA_BD_HAS_DRE_OFFSET       0x3C /* Whether has DRE */
96
97 #define XAXIDMA_BD_HAS_DRE_SHIFT        8 /* Whether has DRE shift */
98 #define XAXIDMA_BD_HAS_DRE_MASK         0xF00 /* Whether has DRE mask */
99 #define XAXIDMA_BD_WORDLEN_MASK         0xFF /* Whether has DRE mask */
100
101 #define XAXIDMA_BD_CTRL_LENGTH_MASK     0x007FFFFF /* Requested len */
102 #define XAXIDMA_BD_CTRL_TXSOF_MASK      0x08000000 /* First tx packet */
103 #define XAXIDMA_BD_CTRL_TXEOF_MASK      0x04000000 /* Last tx packet */
104 #define XAXIDMA_BD_CTRL_ALL_MASK        0x0C000000 /* All control bits */
105
106 #define XAXIDMA_DELAY_MASK              0xFF000000 /* Delay timeout counter */
107 #define XAXIDMA_COALESCE_MASK           0x00FF0000 /* Coalesce counter */
108
109 #define XAXIDMA_DELAY_SHIFT             24
110 #define XAXIDMA_COALESCE_SHIFT          16
111
112 #define XAXIDMA_IRQ_IOC_MASK            0x00001000 /* Completion intr */
113 #define XAXIDMA_IRQ_DELAY_MASK          0x00002000 /* Delay interrupt */
114 #define XAXIDMA_IRQ_ERROR_MASK          0x00004000 /* Error interrupt */
115 #define XAXIDMA_IRQ_ALL_MASK            0x00007000 /* All interrupts */
116
117 /* Default TX/RX Threshold and waitbound values for SGDMA mode */
118 #define XAXIDMA_DFT_TX_THRESHOLD        24
119 #define XAXIDMA_DFT_TX_WAITBOUND        254
120 #define XAXIDMA_DFT_RX_THRESHOLD        24
121 #define XAXIDMA_DFT_RX_WAITBOUND        254
122
123 #define XAXIDMA_BD_CTRL_TXSOF_MASK      0x08000000 /* First tx packet */
124 #define XAXIDMA_BD_CTRL_TXEOF_MASK      0x04000000 /* Last tx packet */
125 #define XAXIDMA_BD_CTRL_ALL_MASK        0x0C000000 /* All control bits */
126
127 #define XAXIDMA_BD_STS_ACTUAL_LEN_MASK  0x007FFFFF /* Actual len */
128 #define XAXIDMA_BD_STS_COMPLETE_MASK    0x80000000 /* Completed */
129 #define XAXIDMA_BD_STS_DEC_ERR_MASK     0x40000000 /* Decode error */
130 #define XAXIDMA_BD_STS_SLV_ERR_MASK     0x20000000 /* Slave error */
131 #define XAXIDMA_BD_STS_INT_ERR_MASK     0x10000000 /* Internal err */
132 #define XAXIDMA_BD_STS_ALL_ERR_MASK     0x70000000 /* All errors */
133 #define XAXIDMA_BD_STS_RXSOF_MASK       0x08000000 /* First rx pkt */
134 #define XAXIDMA_BD_STS_RXEOF_MASK       0x04000000 /* Last rx pkt */
135 #define XAXIDMA_BD_STS_ALL_MASK         0xFC000000 /* All status bits */
136
137 #define XAXIDMA_BD_MINIMUM_ALIGNMENT    0x40
138
139 /* Axi Ethernet registers definition */
140 #define XAE_RAF_OFFSET          0x00000000 /* Reset and Address filter */
141 #define XAE_TPF_OFFSET          0x00000004 /* Tx Pause Frame */
142 #define XAE_IFGP_OFFSET         0x00000008 /* Tx Inter-frame gap adjustment*/
143 #define XAE_IS_OFFSET           0x0000000C /* Interrupt status */
144 #define XAE_IP_OFFSET           0x00000010 /* Interrupt pending */
145 #define XAE_IE_OFFSET           0x00000014 /* Interrupt enable */
146 #define XAE_TTAG_OFFSET         0x00000018 /* Tx VLAN TAG */
147 #define XAE_RTAG_OFFSET         0x0000001C /* Rx VLAN TAG */
148 #define XAE_UAWL_OFFSET         0x00000020 /* Unicast address word lower */
149 #define XAE_UAWU_OFFSET         0x00000024 /* Unicast address word upper */
150 #define XAE_TPID0_OFFSET        0x00000028 /* VLAN TPID0 register */
151 #define XAE_TPID1_OFFSET        0x0000002C /* VLAN TPID1 register */
152 #define XAE_PPST_OFFSET         0x00000030 /* PCS PMA Soft Temac Status Reg */
153 #define XAE_RCW0_OFFSET         0x00000400 /* Rx Configuration Word 0 */
154 #define XAE_RCW1_OFFSET         0x00000404 /* Rx Configuration Word 1 */
155 #define XAE_TC_OFFSET           0x00000408 /* Tx Configuration */
156 #define XAE_FCC_OFFSET          0x0000040C /* Flow Control Configuration */
157 #define XAE_EMMC_OFFSET         0x00000410 /* EMAC mode configuration */
158 #define XAE_PHYC_OFFSET         0x00000414 /* RGMII/SGMII configuration */
159 #define XAE_MDIO_MC_OFFSET      0x00000500 /* MII Management Config */
160 #define XAE_MDIO_MCR_OFFSET     0x00000504 /* MII Management Control */
161 #define XAE_MDIO_MWD_OFFSET     0x00000508 /* MII Management Write Data */
162 #define XAE_MDIO_MRD_OFFSET     0x0000050C /* MII Management Read Data */
163 #define XAE_MDIO_MIS_OFFSET     0x00000600 /* MII Management Interrupt Status */
164 #define XAE_MDIO_MIP_OFFSET     0x00000620 /* MII Mgmt Interrupt Pending
165                                             * register offset */
166 #define XAE_MDIO_MIE_OFFSET     0x00000640 /* MII Management Interrupt Enable
167                                             * register offset */
168 #define XAE_MDIO_MIC_OFFSET     0x00000660 /* MII Management Interrupt Clear
169                                             * register offset. */
170 #define XAE_UAW0_OFFSET         0x00000700 /* Unicast address word 0 */
171 #define XAE_UAW1_OFFSET         0x00000704 /* Unicast address word 1 */
172 #define XAE_FMI_OFFSET          0x00000708 /* Filter Mask Index */
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 #define XAE_RAF_MCSTREJ_MASK            0x00000002 /* Reject receive multicast
182                                                     * destination address */
183 #define XAE_RAF_BCSTREJ_MASK            0x00000004 /* Reject receive broadcast
184                                                     * destination address */
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 #define XAE_RAF_EMULTIFLTRENBL_MASK     0x00001000 /* Exteneded Multicast
191                                                     * Filtering mode
192                                                     */
193 #define XAE_RAF_STATSRST_MASK           0x00002000 /* Stats. Counter Reset */
194 #define XAE_RAF_RXBADFRMEN_MASK         0x00004000 /* Recv Bad Frame Enable */
195 #define XAE_RAF_TXVTAGMODE_SHIFT        3 /* Tx Tag mode shift bits */
196 #define XAE_RAF_RXVTAGMODE_SHIFT        5 /* Rx Tag mode shift bits */
197 #define XAE_RAF_TXVSTRPMODE_SHIFT       7 /* Tx strip mode shift bits*/
198 #define XAE_RAF_RXVSTRPMODE_SHIFT       9 /* Rx Strip mode shift bits*/
199
200 /* Bit Masks for Axi Ethernet TPF and IFGP registers */
201 #define XAE_TPF_TPFV_MASK               0x0000FFFF /* Tx pause frame value */
202 #define XAE_IFGP0_IFGP_MASK             0x0000007F /* Transmit inter-frame
203                                                     * gap adjustment value */
204
205 /* Bit Masks for Axi Ethernet IS, IE and IP registers, Same masks apply
206  * for all 3 registers. */
207 #define XAE_INT_HARDACSCMPLT_MASK       0x00000001 /* Hard register access
208                                                     * complete */
209 #define XAE_INT_AUTONEG_MASK            0x00000002 /* Auto negotiation
210                                                     * complete */
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 #define XAE_INT_RECV_ERROR_MASK                         \
221         (XAE_INT_RXRJECT_MASK | XAE_INT_RXFIFOOVR_MASK) /* INT bits that
222                                                          * indicate receive
223                                                          * errors */
224
225 /* Bit masks for Axi Ethernet VLAN TPID Word 0 register */
226 #define XAE_TPID_0_MASK         0x0000FFFF /* TPID 0 */
227 #define XAE_TPID_1_MASK         0xFFFF0000 /* TPID 1 */
228
229 /* Bit masks for Axi Ethernet VLAN TPID Word 1 register */
230 #define XAE_TPID_2_MASK         0x0000FFFF /* TPID 0 */
231 #define XAE_TPID_3_MASK         0xFFFF0000 /* TPID 1 */
232
233 /* Bit masks for Axi Ethernet RCW1 register */
234 #define XAE_RCW1_RST_MASK       0x80000000 /* Reset */
235 #define XAE_RCW1_JUM_MASK       0x40000000 /* Jumbo frame enable */
236 #define XAE_RCW1_FCS_MASK       0x20000000 /* In-Band FCS enable
237                                             * (FCS not stripped) */
238 #define XAE_RCW1_RX_MASK        0x10000000 /* Receiver enable */
239 #define XAE_RCW1_VLAN_MASK      0x08000000 /* VLAN frame enable */
240 #define XAE_RCW1_LT_DIS_MASK    0x02000000 /* Length/type field valid check
241                                             * disable */
242 #define XAE_RCW1_CL_DIS_MASK    0x01000000 /* Control frame Length check
243                                             * disable */
244 #define XAE_RCW1_PAUSEADDR_MASK 0x0000FFFF /* Pause frame source address
245                                             * bits [47:32]. Bits [31:0] are
246                                             * stored in register RCW0 */
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 #define XAE_TC_FCS_MASK         0x20000000 /* In-Band FCS enable
252                                             * (FCS not generated) */
253 #define XAE_TC_TX_MASK          0x10000000 /* Transmitter enable */
254 #define XAE_TC_VLAN_MASK        0x08000000 /* VLAN frame enable */
255 #define XAE_TC_IFG_MASK         0x02000000 /* Inter-frame gap adjustment
256                                             * enable */
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 #define XAE_UAW1_UNICASTADDR_MASK       0x0000FFFF /* Station address bits
307                                                     * [47:32]; Station address
308                                                     * bits [31:0] are stored in
309                                                     * register UAW0 */
310
311 /* Bit masks for Axi Ethernet FMI 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 #define XAE_MULTICAST_CAM_TABLE_NUM     4 /* Total number of entries in the
326                                            * hardware multicast table. */
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
334 #define XAE_NO_CSUM_OFFLOAD             0
335
336 #define XAE_FULL_CSUM_STATUS_MASK       0x00000038
337 #define XAE_IP_UDP_CSUM_VALIDATED       0x00000003
338 #define XAE_IP_TCP_CSUM_VALIDATED       0x00000002
339
340 #define DELAY_OF_ONE_MILLISEC           1000
341
342 /**
343  * struct axidma_bd - Axi Dma buffer descriptor layout
344  * @next:         MM2S/S2MM Next Descriptor Pointer
345  * @reserved1:    Reserved and not used
346  * @phys:         MM2S/S2MM Buffer Address
347  * @reserved2:    Reserved and not used
348  * @reserved3:    Reserved and not used
349  * @reserved4:    Reserved and not used
350  * @cntrl:        MM2S/S2MM Control value
351  * @status:       MM2S/S2MM Status value
352  * @app0:         MM2S/S2MM User Application Field 0.
353  * @app1:         MM2S/S2MM User Application Field 1.
354  * @app2:         MM2S/S2MM User Application Field 2.
355  * @app3:         MM2S/S2MM User Application Field 3.
356  * @app4:         MM2S/S2MM User Application Field 4.
357  * @sw_id_offset: MM2S/S2MM Sw ID
358  * @reserved5:    Reserved and not used
359  * @reserved6:    Reserved and not used
360  */
361 struct axidma_bd {
362         u32 next;       /* Physical address of next buffer descriptor */
363         u32 reserved1;
364         u32 phys;
365         u32 reserved2;
366         u32 reserved3;
367         u32 reserved4;
368         u32 cntrl;
369         u32 status;
370         u32 app0;
371         u32 app1;       /* TX start << 16 | insert */
372         u32 app2;       /* TX csum seed */
373         u32 app3;
374         u32 app4;
375         u32 sw_id_offset;
376         u32 reserved5;
377         u32 reserved6;
378 };
379
380 /**
381  * struct axienet_local - axienet private per device data
382  * @ndev:       Pointer for net_device to which it will be attached.
383  * @dev:        Pointer to device structure
384  * @phy_dev:    Pointer to PHY device structure attached to the axienet_local
385  * @phy_node:   Pointer to device node structure
386  * @mii_bus:    Pointer to MII bus structure
387  * @mdio_irqs:  IRQs table for MDIO bus required in mii_bus structure
388  * @regs:       Base address for the axienet_local device address space
389  * @dma_regs:   Base address for the axidma device address space
390  * @dma_err_tasklet: Tasklet structure to process Axi DMA errors
391  * @tx_irq:     Axidma TX IRQ number
392  * @rx_irq:     Axidma RX IRQ number
393  * @temac_type: axienet type to identify between soft and hard temac
394  * @phy_type:   Phy type to identify between MII/GMII/RGMII/SGMII/1000 Base-X
395  * @options:    AxiEthernet option word
396  * @last_link:  Phy link state in which the PHY was negotiated earlier
397  * @features:   Stores the extended features supported by the axienet hw
398  * @tx_bd_v:    Virtual address of the TX buffer descriptor ring
399  * @tx_bd_p:    Physical address(start address) of the TX buffer descr. ring
400  * @rx_bd_v:    Virtual address of the RX buffer descriptor ring
401  * @rx_bd_p:    Physical address(start address) of the RX buffer descr. ring
402  * @tx_bd_ci:   Stores the index of the Tx buffer descriptor in the ring being
403  *              accessed currently. Used while alloc. BDs before a TX starts
404  * @tx_bd_tail: Stores the index of the Tx buffer descriptor in the ring being
405  *              accessed currently. Used while processing BDs after the TX
406  *              completed.
407  * @rx_bd_ci:   Stores the index of the Rx buffer descriptor in the ring being
408  *              accessed currently.
409  * @max_frm_size: Stores the maximum size of the frame that can be that
410  *                Txed/Rxed in the existing hardware. If jumbo option is
411  *                supported, the maximum frame size would be 9k. Else it is
412  *                1522 bytes (assuming support for basic VLAN)
413  * @jumbo_support: Stores hardware configuration for jumbo support. If hardware
414  *                 can handle jumbo packets, this entry will be 1, else 0.
415  */
416 struct axienet_local {
417         struct net_device *ndev;
418         struct device *dev;
419
420         /* Connection to PHY device */
421         struct phy_device *phy_dev;     /* Pointer to PHY device */
422         struct device_node *phy_node;
423
424         /* MDIO bus data */
425         struct mii_bus *mii_bus;        /* MII bus reference */
426         int mdio_irqs[PHY_MAX_ADDR];    /* IRQs table for MDIO bus */
427
428         /* IO registers, dma functions and IRQs */
429         void __iomem *regs;
430         void __iomem *dma_regs;
431
432         struct tasklet_struct dma_err_tasklet;
433
434         int tx_irq;
435         int rx_irq;
436         u32 temac_type;
437         u32 phy_type;
438
439         u32 options;                    /* Current options word */
440         u32 last_link;
441         u32 features;
442
443         /* Buffer descriptors */
444         struct axidma_bd *tx_bd_v;
445         dma_addr_t tx_bd_p;
446         struct axidma_bd *rx_bd_v;
447         dma_addr_t rx_bd_p;
448         u32 tx_bd_ci;
449         u32 tx_bd_tail;
450         u32 rx_bd_ci;
451
452         u32 max_frm_size;
453         u32 jumbo_support;
454
455         int csum_offload_on_tx_path;
456         int csum_offload_on_rx_path;
457
458         u32 coalesce_count_rx;
459         u32 coalesce_count_tx;
460 };
461
462 /**
463  * struct axiethernet_option - Used to set axi ethernet hardware options
464  * @opt:        Option to be set.
465  * @reg:        Register offset to be written for setting the option
466  * @m_or:       Mask to be ORed for setting the option in the register
467  */
468 struct axienet_option {
469         u32 opt;
470         u32 reg;
471         u32 m_or;
472 };
473
474 /**
475  * axienet_ior - Memory mapped Axi Ethernet register read
476  * @lp:         Pointer to axienet local structure
477  * @offset:     Address offset from the base address of Axi Ethernet core
478  *
479  * returns: The contents of the Axi Ethernet register
480  *
481  * This function returns the contents of the corresponding register.
482  */
483 static inline u32 axienet_ior(struct axienet_local *lp, off_t offset)
484 {
485         return in_be32(lp->regs + offset);
486 }
487
488 /**
489  * axienet_iow - Memory mapped Axi Ethernet register write
490  * @lp:         Pointer to axienet local structure
491  * @offset:     Address offset from the base address of Axi Ethernet core
492  * @value:      Value to be written into the Axi Ethernet register
493  *
494  * This function writes the desired value into the corresponding Axi Ethernet
495  * register.
496  */
497 static inline void axienet_iow(struct axienet_local *lp, off_t offset,
498                                u32 value)
499 {
500         out_be32((lp->regs + offset), value);
501 }
502
503 /* Function prototypes visible in xilinx_axienet_mdio.c for other files */
504 int axienet_mdio_setup(struct axienet_local *lp, struct device_node *np);
505 int axienet_mdio_wait_until_ready(struct axienet_local *lp);
506 void axienet_mdio_teardown(struct axienet_local *lp);
507
508 #endif /* XILINX_AXI_ENET_H */