blob: fb6e4f7b00a2c48fed82aa09b5cf72c837959b36 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * include/asm-sh/dma.h
3 *
4 * Copyright (C) 2003, 2004 Paul Mundt
5 *
6 * This file is subject to the terms and conditions of the GNU General Public
7 * License. See the file "COPYING" in the main directory of this archive
8 * for more details.
9 */
10#ifndef __ASM_SH_DMA_H
11#define __ASM_SH_DMA_H
12#ifdef __KERNEL__
13
Linus Torvalds1da177e2005-04-16 15:20:36 -070014#include <linux/spinlock.h>
15#include <linux/wait.h>
Evgeniy Polyakov66c52272007-05-31 13:46:21 +090016#include <linux/sched.h>
Kay Sieversdc6876a2011-12-21 15:09:52 -080017#include <linux/device.h>
Paul Mundt9deaa3b2009-06-14 21:45:06 +090018#include <asm-generic/dma.h>
Linus Torvalds1da177e2005-04-16 15:20:36 -070019
Linus Torvalds1da177e2005-04-16 15:20:36 -070020/*
21 * Read and write modes can mean drastically different things depending on the
22 * channel configuration. Consult your DMAC documentation and module
23 * implementation for further clues.
24 */
25#define DMA_MODE_READ 0x00
26#define DMA_MODE_WRITE 0x01
27#define DMA_MODE_MASK 0x01
28
29#define DMA_AUTOINIT 0x10
30
31/*
32 * DMAC (dma_info) flags
33 */
34enum {
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090035 DMAC_CHANNELS_CONFIGURED = 0x01,
36 DMAC_CHANNELS_TEI_CAPABLE = 0x02, /* Transfer end interrupt */
Linus Torvalds1da177e2005-04-16 15:20:36 -070037};
38
39/*
40 * DMA channel capabilities / flags
41 */
42enum {
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090043 DMA_CONFIGURED = 0x01,
44
45 /*
46 * Transfer end interrupt, inherited from DMAC.
47 * wait_queue used in dma_wait_for_completion.
48 */
49 DMA_TEI_CAPABLE = 0x02,
Linus Torvalds1da177e2005-04-16 15:20:36 -070050};
51
52extern spinlock_t dma_spin_lock;
53
54struct dma_channel;
55
56struct dma_ops {
57 int (*request)(struct dma_channel *chan);
58 void (*free)(struct dma_channel *chan);
59
60 int (*get_residue)(struct dma_channel *chan);
61 int (*xfer)(struct dma_channel *chan);
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090062 int (*configure)(struct dma_channel *chan, unsigned long flags);
63 int (*extend)(struct dma_channel *chan, unsigned long op, void *param);
Linus Torvalds1da177e2005-04-16 15:20:36 -070064};
65
66struct dma_channel {
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090067 char dev_id[16]; /* unique name per DMAC of channel */
Linus Torvalds1da177e2005-04-16 15:20:36 -070068
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090069 unsigned int chan; /* DMAC channel number */
Paul Mundt0d831772006-01-16 22:14:09 -080070 unsigned int vchan; /* Virtual channel number */
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090071
Linus Torvalds1da177e2005-04-16 15:20:36 -070072 unsigned int mode;
73 unsigned int count;
74
75 unsigned long sar;
76 unsigned long dar;
77
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090078 const char **caps;
79
Linus Torvalds1da177e2005-04-16 15:20:36 -070080 unsigned long flags;
81 atomic_t busy;
82
Linus Torvalds1da177e2005-04-16 15:20:36 -070083 wait_queue_head_t wait_queue;
84
Kay Sieversdc6876a2011-12-21 15:09:52 -080085 struct device dev;
Mark Glaisherdb9b99d2006-11-24 15:13:52 +090086 void *priv_data;
Linus Torvalds1da177e2005-04-16 15:20:36 -070087};
88
89struct dma_info {
Paul Mundt0d831772006-01-16 22:14:09 -080090 struct platform_device *pdev;
91
Linus Torvalds1da177e2005-04-16 15:20:36 -070092 const char *name;
93 unsigned int nr_channels;
94 unsigned long flags;
95
96 struct dma_ops *ops;
97 struct dma_channel *channels;
98
99 struct list_head list;
Mark Glaisherdb9b99d2006-11-24 15:13:52 +0900100 int first_channel_nr;
Adrian McMenamineb695db2007-07-24 13:30:55 +0900101 int first_vchannel_nr;
Mark Glaisherdb9b99d2006-11-24 15:13:52 +0900102};
103
104struct dma_chan_caps {
105 int ch_num;
106 const char **caplist;
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107};
108
109#define to_dma_channel(channel) container_of(channel, struct dma_channel, dev)
110
111/* arch/sh/drivers/dma/dma-api.c */
112extern int dma_xfer(unsigned int chan, unsigned long from,
113 unsigned long to, size_t size, unsigned int mode);
114
115#define dma_write(chan, from, to, size) \
116 dma_xfer(chan, from, to, size, DMA_MODE_WRITE)
117#define dma_write_page(chan, from, to) \
118 dma_write(chan, from, to, PAGE_SIZE)
119
120#define dma_read(chan, from, to, size) \
121 dma_xfer(chan, from, to, size, DMA_MODE_READ)
122#define dma_read_page(chan, from, to) \
123 dma_read(chan, from, to, PAGE_SIZE)
124
Mark Glaisherdb9b99d2006-11-24 15:13:52 +0900125extern int request_dma_bycap(const char **dmac, const char **caps,
126 const char *dev_id);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700127extern int get_dma_residue(unsigned int chan);
128extern struct dma_info *get_dma_info(unsigned int chan);
129extern struct dma_channel *get_dma_channel(unsigned int chan);
130extern void dma_wait_for_completion(unsigned int chan);
131extern void dma_configure_channel(unsigned int chan, unsigned long flags);
132
133extern int register_dmac(struct dma_info *info);
134extern void unregister_dmac(struct dma_info *info);
Mark Glaisherdb9b99d2006-11-24 15:13:52 +0900135extern struct dma_info *get_dma_info_by_name(const char *dmac_name);
136
137extern int dma_extend(unsigned int chan, unsigned long op, void *param);
138extern int register_chan_caps(const char *dmac, struct dma_chan_caps *capslist);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700139
Linus Torvalds1da177e2005-04-16 15:20:36 -0700140/* arch/sh/drivers/dma/dma-sysfs.c */
Paul Mundt0d831772006-01-16 22:14:09 -0800141extern int dma_create_sysfs_files(struct dma_channel *, struct dma_info *);
142extern void dma_remove_sysfs_files(struct dma_channel *, struct dma_info *);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700143
144#ifdef CONFIG_PCI
145extern int isa_dma_bridge_buggy;
146#else
147#define isa_dma_bridge_buggy (0)
148#endif
149
150#endif /* __KERNEL__ */
151#endif /* __ASM_SH_DMA_H */