USB: add USB test and measurement class driver
[linux-2.6] / include / asm-mn10300 / dma-mapping.h
1 /* DMA mapping routines for the MN10300 arch
2  *
3  * Copyright (C) 2007 Red Hat, Inc. All Rights Reserved.
4  * Written by David Howells (dhowells@redhat.com)
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public Licence
8  * as published by the Free Software Foundation; either version
9  * 2 of the Licence, or (at your option) any later version.
10  */
11 #ifndef _ASM_DMA_MAPPING_H
12 #define _ASM_DMA_MAPPING_H
13
14 #include <linux/mm.h>
15 #include <linux/scatterlist.h>
16
17 #include <asm/cache.h>
18 #include <asm/io.h>
19
20 extern void *dma_alloc_coherent(struct device *dev, size_t size,
21                                 dma_addr_t *dma_handle, int flag);
22
23 extern void dma_free_coherent(struct device *dev, size_t size,
24                               void *vaddr, dma_addr_t dma_handle);
25
26 #define dma_alloc_noncoherent(d, s, h, f) dma_alloc_coherent((d), (s), (h), (f))
27 #define dma_free_noncoherent(d, s, v, h)  dma_free_coherent((d), (s), (v), (h))
28
29 /*
30  * Map a single buffer of the indicated size for DMA in streaming mode.  The
31  * 32-bit bus address to use is returned.
32  *
33  * Once the device is given the dma address, the device owns this memory until
34  * either pci_unmap_single or pci_dma_sync_single is performed.
35  */
36 static inline
37 dma_addr_t dma_map_single(struct device *dev, void *ptr, size_t size,
38                           enum dma_data_direction direction)
39 {
40         BUG_ON(direction == DMA_NONE);
41         mn10300_dcache_flush_inv();
42         return virt_to_bus(ptr);
43 }
44
45 /*
46  * Unmap a single streaming mode DMA translation.  The dma_addr and size must
47  * match what was provided for in a previous pci_map_single call.  All other
48  * usages are undefined.
49  *
50  * After this call, reads by the cpu to the buffer are guarenteed to see
51  * whatever the device wrote there.
52  */
53 static inline
54 void dma_unmap_single(struct device *dev, dma_addr_t dma_addr, size_t size,
55                       enum dma_data_direction direction)
56 {
57         BUG_ON(direction == DMA_NONE);
58 }
59
60 /*
61  * Map a set of buffers described by scatterlist in streaming mode for DMA.
62  * This is the scather-gather version of the above pci_map_single interface.
63  * Here the scatter gather list elements are each tagged with the appropriate
64  * dma address and length.  They are obtained via sg_dma_{address,length}(SG).
65  *
66  * NOTE: An implementation may be able to use a smaller number of DMA
67  *       address/length pairs than there are SG table elements.  (for example
68  *       via virtual mapping capabilities) The routine returns the number of
69  *       addr/length pairs actually used, at most nents.
70  *
71  * Device ownership issues as mentioned above for pci_map_single are the same
72  * here.
73  */
74 static inline
75 int dma_map_sg(struct device *dev, struct scatterlist *sglist, int nents,
76                enum dma_data_direction direction)
77 {
78         struct scatterlist *sg;
79         int i;
80
81         BUG_ON(!valid_dma_direction(direction));
82         WARN_ON(nents == 0 || sglist[0].length == 0);
83
84         for_each_sg(sglist, sg, nents, i) {
85                 BUG_ON(!sg_page(sg));
86
87                 sg->dma_address = sg_phys(sg);
88         }
89
90         mn10300_dcache_flush_inv();
91         return nents;
92 }
93
94 /*
95  * Unmap a set of streaming mode DMA translations.
96  * Again, cpu read rules concerning calls here are the same as for
97  * pci_unmap_single() above.
98  */
99 static inline
100 void dma_unmap_sg(struct device *dev, struct scatterlist *sg, int nhwentries,
101                   enum dma_data_direction direction)
102 {
103         BUG_ON(!valid_dma_direction(direction));
104 }
105
106 /*
107  * pci_{map,unmap}_single_page maps a kernel page to a dma_addr_t. identical
108  * to pci_map_single, but takes a struct page instead of a virtual address
109  */
110 static inline
111 dma_addr_t dma_map_page(struct device *dev, struct page *page,
112                         unsigned long offset, size_t size,
113                         enum dma_data_direction direction)
114 {
115         BUG_ON(direction == DMA_NONE);
116         return page_to_bus(page) + offset;
117 }
118
119 static inline
120 void dma_unmap_page(struct device *dev, dma_addr_t dma_address, size_t size,
121                     enum dma_data_direction direction)
122 {
123         BUG_ON(direction == DMA_NONE);
124 }
125
126 /*
127  * Make physical memory consistent for a single streaming mode DMA translation
128  * after a transfer.
129  *
130  * If you perform a pci_map_single() but wish to interrogate the buffer using
131  * the cpu, yet do not wish to teardown the PCI dma mapping, you must call this
132  * function before doing so.  At the next point you give the PCI dma address
133  * back to the card, the device again owns the buffer.
134  */
135 static inline
136 void dma_sync_single_for_cpu(struct device *dev, dma_addr_t dma_handle,
137                              size_t size, enum dma_data_direction direction)
138 {
139 }
140
141 static inline
142 void dma_sync_single_for_device(struct device *dev, dma_addr_t dma_handle,
143                                 size_t size, enum dma_data_direction direction)
144 {
145         mn10300_dcache_flush_inv();
146 }
147
148 static inline
149 void dma_sync_single_range_for_cpu(struct device *dev, dma_addr_t dma_handle,
150                                    unsigned long offset, size_t size,
151                                    enum dma_data_direction direction)
152 {
153 }
154
155 static inline void
156 dma_sync_single_range_for_device(struct device *dev, dma_addr_t dma_handle,
157                                  unsigned long offset, size_t size,
158                                  enum dma_data_direction direction)
159 {
160         mn10300_dcache_flush_inv();
161 }
162
163
164 /*
165  * Make physical memory consistent for a set of streaming mode DMA translations
166  * after a transfer.
167  *
168  * The same as pci_dma_sync_single but for a scatter-gather list, same rules
169  * and usage.
170  */
171 static inline
172 void dma_sync_sg_for_cpu(struct device *dev, struct scatterlist *sg,
173                          int nelems, enum dma_data_direction direction)
174 {
175 }
176
177 static inline
178 void dma_sync_sg_for_device(struct device *dev, struct scatterlist *sg,
179                             int nelems, enum dma_data_direction direction)
180 {
181         mn10300_dcache_flush_inv();
182 }
183
184 static inline
185 int dma_mapping_error(struct device *dev, dma_addr_t dma_addr)
186 {
187         return 0;
188 }
189
190 /*
191  * Return whether the given PCI device DMA address mask can be supported
192  * properly.  For example, if your device can only drive the low 24-bits during
193  * PCI bus mastering, then you would pass 0x00ffffff as the mask to this
194  * function.
195  */
196 static inline
197 int dma_supported(struct device *dev, u64 mask)
198 {
199         /*
200          * we fall back to GFP_DMA when the mask isn't all 1s, so we can't
201          * guarantee allocations that must be within a tighter range than
202          * GFP_DMA
203          */
204         if (mask < 0x00ffffff)
205                 return 0;
206         return 1;
207 }
208
209 static inline
210 int dma_set_mask(struct device *dev, u64 mask)
211 {
212         if (!dev->dma_mask || !dma_supported(dev, mask))
213                 return -EIO;
214
215         *dev->dma_mask = mask;
216         return 0;
217 }
218
219 static inline
220 int dma_get_cache_alignment(void)
221 {
222         return 1 << L1_CACHE_SHIFT;
223 }
224
225 #define dma_is_consistent(d)    (1)
226
227 static inline
228 void dma_cache_sync(void *vaddr, size_t size,
229                     enum dma_data_direction direction)
230 {
231         mn10300_dcache_flush_inv();
232 }
233
234 #endif