]> git.ipfire.org Git - people/ms/u-boot.git/blame - drivers/net/xilinx_ll_temac_sdma.h
drivers/net/xilinx_ll_temac.c: Fix compile warning
[people/ms/u-boot.git] / drivers / net / xilinx_ll_temac_sdma.h
CommitLineData
df482650
SL
1/*
2 * Xilinx xps_ll_temac ethernet driver for u-boot
3 *
4 * SDMA sub-controller interface
5 *
6 * Copyright (C) 2011 - 2012 Stephan Linz <linz@li-pro.net>
7 * Copyright (C) 2008 - 2011 Michal Simek <monstr@monstr.eu>
8 * Copyright (C) 2008 - 2011 PetaLogix
9 *
10 * Based on Yoshio Kashiwagi kashiwagi@co-nss.co.jp driver
11 * Copyright (C) 2008 Nissin Systems Co.,Ltd.
12 * March 2008 created
13 *
14 * This program is free software; you can redistribute it and/or modify it
15 * under the terms of the GNU General Public License as published by the
16 * Free Software Foundation; either version 2 of the License, or (at your
17 * option) any later version.
18 *
19 * [0]: http://www.xilinx.com/support/documentation
20 *
21 * [S]: [0]/ip_documentation/xps_ll_temac.pdf
22 * [A]: [0]/application_notes/xapp1041.pdf
23 */
24#ifndef _XILINX_LL_TEMAC_SDMA_
25#define _XILINX_LL_TEMAC_SDMA_
26
27#include <net.h>
28
29#include <asm/types.h>
30#include <asm/byteorder.h>
31
32#include <linux/compiler.h>
33
34#if !defined(__BIG_ENDIAN)
35# error LL_TEMAC requires big endianess
36#endif
37
38/*
39 * DMA Buffer Descriptor for CDMAC
40 *
41 * Used for data connection from and to (Rx/Tx) the LocalLink (LL) TEMAC via
42 * the Communications Direct Memory Access Controller (CDMAC) -- one for each.
43 *
44 * overview:
45 * ftp://ftp.xilinx.com/pub/documentation/misc/mpmc_getting_started.pdf
46 *
47 * [1]: [0]/ip_documentation/mpmc.pdf
48 * page 140, DMA Operation Descriptors
49 *
50 * [2]: [0]/user_guides/ug200.pdf
51 * page 229, DMA Controller -- Descriptor Format
52 *
53 * [3]: [0]/ip_documentation/xps_ll_temac.pdf
54 * page 72, Transmit LocalLink Frame Format
55 * page 73, Receive LocalLink Frame Format
56 */
57struct cdmac_bd {
58 struct cdmac_bd *next_p; /* Next Descriptor Pointer */
59 u8 *phys_buf_p; /* Buffer Address */
60 u32 buf_len; /* Buffer Length */
61 union {
62 u8 stctrl; /* Status/Control the DMA transfer */
63 u32 app[5]; /* application specific data */
64 } __packed __aligned(1) sca;
65};
66
67/* CDMAC Descriptor Status and Control (stctrl), [1] p140, [2] p230 */
68#define CDMAC_BD_STCTRL_ERROR (1 << 7)
69#define CDMAC_BD_STCTRL_IRQ_ON_END (1 << 6)
70#define CDMAC_BD_STCTRL_STOP_ON_END (1 << 5)
71#define CDMAC_BD_STCTRL_COMPLETED (1 << 4)
72#define CDMAC_BD_STCTRL_SOP (1 << 3)
73#define CDMAC_BD_STCTRL_EOP (1 << 2)
74#define CDMAC_BD_STCTRL_DMACHBUSY (1 << 1)
75
76/* CDMAC Descriptor APP0: Transmit LocalLink Footer Word 3, [3] p72 */
77#define CDMAC_BD_APP0_TXCSCNTRL (1 << 0)
78
79/* CDMAC Descriptor APP1: Transmit LocalLink Footer Word 4, [3] p73 */
80#define CDMAC_BD_APP1_TXCSBEGIN_POS 16
81#define CDMAC_BD_APP1_TXCSBEGIN_MASK (0xFFFF << CDMAC_BD_APP1_TXCSBEGIN_POS)
82#define CDMAC_BD_APP1_TXCSINSERT_POS 0
83#define CDMAC_BD_APP1_TXCSINSERT_MASK (0xFFFF << CDMAC_BD_APP1_TXCSINSERT_POS)
84
85/* CDMAC Descriptor APP2: Transmit LocalLink Footer Word 5, [3] p73 */
86#define CDMAC_BD_APP2_TXCSINIT_POS 0
87#define CDMAC_BD_APP2_TXCSINIT_MASK (0xFFFF << CDMAC_BD_APP2_TXCSINIT_POS)
88
89/* CDMAC Descriptor APP0: Receive LocalLink Footer Word 3, [3] p73 */
90#define CDMAC_BD_APP0_MADDRU_POS 0
91#define CDMAC_BD_APP0_MADDRU_MASK (0xFFFF << CDMAC_BD_APP0_MADDRU_POS)
92
93/* CDMAC Descriptor APP1: Receive LocalLink Footer Word 4, [3] p74 */
94#define CDMAC_BD_APP1_MADDRL_POS 0
95#define CDMAC_BD_APP1_MADDRL_MASK (~0UL << CDMAC_BD_APP1_MADDRL_POS)
96
97/* CDMAC Descriptor APP2: Receive LocalLink Footer Word 5, [3] p74 */
98#define CDMAC_BD_APP2_BCAST_FRAME (1 << 2)
99#define CDMAC_BD_APP2_IPC_MCAST_FRAME (1 << 1)
100#define CDMAC_BD_APP2_MAC_MCAST_FRAME (1 << 0)
101
102/* CDMAC Descriptor APP3: Receive LocalLink Footer Word 6, [3] p74 */
103#define CDMAC_BD_APP3_TLTPID_POS 16
104#define CDMAC_BD_APP3_TLTPID_MASK (0xFFFF << CDMAC_BD_APP3_TLTPID_POS)
105#define CDMAC_BD_APP3_RXCSRAW_POS 0
106#define CDMAC_BD_APP3_RXCSRAW_MASK (0xFFFF << CDMAC_BD_APP3_RXCSRAW_POS)
107
108/* CDMAC Descriptor APP4: Receive LocalLink Footer Word 7, [3] p74 */
109#define CDMAC_BD_APP4_VLANTAG_POS 16
110#define CDMAC_BD_APP4_VLANTAG_MASK (0xFFFF << CDMAC_BD_APP4_VLANTAG_POS)
111#define CDMAC_BD_APP4_RXBYTECNT_POS 0
112#define CDMAC_BD_APP4_RXBYTECNT_MASK (0x3FFF << CDMAC_BD_APP4_RXBYTECNT_POS)
113
114/*
115 * SDMA Register Definition
116 *
117 * [0]: http://www.xilinx.com/support/documentation
118 *
119 * [1]: [0]/ip_documentation/mpmc.pdf
120 * page 54, SDMA Register Summary
121 * page 160, SDMA Registers
122 *
123 * [2]: [0]/user_guides/ug200.pdf
124 * page 244, DMA Controller -- Programming Interface and Registers
125 */
126#define SDMA_CTRL_REGTYPE u32
127#define SDMA_CTRL_REGSIZE sizeof(SDMA_CTRL_REGTYPE)
128struct sdma_ctrl {
129 /* Transmit Registers */
130 SDMA_CTRL_REGTYPE tx_nxtdesc_ptr; /* TX Next Description Pointer */
131 SDMA_CTRL_REGTYPE tx_curbuf_addr; /* TX Current Buffer Address */
132 SDMA_CTRL_REGTYPE tx_curbuf_length; /* TX Current Buffer Length */
133 SDMA_CTRL_REGTYPE tx_curdesc_ptr; /* TX Current Descriptor Pointer */
134 SDMA_CTRL_REGTYPE tx_taildesc_ptr; /* TX Tail Descriptor Pointer */
135 SDMA_CTRL_REGTYPE tx_chnl_ctrl; /* TX Channel Control */
136 SDMA_CTRL_REGTYPE tx_irq_reg; /* TX Interrupt Register */
137 SDMA_CTRL_REGTYPE tx_chnl_sts; /* TX Status Register */
138 /* Receive Registers */
139 SDMA_CTRL_REGTYPE rx_nxtdesc_ptr; /* RX Next Descriptor Pointer */
140 SDMA_CTRL_REGTYPE rx_curbuf_addr; /* RX Current Buffer Address */
141 SDMA_CTRL_REGTYPE rx_curbuf_length; /* RX Current Buffer Length */
142 SDMA_CTRL_REGTYPE rx_curdesc_ptr; /* RX Current Descriptor Pointer */
143 SDMA_CTRL_REGTYPE rx_taildesc_ptr; /* RX Tail Descriptor Pointer */
144 SDMA_CTRL_REGTYPE rx_chnl_ctrl; /* RX Channel Control */
145 SDMA_CTRL_REGTYPE rx_irq_reg; /* RX Interrupt Register */
146 SDMA_CTRL_REGTYPE rx_chnl_sts; /* RX Status Register */
147 /* Control Registers */
148 SDMA_CTRL_REGTYPE dma_control_reg; /* DMA Control Register */
149};
150
151#define SDMA_CTRL_REGNUMS sizeof(struct sdma_ctrl)/SDMA_CTRL_REGSIZE
152
153/*
154 * DMAC Register Index Enumeration
155 *
156 * [2]: http://www.xilinx.com/support/documentation/user_guides/ug200.pdf
157 * page 244, DMA Controller -- Programming Interface and Registers
158 */
159enum dmac_ctrl {
160 /* Transmit Registers */
161 TX_NXTDESC_PTR = 0, /* TX Next Description Pointer */
162 TX_CURBUF_ADDR, /* TX Current Buffer Address */
163 TX_CURBUF_LENGTH, /* TX Current Buffer Length */
164 TX_CURDESC_PTR, /* TX Current Descriptor Pointer */
165 TX_TAILDESC_PTR, /* TX Tail Descriptor Pointer */
166 TX_CHNL_CTRL, /* TX Channel Control */
167 TX_IRQ_REG, /* TX Interrupt Register */
168 TX_CHNL_STS, /* TX Status Register */
169 /* Receive Registers */
170 RX_NXTDESC_PTR, /* RX Next Descriptor Pointer */
171 RX_CURBUF_ADDR, /* RX Current Buffer Address */
172 RX_CURBUF_LENGTH, /* RX Current Buffer Length */
173 RX_CURDESC_PTR, /* RX Current Descriptor Pointer */
174 RX_TAILDESC_PTR, /* RX Tail Descriptor Pointer */
175 RX_CHNL_CTRL, /* RX Channel Control */
176 RX_IRQ_REG, /* RX Interrupt Register */
177 RX_CHNL_STS, /* RX Status Register */
178 /* Control Registers */
179 DMA_CONTROL_REG /* DMA Control Register */
180};
181
182/* Rx/Tx Channel Control Register (*_chnl_ctrl), [1] p163, [2] p246/p252 */
183#define CHNL_CTRL_ITO_POS 24
184#define CHNL_CTRL_ITO_MASK (0xFF << CHNL_CTRL_ITO_POS)
185#define CHNL_CTRL_IC_POS 16
186#define CHNL_CTRL_IC_MASK (0xFF << CHNL_CTRL_IC_POS)
187#define CHNL_CTRL_MSBADDR_POS 12
188#define CHNL_CTRL_MSBADDR_MASK (0xF << CHNL_CTRL_MSBADDR_POS)
189#define CHNL_CTRL_AME (1 << 11)
190#define CHNL_CTRL_OBWC (1 << 10)
191#define CHNL_CTRL_IOE (1 << 9)
192#define CHNL_CTRL_LIC (1 << 8)
193#define CHNL_CTRL_IE (1 << 7)
194#define CHNL_CTRL_IEE (1 << 2)
195#define CHNL_CTRL_IDE (1 << 1)
196#define CHNL_CTRL_ICE (1 << 0)
197
198/* All interrupt enable bits */
199#define CHNL_CTRL_IRQ_MASK (CHNL_CTRL_IE | \
200 CHNL_CTRL_IEE | \
201 CHNL_CTRL_IDE | \
202 CHNL_CTRL_ICE)
203
204/* Rx/Tx Interrupt Status Register (*_irq_reg), [1] p164, [2] p247/p253 */
205#define IRQ_REG_DTV_POS 24
206#define IRQ_REG_DTV_MASK (0xFF << IRQ_REG_DTV_POS)
207#define IRQ_REG_CCV_POS 16
208#define IRQ_REG_CCV_MASK (0xFF << IRQ_REG_CCV_POS)
209#define IRQ_REG_WRCQ_EMPTY (1 << 14)
210#define IRQ_REG_CIC_POS 10
211#define IRQ_REG_CIC_MASK (0xF << IRQ_REG_CIC_POS)
212#define IRQ_REG_DIC_POS 8
213#define IRQ_REG_DIC_MASK (3 << 8)
214#define IRQ_REG_PLB_RD_NMI (1 << 4)
215#define IRQ_REG_PLB_WR_NMI (1 << 3)
216#define IRQ_REG_EI (1 << 2)
217#define IRQ_REG_DI (1 << 1)
218#define IRQ_REG_CI (1 << 0)
219
220/* All interrupt bits */
221#define IRQ_REG_IRQ_MASK (IRQ_REG_PLB_RD_NMI | \
222 IRQ_REG_PLB_WR_NMI | \
223 IRQ_REG_EI | IRQ_REG_DI | IRQ_REG_CI)
224
225/* Rx/Tx Channel Status Register (*_chnl_sts), [1] p165, [2] p249/p255 */
226#define CHNL_STS_ERROR_TAIL (1 << 21)
227#define CHNL_STS_ERROR_CMP (1 << 20)
228#define CHNL_STS_ERROR_ADDR (1 << 19)
229#define CHNL_STS_ERROR_NXTP (1 << 18)
230#define CHNL_STS_ERROR_CURP (1 << 17)
231#define CHNL_STS_ERROR_BSYWR (1 << 16)
232#define CHNL_STS_ERROR (1 << 7)
233#define CHNL_STS_IOE (1 << 6)
234#define CHNL_STS_SOE (1 << 5)
235#define CHNL_STS_CMPLT (1 << 4)
236#define CHNL_STS_SOP (1 << 3)
237#define CHNL_STS_EOP (1 << 2)
238#define CHNL_STS_EBUSY (1 << 1)
239
240/* DMA Control Register (dma_control_reg), [1] p166, [2] p256 */
241#define DMA_CONTROL_PLBED (1 << 5)
242#define DMA_CONTROL_RXOCEID (1 << 4)
243#define DMA_CONTROL_TXOCEID (1 << 3)
244#define DMA_CONTROL_TPE (1 << 2)
245#define DMA_CONTROL_RESET (1 << 0)
246
247#if defined(CONFIG_XILINX_440) || defined(CONFIG_XILINX_405)
248
249/* Xilinx Device Control Register (DCR) in/out accessors */
250unsigned ll_temac_xldcr_in32(phys_addr_t addr);
251void ll_temac_xldcr_out32(phys_addr_t addr, unsigned value);
252
253/* collect all register addresses for Xilinx DCR in/out accessors */
254void ll_temac_collect_xldcr_sdma_reg_addr(struct eth_device *dev);
255
256#endif /* CONFIG_XILINX_440 || CONFIG_XILINX_405 */
257
258/* Xilinx Processor Local Bus (PLB) in/out accessors */
259unsigned ll_temac_xlplb_in32(phys_addr_t base);
260void ll_temac_xlplb_out32(phys_addr_t base, unsigned value);
261
262/* collect all register addresses for Xilinx PLB in/out accessors */
263void ll_temac_collect_xlplb_sdma_reg_addr(struct eth_device *dev);
264
265/* initialize both Rx/Tx buffer descriptors */
266int ll_temac_init_sdma(struct eth_device *dev);
267
268/* halt both Rx/Tx transfers */
269int ll_temac_halt_sdma(struct eth_device *dev);
270
271/* reset SDMA and IRQ, disable interrupts and errors */
272int ll_temac_reset_sdma(struct eth_device *dev);
273
274/* receive buffered data from SDMA (polling ISR) */
275int ll_temac_recv_sdma(struct eth_device *dev);
276
277/* send buffered data to SDMA */
f22ff1ab 278int ll_temac_send_sdma(struct eth_device *dev, void *packet, int length);
df482650
SL
279
280#endif /* _XILINX_LL_TEMAC_SDMA_ */