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 S3C241XX 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 {
72 /* enum s3c2410_dma_loadst
74 * This represents the state of the DMA engine, wrt to the loaded / running
75 * transfers. Since we don't have any way of knowing exactly the state of
76 * the DMA transfers, we need to know the state to make decisions on wether
81 * There are no buffers loaded (the channel should be inactive)
85 * There is one buffer loaded, however it has not been confirmed to be
86 * loaded by the DMA engine. This may be because the channel is not
87 * yet running, or the DMA driver decided that it was too costly to
88 * sit and wait for it to happen.
90 * S3C2410_DMA_1RUNNING
92 * The buffer has been confirmed running, and not finisged
94 * S3C2410_DMA_1LOADED_1RUNNING
96 * There is a buffer waiting to be loaded by the DMA engine, and one
100 enum s3c2410_dma_loadst {
101 S3C2410_DMALOAD_NONE,
102 S3C2410_DMALOAD_1LOADED,
103 S3C2410_DMALOAD_1RUNNING,
104 S3C2410_DMALOAD_1LOADED_1RUNNING,
107 enum s3c2410_dma_buffresult {
113 enum s3c2410_dmasrc {
114 S3C2410_DMASRC_HW, /* source is memory */
115 S3C2410_DMASRC_MEM /* source is hardware */
118 /* enum s3c2410_chan_op
120 * operation codes passed to the DMA code by the user, and also used
121 * to inform the current channel owner of any changes to the system state
124 enum s3c2410_chan_op {
128 S3C2410_DMAOP_RESUME,
130 S3C2410_DMAOP_TIMEOUT, /* internal signal to handler */
131 S3C2410_DMAOP_STARTED, /* indicate channel started */
136 #define S3C2410_DMAF_SLOW (1<<0) /* slow, so don't worry about
137 * waiting for reloads */
138 #define S3C2410_DMAF_AUTOSTART (1<<1) /* auto-start if buffer queued */
142 struct s3c2410_dma_client {
148 * internally used buffer structure to describe a queued or running
152 struct s3c2410_dma_buf;
153 struct s3c2410_dma_buf {
154 struct s3c2410_dma_buf *next;
155 int magic; /* magic */
156 int size; /* buffer size in bytes */
157 dma_addr_t data; /* start of DMA data */
158 dma_addr_t ptr; /* where the DMA got to [1] */
159 void *id; /* client's id */
162 /* [1] is this updated for both recv/send modes? */
164 struct s3c2410_dma_chan;
166 /* s3c2410_dma_cbfn_t
168 * buffer callback routine type
171 typedef void (*s3c2410_dma_cbfn_t)(struct s3c2410_dma_chan *,
173 enum s3c2410_dma_buffresult result);
175 typedef int (*s3c2410_dma_opfn_t)(struct s3c2410_dma_chan *,
176 enum s3c2410_chan_op );
178 struct s3c2410_dma_stats {
180 unsigned long timeout_longest;
181 unsigned long timeout_shortest;
182 unsigned long timeout_avg;
183 unsigned long timeout_failed;
186 struct s3c2410_dma_map;
188 /* struct s3c2410_dma_chan
190 * full state information for each DMA channel
193 struct s3c2410_dma_chan {
194 /* channel state flags and information */
195 unsigned char number; /* number of this dma channel */
196 unsigned char in_use; /* channel allocated */
197 unsigned char irq_claimed; /* irq claimed for channel */
198 unsigned char irq_enabled; /* irq enabled for channel */
199 unsigned char xfer_unit; /* size of an transfer */
203 enum s3c2410_dma_state state;
204 enum s3c2410_dma_loadst load_state;
205 struct s3c2410_dma_client *client;
207 /* channel configuration */
208 enum s3c2410_dmasrc source;
209 unsigned long dev_addr;
210 unsigned long load_timeout;
211 unsigned int flags; /* channel flags */
212 unsigned int hw_cfg; /* last hw config */
214 struct s3c24xx_dma_map *map; /* channel hw maps */
216 /* channel's hardware position and configuration */
217 void __iomem *regs; /* channels registers */
218 void __iomem *addr_reg; /* data address register */
219 unsigned int irq; /* channel irq */
220 unsigned long dcon; /* default value of DCON */
223 s3c2410_dma_cbfn_t callback_fn; /* buffer done callback */
224 s3c2410_dma_opfn_t op_fn; /* channel op callback */
226 /* stats gathering */
227 struct s3c2410_dma_stats *stats;
228 struct s3c2410_dma_stats stats_store;
230 /* buffer list and information */
231 struct s3c2410_dma_buf *curr; /* current dma buffer */
232 struct s3c2410_dma_buf *next; /* next buffer to load */
233 struct s3c2410_dma_buf *end; /* end of queue */
236 struct sys_device dev;
239 /* the currently allocated channel information */
240 extern struct s3c2410_dma_chan s3c2410_chans[];
242 /* note, we don't really use dma_device_t at the moment */
243 typedef unsigned long dma_device_t;
245 /* functions --------------------------------------------------------------- */
247 /* s3c2410_dma_request
249 * request a dma channel exclusivley
252 extern int s3c2410_dma_request(unsigned int channel,
253 struct s3c2410_dma_client *, void *dev);
258 * change the state of the dma channel
261 extern int s3c2410_dma_ctrl(unsigned int channel, enum s3c2410_chan_op op);
263 /* s3c2410_dma_setflags
265 * set the channel's flags to a given state
268 extern int s3c2410_dma_setflags(unsigned int channel,
273 * free the dma channel (will also abort any outstanding operations)
276 extern int s3c2410_dma_free(unsigned int channel, struct s3c2410_dma_client *);
278 /* s3c2410_dma_enqueue
280 * place the given buffer onto the queue of operations for the channel.
281 * The buffer must be allocated from dma coherent memory, or the Dcache/WB
282 * drained before the buffer is given to the DMA system.
285 extern int s3c2410_dma_enqueue(unsigned int channel, void *id,
286 dma_addr_t data, int size);
288 /* s3c2410_dma_config
290 * configure the dma channel
293 extern int s3c2410_dma_config(unsigned int channel, int xferunit, int dcon);
295 /* s3c2410_dma_devconfig
297 * configure the device we're talking to
300 extern int s3c2410_dma_devconfig(int channel, enum s3c2410_dmasrc source,
301 int hwcfg, unsigned long devaddr);
303 /* s3c2410_dma_getposition
305 * get the position that the dma transfer is currently at
308 extern int s3c2410_dma_getposition(unsigned int channel,
309 dma_addr_t *src, dma_addr_t *dest);
311 extern int s3c2410_dma_set_opfn(unsigned int, s3c2410_dma_opfn_t rtn);
312 extern int s3c2410_dma_set_buffdone_fn(unsigned int, s3c2410_dma_cbfn_t rtn);
314 /* DMA Register definitions */
316 #define S3C2410_DMA_DISRC (0x00)
317 #define S3C2410_DMA_DISRCC (0x04)
318 #define S3C2410_DMA_DIDST (0x08)
319 #define S3C2410_DMA_DIDSTC (0x0C)
320 #define S3C2410_DMA_DCON (0x10)
321 #define S3C2410_DMA_DSTAT (0x14)
322 #define S3C2410_DMA_DCSRC (0x18)
323 #define S3C2410_DMA_DCDST (0x1C)
324 #define S3C2410_DMA_DMASKTRIG (0x20)
325 #define S3C2412_DMA_DMAREQSEL (0x24)
326 #define S3C2443_DMA_DMAREQSEL (0x24)
328 #define S3C2410_DISRCC_INC (1<<0)
329 #define S3C2410_DISRCC_APB (1<<1)
331 #define S3C2410_DMASKTRIG_STOP (1<<2)
332 #define S3C2410_DMASKTRIG_ON (1<<1)
333 #define S3C2410_DMASKTRIG_SWTRIG (1<<0)
335 #define S3C2410_DCON_DEMAND (0<<31)
336 #define S3C2410_DCON_HANDSHAKE (1<<31)
337 #define S3C2410_DCON_SYNC_PCLK (0<<30)
338 #define S3C2410_DCON_SYNC_HCLK (1<<30)
340 #define S3C2410_DCON_INTREQ (1<<29)
342 #define S3C2410_DCON_CH0_XDREQ0 (0<<24)
343 #define S3C2410_DCON_CH0_UART0 (1<<24)
344 #define S3C2410_DCON_CH0_SDI (2<<24)
345 #define S3C2410_DCON_CH0_TIMER (3<<24)
346 #define S3C2410_DCON_CH0_USBEP1 (4<<24)
348 #define S3C2410_DCON_CH1_XDREQ1 (0<<24)
349 #define S3C2410_DCON_CH1_UART1 (1<<24)
350 #define S3C2410_DCON_CH1_I2SSDI (2<<24)
351 #define S3C2410_DCON_CH1_SPI (3<<24)
352 #define S3C2410_DCON_CH1_USBEP2 (4<<24)
354 #define S3C2410_DCON_CH2_I2SSDO (0<<24)
355 #define S3C2410_DCON_CH2_I2SSDI (1<<24)
356 #define S3C2410_DCON_CH2_SDI (2<<24)
357 #define S3C2410_DCON_CH2_TIMER (3<<24)
358 #define S3C2410_DCON_CH2_USBEP3 (4<<24)
360 #define S3C2410_DCON_CH3_UART2 (0<<24)
361 #define S3C2410_DCON_CH3_SDI (1<<24)
362 #define S3C2410_DCON_CH3_SPI (2<<24)
363 #define S3C2410_DCON_CH3_TIMER (3<<24)
364 #define S3C2410_DCON_CH3_USBEP4 (4<<24)
366 #define S3C2410_DCON_SRCSHIFT (24)
367 #define S3C2410_DCON_SRCMASK (7<<24)
369 #define S3C2410_DCON_BYTE (0<<20)
370 #define S3C2410_DCON_HALFWORD (1<<20)
371 #define S3C2410_DCON_WORD (2<<20)
373 #define S3C2410_DCON_AUTORELOAD (0<<22)
374 #define S3C2410_DCON_NORELOAD (1<<22)
375 #define S3C2410_DCON_HWTRIG (1<<23)
377 #ifdef CONFIG_CPU_S3C2440
378 #define S3C2440_DIDSTC_CHKINT (1<<2)
380 #define S3C2440_DCON_CH0_I2SSDO (5<<24)
381 #define S3C2440_DCON_CH0_PCMIN (6<<24)
383 #define S3C2440_DCON_CH1_PCMOUT (5<<24)
384 #define S3C2440_DCON_CH1_SDI (6<<24)
386 #define S3C2440_DCON_CH2_PCMIN (5<<24)
387 #define S3C2440_DCON_CH2_MICIN (6<<24)
389 #define S3C2440_DCON_CH3_MICIN (5<<24)
390 #define S3C2440_DCON_CH3_PCMOUT (6<<24)
393 #ifdef CONFIG_CPU_S3C2412
395 #define S3C2412_DMAREQSEL_SRC(x) ((x)<<1)
397 #define S3C2412_DMAREQSEL_HW (1)
399 #define S3C2412_DMAREQSEL_SPI0TX S3C2412_DMAREQSEL_SRC(0)
400 #define S3C2412_DMAREQSEL_SPI0RX S3C2412_DMAREQSEL_SRC(1)
401 #define S3C2412_DMAREQSEL_SPI1TX S3C2412_DMAREQSEL_SRC(2)
402 #define S3C2412_DMAREQSEL_SPI1RX S3C2412_DMAREQSEL_SRC(3)
403 #define S3C2412_DMAREQSEL_I2STX S3C2412_DMAREQSEL_SRC(4)
404 #define S3C2412_DMAREQSEL_I2SRX S3C2412_DMAREQSEL_SRC(5)
405 #define S3C2412_DMAREQSEL_TIMER S3C2412_DMAREQSEL_SRC(9)
406 #define S3C2412_DMAREQSEL_SDI S3C2412_DMAREQSEL_SRC(10)
407 #define S3C2412_DMAREQSEL_USBEP1 S3C2412_DMAREQSEL_SRC(13)
408 #define S3C2412_DMAREQSEL_USBEP2 S3C2412_DMAREQSEL_SRC(14)
409 #define S3C2412_DMAREQSEL_USBEP3 S3C2412_DMAREQSEL_SRC(15)
410 #define S3C2412_DMAREQSEL_USBEP4 S3C2412_DMAREQSEL_SRC(16)
411 #define S3C2412_DMAREQSEL_XDREQ0 S3C2412_DMAREQSEL_SRC(17)
412 #define S3C2412_DMAREQSEL_XDREQ1 S3C2412_DMAREQSEL_SRC(18)
413 #define S3C2412_DMAREQSEL_UART0_0 S3C2412_DMAREQSEL_SRC(19)
414 #define S3C2412_DMAREQSEL_UART0_1 S3C2412_DMAREQSEL_SRC(20)
415 #define S3C2412_DMAREQSEL_UART1_0 S3C2412_DMAREQSEL_SRC(21)
416 #define S3C2412_DMAREQSEL_UART1_1 S3C2412_DMAREQSEL_SRC(22)
417 #define S3C2412_DMAREQSEL_UART2_0 S3C2412_DMAREQSEL_SRC(23)
418 #define S3C2412_DMAREQSEL_UART2_1 S3C2412_DMAREQSEL_SRC(24)
422 #define S3C2443_DMAREQSEL_SRC(x) ((x)<<1)
424 #define S3C2443_DMAREQSEL_HW (1)
426 #define S3C2443_DMAREQSEL_SPI0TX S3C2443_DMAREQSEL_SRC(0)
427 #define S3C2443_DMAREQSEL_SPI0RX S3C2443_DMAREQSEL_SRC(1)
428 #define S3C2443_DMAREQSEL_SPI1TX S3C2443_DMAREQSEL_SRC(2)
429 #define S3C2443_DMAREQSEL_SPI1RX S3C2443_DMAREQSEL_SRC(3)
430 #define S3C2443_DMAREQSEL_I2STX S3C2443_DMAREQSEL_SRC(4)
431 #define S3C2443_DMAREQSEL_I2SRX S3C2443_DMAREQSEL_SRC(5)
432 #define S3C2443_DMAREQSEL_TIMER S3C2443_DMAREQSEL_SRC(9)
433 #define S3C2443_DMAREQSEL_SDI S3C2443_DMAREQSEL_SRC(10)
434 #define S3C2443_DMAREQSEL_XDREQ0 S3C2443_DMAREQSEL_SRC(17)
435 #define S3C2443_DMAREQSEL_XDREQ1 S3C2443_DMAREQSEL_SRC(18)
436 #define S3C2443_DMAREQSEL_UART0_0 S3C2443_DMAREQSEL_SRC(19)
437 #define S3C2443_DMAREQSEL_UART0_1 S3C2443_DMAREQSEL_SRC(20)
438 #define S3C2443_DMAREQSEL_UART1_0 S3C2443_DMAREQSEL_SRC(21)
439 #define S3C2443_DMAREQSEL_UART1_1 S3C2443_DMAREQSEL_SRC(22)
440 #define S3C2443_DMAREQSEL_UART2_0 S3C2443_DMAREQSEL_SRC(23)
441 #define S3C2443_DMAREQSEL_UART2_1 S3C2443_DMAREQSEL_SRC(24)
442 #define S3C2443_DMAREQSEL_UART3_0 S3C2443_DMAREQSEL_SRC(25)
443 #define S3C2443_DMAREQSEL_UART3_1 S3C2443_DMAREQSEL_SRC(26)
444 #define S3C2443_DMAREQSEL_PCMOUT S3C2443_DMAREQSEL_SRC(27)
445 #define S3C2443_DMAREQSEL_PCMIN S3C2443_DMAREQSEL_SRC(28)
446 #define S3C2443_DMAREQSEL_MICIN S3C2443_DMAREQSEL_SRC(29)
448 #endif /* __ASM_ARCH_DMA_H */