1 /* arch/arm/mach-s3c2410/include/mach/dma.h
3 * Copyright (C) 2003,2004,2006 Simtec Electronics
4 * Ben Dooks <ben@simtec.co.uk>
6 * Samsung S3C24XX DMA support
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License version 2 as
10 * published by the Free Software Foundation.
13 #ifndef __ASM_ARCH_DMA_H
14 #define __ASM_ARCH_DMA_H __FILE__
16 #include <linux/sysdev.h>
17 #include <mach/hardware.h>
19 #define MAX_DMA_TRANSFER_SIZE 0x100000 /* Data Unit is half word */
21 /* We use `virtual` dma channels to hide the fact we have only a limited
22 * number of DMA channels, and not of all of them (dependant on the device)
23 * can be attached to any DMA source. We therefore let the DMA core handle
24 * the allocation of hardware channels to clients.
46 DMACH_UART0_SRC2
, /* s3c2412 second uart sources */
49 DMACH_UART3
, /* s3c2443 has extra uart */
51 DMACH_MAX
, /* the end entry */
54 #define DMACH_LOW_LEVEL (1<<28) /* use this to specifiy hardware ch no */
56 /* we have 4 dma channels */
57 #ifndef CONFIG_CPU_S3C2443
58 #define S3C2410_DMA_CHANNELS (4)
60 #define S3C2410_DMA_CHANNELS (6)
65 enum s3c2410_dma_state
{
71 /* enum s3c2410_dma_loadst
73 * This represents the state of the DMA engine, wrt to the loaded / running
74 * transfers. Since we don't have any way of knowing exactly the state of
75 * the DMA transfers, we need to know the state to make decisions on wether
80 * There are no buffers loaded (the channel should be inactive)
84 * There is one buffer loaded, however it has not been confirmed to be
85 * loaded by the DMA engine. This may be because the channel is not
86 * yet running, or the DMA driver decided that it was too costly to
87 * sit and wait for it to happen.
89 * S3C2410_DMA_1RUNNING
91 * The buffer has been confirmed running, and not finisged
93 * S3C2410_DMA_1LOADED_1RUNNING
95 * There is a buffer waiting to be loaded by the DMA engine, and one
99 enum s3c2410_dma_loadst
{
100 S3C2410_DMALOAD_NONE
,
101 S3C2410_DMALOAD_1LOADED
,
102 S3C2410_DMALOAD_1RUNNING
,
103 S3C2410_DMALOAD_1LOADED_1RUNNING
,
106 enum s3c2410_dma_buffresult
{
112 enum s3c2410_dmasrc
{
113 S3C2410_DMASRC_HW
, /* source is memory */
114 S3C2410_DMASRC_MEM
/* source is hardware */
117 /* enum s3c2410_chan_op
119 * operation codes passed to the DMA code by the user, and also used
120 * to inform the current channel owner of any changes to the system state
123 enum s3c2410_chan_op
{
127 S3C2410_DMAOP_RESUME
,
129 S3C2410_DMAOP_TIMEOUT
, /* internal signal to handler */
130 S3C2410_DMAOP_STARTED
, /* indicate channel started */
135 #define S3C2410_DMAF_SLOW (1<<0) /* slow, so don't worry about
136 * waiting for reloads */
137 #define S3C2410_DMAF_AUTOSTART (1<<1) /* auto-start if buffer queued */
141 struct s3c2410_dma_client
{
147 * internally used buffer structure to describe a queued or running
151 struct s3c2410_dma_buf
;
152 struct s3c2410_dma_buf
{
153 struct s3c2410_dma_buf
*next
;
154 int magic
; /* magic */
155 int size
; /* buffer size in bytes */
156 dma_addr_t data
; /* start of DMA data */
157 dma_addr_t ptr
; /* where the DMA got to [1] */
158 void *id
; /* client's id */
161 /* [1] is this updated for both recv/send modes? */
163 struct s3c2410_dma_chan
;
165 /* s3c2410_dma_cbfn_t
167 * buffer callback routine type
170 typedef void (*s3c2410_dma_cbfn_t
)(struct s3c2410_dma_chan
*,
172 enum s3c2410_dma_buffresult result
);
174 typedef int (*s3c2410_dma_opfn_t
)(struct s3c2410_dma_chan
*,
175 enum s3c2410_chan_op
);
177 struct s3c2410_dma_stats
{
179 unsigned long timeout_longest
;
180 unsigned long timeout_shortest
;
181 unsigned long timeout_avg
;
182 unsigned long timeout_failed
;
185 struct s3c2410_dma_map
;
187 /* struct s3c2410_dma_chan
189 * full state information for each DMA channel
192 struct s3c2410_dma_chan
{
193 /* channel state flags and information */
194 unsigned char number
; /* number of this dma channel */
195 unsigned char in_use
; /* channel allocated */
196 unsigned char irq_claimed
; /* irq claimed for channel */
197 unsigned char irq_enabled
; /* irq enabled for channel */
198 unsigned char xfer_unit
; /* size of an transfer */
202 enum s3c2410_dma_state state
;
203 enum s3c2410_dma_loadst load_state
;
204 struct s3c2410_dma_client
*client
;
206 /* channel configuration */
207 enum s3c2410_dmasrc source
;
209 unsigned long dev_addr
;
210 unsigned long load_timeout
;
211 unsigned int flags
; /* channel flags */
213 struct s3c24xx_dma_map
*map
; /* channel hw maps */
215 /* channel's hardware position and configuration */
216 void __iomem
*regs
; /* channels registers */
217 void __iomem
*addr_reg
; /* data address register */
218 unsigned int irq
; /* channel irq */
219 unsigned long dcon
; /* default value of DCON */
222 s3c2410_dma_cbfn_t callback_fn
; /* buffer done callback */
223 s3c2410_dma_opfn_t op_fn
; /* channel op callback */
225 /* stats gathering */
226 struct s3c2410_dma_stats
*stats
;
227 struct s3c2410_dma_stats stats_store
;
229 /* buffer list and information */
230 struct s3c2410_dma_buf
*curr
; /* current dma buffer */
231 struct s3c2410_dma_buf
*next
; /* next buffer to load */
232 struct s3c2410_dma_buf
*end
; /* end of queue */
235 struct sys_device dev
;
238 /* the currently allocated channel information */
239 extern struct s3c2410_dma_chan s3c2410_chans
[];
241 /* note, we don't really use dma_device_t at the moment */
242 typedef unsigned long dma_device_t
;
244 /* functions --------------------------------------------------------------- */
246 /* s3c2410_dma_request
248 * request a dma channel exclusivley
251 extern int s3c2410_dma_request(unsigned int channel
,
252 struct s3c2410_dma_client
*, void *dev
);
257 * change the state of the dma channel
260 extern int s3c2410_dma_ctrl(unsigned int channel
, enum s3c2410_chan_op op
);
262 /* s3c2410_dma_setflags
264 * set the channel's flags to a given state
267 extern int s3c2410_dma_setflags(unsigned int channel
,
272 * free the dma channel (will also abort any outstanding operations)
275 extern int s3c2410_dma_free(unsigned int channel
, struct s3c2410_dma_client
*);
277 /* s3c2410_dma_enqueue
279 * place the given buffer onto the queue of operations for the channel.
280 * The buffer must be allocated from dma coherent memory, or the Dcache/WB
281 * drained before the buffer is given to the DMA system.
284 extern int s3c2410_dma_enqueue(unsigned int channel
, void *id
,
285 dma_addr_t data
, int size
);
287 /* s3c2410_dma_config
289 * configure the dma channel
292 extern int s3c2410_dma_config(unsigned int channel
, int xferunit
);
294 /* s3c2410_dma_devconfig
296 * configure the device we're talking to
299 extern int s3c2410_dma_devconfig(int channel
, enum s3c2410_dmasrc source
,
300 unsigned long devaddr
);
302 /* s3c2410_dma_getposition
304 * get the position that the dma transfer is currently at
307 extern int s3c2410_dma_getposition(unsigned int channel
,
308 dma_addr_t
*src
, dma_addr_t
*dest
);
310 extern int s3c2410_dma_set_opfn(unsigned int, s3c2410_dma_opfn_t rtn
);
311 extern int s3c2410_dma_set_buffdone_fn(unsigned int, s3c2410_dma_cbfn_t rtn
);
313 #endif /* __ASM_ARCH_DMA_H */