1/*
2 *  linux/include/asm-arm/imxads/dma.h
3 *
4 *  Copyright (C) 1997,1998 Russell King
5 *
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 * GNU General Public License for more details.
15 *
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
19 */
20
21#include <asm/dma.h>
22
23#ifndef __ASM_ARCH_IMX_DMA_H
24#define __ASM_ARCH_IMX_DMA_H
25
26#define IMX_DMA_CHANNELS  11
27
28/*
29 * struct imx_dma_channel - i.MX specific DMA extension
30 * @name: name specified by DMA client
31 * @irq_handler: client callback for end of transfer
32 * @err_handler: client callback for error condition
33 * @data: clients context data for callbacks
34 * @dma_mode: direction of the transfer %DMA_MODE_READ or %DMA_MODE_WRITE
35 * @sg: pointer to the actual read/written chunk for scatter-gather emulation
36 * @sgbc: counter of processed bytes in the actual read/written chunk
37 * @resbytes: total residual number of bytes to transfer
38 *            (it can be lower or same as sum of SG mapped chunk sizes)
39 * @sgcount: number of chunks to be read/written
40 *
41 * Structure is used for IMX DMA processing. It would be probably good
42 * @struct dma_struct in the future for external interfacing and use
43 * @struct imx_dma_channel only as extension to it.
44 */
45
46struct imx_dma_channel {
47	const char *name;
48	void (*irq_handler) (int, void *);
49	void (*err_handler) (int, void *, int errcode);
50	void *data;
51	dmamode_t  dma_mode;
52	struct scatterlist *sg;
53	unsigned int sgbc;
54	unsigned int sgcount;
55	unsigned int resbytes;
56	int dma_num;
57};
58
59extern struct imx_dma_channel imx_dma_channels[IMX_DMA_CHANNELS];
60
61#define IMX_DMA_ERR_BURST     1
62#define IMX_DMA_ERR_REQUEST   2
63#define IMX_DMA_ERR_TRANSFER  4
64#define IMX_DMA_ERR_BUFFER    8
65
66/* The type to distinguish channel numbers parameter from ordinal int type */
67typedef int imx_dmach_t;
68
69int
70imx_dma_setup_single(imx_dmach_t dma_ch, dma_addr_t dma_address,
71		unsigned int dma_length, unsigned int dev_addr, dmamode_t dmamode);
72
73int
74imx_dma_setup_sg(imx_dmach_t dma_ch,
75		 struct scatterlist *sg, unsigned int sgcount, unsigned int dma_length,
76		 unsigned int dev_addr, dmamode_t dmamode);
77
78int
79imx_dma_setup_handlers(imx_dmach_t dma_ch,
80		void (*irq_handler) (int, void *),
81		void (*err_handler) (int, void *, int), void *data);
82
83void imx_dma_enable(imx_dmach_t dma_ch);
84
85void imx_dma_disable(imx_dmach_t dma_ch);
86
87int imx_dma_request(imx_dmach_t dma_ch, const char *name);
88
89void imx_dma_free(imx_dmach_t dma_ch);
90
91int imx_dma_request_by_prio(imx_dmach_t *pdma_ch, const char *name, imx_dma_prio prio);
92
93
94#endif	/* _ASM_ARCH_IMX_DMA_H */
95