xref: /linux/arch/mips/include/asm/mach-au1x00/au1xxx_dbdma.h (revision f26e8817b235d8764363bffcc9cbfc61867371f2)
1 /*
2  *
3  * BRIEF MODULE DESCRIPTION
4  *	Include file for Alchemy Semiconductor's Au1550 Descriptor
5  *	Based DMA Controller.
6  *
7  * Copyright 2004 Embedded Edge, LLC
8  *	dan@embeddededge.com
9  *
10  *  This program is free software; you can redistribute  it and/or modify it
11  *  under  the terms of  the GNU General  Public License as published by the
12  *  Free Software Foundation;  either version 2 of the  License, or (at your
13  *  option) any later version.
14  *
15  *  THIS  SOFTWARE  IS PROVIDED   ``AS  IS'' AND   ANY  EXPRESS OR IMPLIED
16  *  WARRANTIES,   INCLUDING, BUT NOT  LIMITED  TO, THE IMPLIED WARRANTIES OF
17  *  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
18  *  NO  EVENT  SHALL   THE AUTHOR  BE    LIABLE FOR ANY   DIRECT, INDIRECT,
19  *  INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20  *  NOT LIMITED   TO, PROCUREMENT OF  SUBSTITUTE GOODS  OR SERVICES; LOSS OF
21  *  USE, DATA,  OR PROFITS; OR  BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
22  *  ANY THEORY OF LIABILITY, WHETHER IN  CONTRACT, STRICT LIABILITY, OR TORT
23  *  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24  *  THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  *
26  *  You should have received a copy of the  GNU General Public License along
27  *  with this program; if not, write  to the Free Software Foundation, Inc.,
28  *  675 Mass Ave, Cambridge, MA 02139, USA.
29  */
30 
31 /*
32  * Specifics for the Au1xxx Descriptor-Based DMA Controller,
33  * first seen in the AU1550 part.
34  */
35 #ifndef _AU1000_DBDMA_H_
36 #define _AU1000_DBDMA_H_
37 
38 #ifndef _LANGUAGE_ASSEMBLY
39 
40 typedef volatile struct dbdma_global {
41 	u32	ddma_config;
42 	u32	ddma_intstat;
43 	u32	ddma_throttle;
44 	u32	ddma_inten;
45 } dbdma_global_t;
46 
47 /* General Configuration. */
48 #define DDMA_CONFIG_AF		(1 << 2)
49 #define DDMA_CONFIG_AH		(1 << 1)
50 #define DDMA_CONFIG_AL		(1 << 0)
51 
52 #define DDMA_THROTTLE_EN	(1 << 31)
53 
54 /* The structure of a DMA Channel. */
55 typedef volatile struct au1xxx_dma_channel {
56 	u32	ddma_cfg;	/* See below */
57 	u32	ddma_desptr;	/* 32-byte aligned pointer to descriptor */
58 	u32	ddma_statptr;	/* word aligned pointer to status word */
59 	u32	ddma_dbell;	/* A write activates channel operation */
60 	u32	ddma_irq;	/* If bit 0 set, interrupt pending */
61 	u32	ddma_stat;	/* See below */
62 	u32	ddma_bytecnt;	/* Byte count, valid only when chan idle */
63 	/* Remainder, up to the 256 byte boundary, is reserved. */
64 } au1x_dma_chan_t;
65 
66 #define DDMA_CFG_SED	(1 << 9)	/* source DMA level/edge detect */
67 #define DDMA_CFG_SP	(1 << 8)	/* source DMA polarity */
68 #define DDMA_CFG_DED	(1 << 7)	/* destination DMA level/edge detect */
69 #define DDMA_CFG_DP	(1 << 6)	/* destination DMA polarity */
70 #define DDMA_CFG_SYNC	(1 << 5)	/* Sync static bus controller */
71 #define DDMA_CFG_PPR	(1 << 4)	/* PCI posted read/write control */
72 #define DDMA_CFG_DFN	(1 << 3)	/* Descriptor fetch non-coherent */
73 #define DDMA_CFG_SBE	(1 << 2)	/* Source big endian */
74 #define DDMA_CFG_DBE	(1 << 1)	/* Destination big endian */
75 #define DDMA_CFG_EN	(1 << 0)	/* Channel enable */
76 
77 /*
78  * Always set when descriptor processing done, regardless of
79  * interrupt enable state.  Reflected in global intstat, don't
80  * clear this until global intstat is read/used.
81  */
82 #define DDMA_IRQ_IN	(1 << 0)
83 
84 #define DDMA_STAT_DB	(1 << 2)	/* Doorbell pushed */
85 #define DDMA_STAT_V	(1 << 1)	/* Descriptor valid */
86 #define DDMA_STAT_H	(1 << 0)	/* Channel Halted */
87 
88 /*
89  * "Standard" DDMA Descriptor.
90  * Must be 32-byte aligned.
91  */
92 typedef volatile struct au1xxx_ddma_desc {
93 	u32	dscr_cmd0;		/* See below */
94 	u32	dscr_cmd1;		/* See below */
95 	u32	dscr_source0;		/* source phys address */
96 	u32	dscr_source1;		/* See below */
97 	u32	dscr_dest0;		/* Destination address */
98 	u32	dscr_dest1;		/* See below */
99 	u32	dscr_stat;		/* completion status */
100 	u32	dscr_nxtptr;		/* Next descriptor pointer (mostly) */
101 	/*
102 	 * First 32 bytes are HW specific!!!
103 	 * Let's have some SW data following -- make sure it's 32 bytes.
104 	 */
105 	u32	sw_status;
106 	u32	sw_context;
107 	u32	sw_reserved[6];
108 } au1x_ddma_desc_t;
109 
110 #define DSCR_CMD0_V		(1 << 31)	/* Descriptor valid */
111 #define DSCR_CMD0_MEM		(1 << 30)	/* mem-mem transfer */
112 #define DSCR_CMD0_SID_MASK	(0x1f << 25)	/* Source ID */
113 #define DSCR_CMD0_DID_MASK	(0x1f << 20)	/* Destination ID */
114 #define DSCR_CMD0_SW_MASK	(0x3 << 18)	/* Source Width */
115 #define DSCR_CMD0_DW_MASK	(0x3 << 16)	/* Destination Width */
116 #define DSCR_CMD0_ARB		(0x1 << 15)	/* Set for Hi Pri */
117 #define DSCR_CMD0_DT_MASK	(0x3 << 13)	/* Descriptor Type */
118 #define DSCR_CMD0_SN		(0x1 << 12)	/* Source non-coherent */
119 #define DSCR_CMD0_DN		(0x1 << 11)	/* Destination non-coherent */
120 #define DSCR_CMD0_SM		(0x1 << 10)	/* Stride mode */
121 #define DSCR_CMD0_IE		(0x1 << 8)	/* Interrupt Enable */
122 #define DSCR_CMD0_SP		(0x1 << 4)	/* Status pointer select */
123 #define DSCR_CMD0_CV		(0x1 << 2)	/* Clear Valid when done */
124 #define DSCR_CMD0_ST_MASK	(0x3 << 0)	/* Status instruction */
125 
126 #define SW_STATUS_INUSE		(1 << 0)
127 
128 /* Command 0 device IDs. */
129 #define AU1550_DSCR_CMD0_UART0_TX	0
130 #define AU1550_DSCR_CMD0_UART0_RX	1
131 #define AU1550_DSCR_CMD0_UART3_TX	2
132 #define AU1550_DSCR_CMD0_UART3_RX	3
133 #define AU1550_DSCR_CMD0_DMA_REQ0	4
134 #define AU1550_DSCR_CMD0_DMA_REQ1	5
135 #define AU1550_DSCR_CMD0_DMA_REQ2	6
136 #define AU1550_DSCR_CMD0_DMA_REQ3	7
137 #define AU1550_DSCR_CMD0_USBDEV_RX0	8
138 #define AU1550_DSCR_CMD0_USBDEV_TX0	9
139 #define AU1550_DSCR_CMD0_USBDEV_TX1	10
140 #define AU1550_DSCR_CMD0_USBDEV_TX2	11
141 #define AU1550_DSCR_CMD0_USBDEV_RX3	12
142 #define AU1550_DSCR_CMD0_USBDEV_RX4	13
143 #define AU1550_DSCR_CMD0_PSC0_TX	14
144 #define AU1550_DSCR_CMD0_PSC0_RX	15
145 #define AU1550_DSCR_CMD0_PSC1_TX	16
146 #define AU1550_DSCR_CMD0_PSC1_RX	17
147 #define AU1550_DSCR_CMD0_PSC2_TX	18
148 #define AU1550_DSCR_CMD0_PSC2_RX	19
149 #define AU1550_DSCR_CMD0_PSC3_TX	20
150 #define AU1550_DSCR_CMD0_PSC3_RX	21
151 #define AU1550_DSCR_CMD0_PCI_WRITE	22
152 #define AU1550_DSCR_CMD0_NAND_FLASH	23
153 #define AU1550_DSCR_CMD0_MAC0_RX	24
154 #define AU1550_DSCR_CMD0_MAC0_TX	25
155 #define AU1550_DSCR_CMD0_MAC1_RX	26
156 #define AU1550_DSCR_CMD0_MAC1_TX	27
157 
158 #define AU1200_DSCR_CMD0_UART0_TX	0
159 #define AU1200_DSCR_CMD0_UART0_RX	1
160 #define AU1200_DSCR_CMD0_UART1_TX	2
161 #define AU1200_DSCR_CMD0_UART1_RX	3
162 #define AU1200_DSCR_CMD0_DMA_REQ0	4
163 #define AU1200_DSCR_CMD0_DMA_REQ1	5
164 #define AU1200_DSCR_CMD0_MAE_BE		6
165 #define AU1200_DSCR_CMD0_MAE_FE		7
166 #define AU1200_DSCR_CMD0_SDMS_TX0	8
167 #define AU1200_DSCR_CMD0_SDMS_RX0	9
168 #define AU1200_DSCR_CMD0_SDMS_TX1	10
169 #define AU1200_DSCR_CMD0_SDMS_RX1	11
170 #define AU1200_DSCR_CMD0_AES_TX		13
171 #define AU1200_DSCR_CMD0_AES_RX		12
172 #define AU1200_DSCR_CMD0_PSC0_TX	14
173 #define AU1200_DSCR_CMD0_PSC0_RX	15
174 #define AU1200_DSCR_CMD0_PSC1_TX	16
175 #define AU1200_DSCR_CMD0_PSC1_RX	17
176 #define AU1200_DSCR_CMD0_CIM_RXA	18
177 #define AU1200_DSCR_CMD0_CIM_RXB	19
178 #define AU1200_DSCR_CMD0_CIM_RXC	20
179 #define AU1200_DSCR_CMD0_MAE_BOTH	21
180 #define AU1200_DSCR_CMD0_LCD		22
181 #define AU1200_DSCR_CMD0_NAND_FLASH	23
182 #define AU1200_DSCR_CMD0_PSC0_SYNC	24
183 #define AU1200_DSCR_CMD0_PSC1_SYNC	25
184 #define AU1200_DSCR_CMD0_CIM_SYNC	26
185 
186 #define AU1300_DSCR_CMD0_UART0_TX      0
187 #define AU1300_DSCR_CMD0_UART0_RX      1
188 #define AU1300_DSCR_CMD0_UART1_TX      2
189 #define AU1300_DSCR_CMD0_UART1_RX      3
190 #define AU1300_DSCR_CMD0_UART2_TX      4
191 #define AU1300_DSCR_CMD0_UART2_RX      5
192 #define AU1300_DSCR_CMD0_UART3_TX      6
193 #define AU1300_DSCR_CMD0_UART3_RX      7
194 #define AU1300_DSCR_CMD0_SDMS_TX0      8
195 #define AU1300_DSCR_CMD0_SDMS_RX0      9
196 #define AU1300_DSCR_CMD0_SDMS_TX1      10
197 #define AU1300_DSCR_CMD0_SDMS_RX1      11
198 #define AU1300_DSCR_CMD0_AES_TX	       12
199 #define AU1300_DSCR_CMD0_AES_RX	       13
200 #define AU1300_DSCR_CMD0_PSC0_TX       14
201 #define AU1300_DSCR_CMD0_PSC0_RX       15
202 #define AU1300_DSCR_CMD0_PSC1_TX       16
203 #define AU1300_DSCR_CMD0_PSC1_RX       17
204 #define AU1300_DSCR_CMD0_PSC2_TX       18
205 #define AU1300_DSCR_CMD0_PSC2_RX       19
206 #define AU1300_DSCR_CMD0_PSC3_TX       20
207 #define AU1300_DSCR_CMD0_PSC3_RX       21
208 #define AU1300_DSCR_CMD0_LCD	       22
209 #define AU1300_DSCR_CMD0_NAND_FLASH    23
210 #define AU1300_DSCR_CMD0_SDMS_TX2      24
211 #define AU1300_DSCR_CMD0_SDMS_RX2      25
212 #define AU1300_DSCR_CMD0_CIM_SYNC      26
213 #define AU1300_DSCR_CMD0_UDMA	       27
214 #define AU1300_DSCR_CMD0_DMA_REQ0      28
215 #define AU1300_DSCR_CMD0_DMA_REQ1      29
216 
217 #define DSCR_CMD0_THROTTLE	30
218 #define DSCR_CMD0_ALWAYS	31
219 #define DSCR_NDEV_IDS		32
220 /* This macro is used to find/create custom device types */
221 #define DSCR_DEV2CUSTOM_ID(x, d) (((((x) & 0xFFFF) << 8) | 0x32000000) | \
222 				  ((d) & 0xFF))
223 #define DSCR_CUSTOM2DEV_ID(x)	((x) & 0xFF)
224 
225 #define DSCR_CMD0_SID(x)	(((x) & 0x1f) << 25)
226 #define DSCR_CMD0_DID(x)	(((x) & 0x1f) << 20)
227 
228 /* Source/Destination transfer width. */
229 #define DSCR_CMD0_BYTE		0
230 #define DSCR_CMD0_HALFWORD	1
231 #define DSCR_CMD0_WORD		2
232 
233 #define DSCR_CMD0_SW(x)		(((x) & 0x3) << 18)
234 #define DSCR_CMD0_DW(x)		(((x) & 0x3) << 16)
235 
236 /* DDMA Descriptor Type. */
237 #define DSCR_CMD0_STANDARD	0
238 #define DSCR_CMD0_LITERAL	1
239 #define DSCR_CMD0_CMP_BRANCH	2
240 
241 #define DSCR_CMD0_DT(x)		(((x) & 0x3) << 13)
242 
243 /* Status Instruction. */
244 #define DSCR_CMD0_ST_NOCHANGE	0	/* Don't change */
245 #define DSCR_CMD0_ST_CURRENT	1	/* Write current status */
246 #define DSCR_CMD0_ST_CMD0	2	/* Write cmd0 with V cleared */
247 #define DSCR_CMD0_ST_BYTECNT	3	/* Write remaining byte count */
248 
249 #define DSCR_CMD0_ST(x)		(((x) & 0x3) << 0)
250 
251 /* Descriptor Command 1. */
252 #define DSCR_CMD1_SUPTR_MASK	(0xf << 28)	/* upper 4 bits of src addr */
253 #define DSCR_CMD1_DUPTR_MASK	(0xf << 24)	/* upper 4 bits of dest addr */
254 #define DSCR_CMD1_FL_MASK	(0x3 << 22)	/* Flag bits */
255 #define DSCR_CMD1_BC_MASK	(0x3fffff)	/* Byte count */
256 
257 /* Flag description. */
258 #define DSCR_CMD1_FL_MEM_STRIDE0	0
259 #define DSCR_CMD1_FL_MEM_STRIDE1	1
260 #define DSCR_CMD1_FL_MEM_STRIDE2	2
261 
262 #define DSCR_CMD1_FL(x)		(((x) & 0x3) << 22)
263 
264 /* Source1, 1-dimensional stride. */
265 #define DSCR_SRC1_STS_MASK	(3 << 30)	/* Src xfer size */
266 #define DSCR_SRC1_SAM_MASK	(3 << 28)	/* Src xfer movement */
267 #define DSCR_SRC1_SB_MASK	(0x3fff << 14)	/* Block size */
268 #define DSCR_SRC1_SB(x)		(((x) & 0x3fff) << 14)
269 #define DSCR_SRC1_SS_MASK	(0x3fff << 0)	/* Stride */
270 #define DSCR_SRC1_SS(x)		(((x) & 0x3fff) << 0)
271 
272 /* Dest1, 1-dimensional stride. */
273 #define DSCR_DEST1_DTS_MASK	(3 << 30)	/* Dest xfer size */
274 #define DSCR_DEST1_DAM_MASK	(3 << 28)	/* Dest xfer movement */
275 #define DSCR_DEST1_DB_MASK	(0x3fff << 14)	/* Block size */
276 #define DSCR_DEST1_DB(x)	(((x) & 0x3fff) << 14)
277 #define DSCR_DEST1_DS_MASK	(0x3fff << 0)	/* Stride */
278 #define DSCR_DEST1_DS(x)	(((x) & 0x3fff) << 0)
279 
280 #define DSCR_xTS_SIZE1		0
281 #define DSCR_xTS_SIZE2		1
282 #define DSCR_xTS_SIZE4		2
283 #define DSCR_xTS_SIZE8		3
284 #define DSCR_SRC1_STS(x)	(((x) & 3) << 30)
285 #define DSCR_DEST1_DTS(x)	(((x) & 3) << 30)
286 
287 #define DSCR_xAM_INCREMENT	0
288 #define DSCR_xAM_DECREMENT	1
289 #define DSCR_xAM_STATIC		2
290 #define DSCR_xAM_BURST		3
291 #define DSCR_SRC1_SAM(x)	(((x) & 3) << 28)
292 #define DSCR_DEST1_DAM(x)	(((x) & 3) << 28)
293 
294 /* The next descriptor pointer. */
295 #define DSCR_NXTPTR_MASK	(0x07ffffff)
296 #define DSCR_NXTPTR(x)		((x) >> 5)
297 #define DSCR_GET_NXTPTR(x)	((x) << 5)
298 #define DSCR_NXTPTR_MS		(1 << 27)
299 
300 /* The number of DBDMA channels. */
301 #define NUM_DBDMA_CHANS 16
302 
303 /*
304  * DDMA API definitions
305  * FIXME: may not fit to this header file
306  */
307 typedef struct dbdma_device_table {
308 	u32	dev_id;
309 	u32	dev_flags;
310 	u32	dev_tsize;
311 	u32	dev_devwidth;
312 	u32	dev_physaddr;		/* If FIFO */
313 	u32	dev_intlevel;
314 	u32	dev_intpolarity;
315 } dbdev_tab_t;
316 
317 
318 typedef struct dbdma_chan_config {
319 	spinlock_t	lock;
320 
321 	u32			chan_flags;
322 	u32			chan_index;
323 	dbdev_tab_t		*chan_src;
324 	dbdev_tab_t		*chan_dest;
325 	au1x_dma_chan_t		*chan_ptr;
326 	au1x_ddma_desc_t	*chan_desc_base;
327 	u32			cdb_membase; /* kmalloc base of above */
328 	au1x_ddma_desc_t	*get_ptr, *put_ptr, *cur_ptr;
329 	void			*chan_callparam;
330 	void			(*chan_callback)(int, void *);
331 } chan_tab_t;
332 
333 #define DEV_FLAGS_INUSE		(1 << 0)
334 #define DEV_FLAGS_ANYUSE	(1 << 1)
335 #define DEV_FLAGS_OUT		(1 << 2)
336 #define DEV_FLAGS_IN		(1 << 3)
337 #define DEV_FLAGS_BURSTABLE	(1 << 4)
338 #define DEV_FLAGS_SYNC		(1 << 5)
339 /* end DDMA API definitions */
340 
341 /*
342  * External functions for drivers to use.
343  * Use this to allocate a DBDMA channel.  The device IDs are one of
344  * the DSCR_CMD0 devices IDs, which is usually redefined to a more
345  * meaningful name.  The 'callback' is called during DMA completion
346  * interrupt.
347  */
348 extern u32 au1xxx_dbdma_chan_alloc(u32 srcid, u32 destid,
349 				   void (*callback)(int, void *),
350 				   void *callparam);
351 
352 #define DBDMA_MEM_CHAN	DSCR_CMD0_ALWAYS
353 
354 /* Set the device width of an in/out FIFO. */
355 u32 au1xxx_dbdma_set_devwidth(u32 chanid, int bits);
356 
357 /* Allocate a ring of descriptors for DBDMA. */
358 u32 au1xxx_dbdma_ring_alloc(u32 chanid, int entries);
359 
360 /* Put buffers on source/destination descriptors. */
361 u32 au1xxx_dbdma_put_source(u32 chanid, dma_addr_t buf, int nbytes, u32 flags);
362 u32 au1xxx_dbdma_put_dest(u32 chanid, dma_addr_t buf, int nbytes, u32 flags);
363 
364 /* Get a buffer from the destination descriptor. */
365 u32 au1xxx_dbdma_get_dest(u32 chanid, void **buf, int *nbytes);
366 
367 void au1xxx_dbdma_stop(u32 chanid);
368 void au1xxx_dbdma_start(u32 chanid);
369 void au1xxx_dbdma_reset(u32 chanid);
370 u32 au1xxx_get_dma_residue(u32 chanid);
371 
372 void au1xxx_dbdma_chan_free(u32 chanid);
373 void au1xxx_dbdma_dump(u32 chanid);
374 
375 u32 au1xxx_dbdma_put_dscr(u32 chanid, au1x_ddma_desc_t *dscr);
376 
377 u32 au1xxx_ddma_add_device(dbdev_tab_t *dev);
378 extern void au1xxx_ddma_del_device(u32 devid);
379 void *au1xxx_ddma_get_nextptr_virt(au1x_ddma_desc_t *dp);
380 
381 /*
382  *	Flags for the put_source/put_dest functions.
383  */
384 #define DDMA_FLAGS_IE	(1 << 0)
385 #define DDMA_FLAGS_NOIE (1 << 1)
386 
387 #endif /* _LANGUAGE_ASSEMBLY */
388 #endif /* _AU1000_DBDMA_H_ */
389