2 * SWIOTLB-based DMA API implementation
4 * Copyright (C) 2012 ARM Ltd.
5 * Author: Catalin Marinas <catalin.marinas@arm.com>
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
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.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
20 #include <linux/gfp.h>
21 #include <linux/export.h>
22 #include <linux/slab.h>
23 #include <linux/genalloc.h>
24 #include <linux/dma-mapping.h>
25 #include <linux/dma-contiguous.h>
26 #include <linux/vmalloc.h>
27 #include <linux/swiotlb.h>
29 #include <asm/cacheflush.h>
31 struct dma_map_ops
*dma_ops
;
32 EXPORT_SYMBOL(dma_ops
);
34 static pgprot_t
__get_dma_pgprot(struct dma_attrs
*attrs
, pgprot_t prot
,
37 if (!coherent
|| dma_get_attr(DMA_ATTR_WRITE_COMBINE
, attrs
))
38 return pgprot_writecombine(prot
);
42 static struct gen_pool
*atomic_pool
;
44 #define DEFAULT_DMA_COHERENT_POOL_SIZE SZ_256K
45 static size_t atomic_pool_size
= DEFAULT_DMA_COHERENT_POOL_SIZE
;
47 static int __init
early_coherent_pool(char *p
)
49 atomic_pool_size
= memparse(p
, &p
);
52 early_param("coherent_pool", early_coherent_pool
);
54 static void *__alloc_from_pool(size_t size
, struct page
**ret_page
, gfp_t flags
)
60 WARN(1, "coherent pool not initialised!\n");
64 val
= gen_pool_alloc(atomic_pool
, size
);
66 phys_addr_t phys
= gen_pool_virt_to_phys(atomic_pool
, val
);
68 *ret_page
= phys_to_page(phys
);
76 static bool __in_atomic_pool(void *start
, size_t size
)
78 return addr_in_gen_pool(atomic_pool
, (unsigned long)start
, size
);
81 static int __free_from_pool(void *start
, size_t size
)
83 if (!__in_atomic_pool(start
, size
))
86 gen_pool_free(atomic_pool
, (unsigned long)start
, size
);
91 static void *__dma_alloc_coherent(struct device
*dev
, size_t size
,
92 dma_addr_t
*dma_handle
, gfp_t flags
,
93 struct dma_attrs
*attrs
)
96 WARN_ONCE(1, "Use an actual device structure for DMA allocation\n");
100 if (IS_ENABLED(CONFIG_ZONE_DMA
) &&
101 dev
->coherent_dma_mask
<= DMA_BIT_MASK(32))
103 if (IS_ENABLED(CONFIG_DMA_CMA
) && (flags
& __GFP_WAIT
)) {
107 page
= dma_alloc_from_contiguous(dev
, size
>> PAGE_SHIFT
,
112 *dma_handle
= phys_to_dma(dev
, page_to_phys(page
));
113 addr
= page_address(page
);
114 memset(addr
, 0, size
);
117 return swiotlb_alloc_coherent(dev
, size
, dma_handle
, flags
);
121 static void __dma_free_coherent(struct device
*dev
, size_t size
,
122 void *vaddr
, dma_addr_t dma_handle
,
123 struct dma_attrs
*attrs
)
126 phys_addr_t paddr
= dma_to_phys(dev
, dma_handle
);
129 WARN_ONCE(1, "Use an actual device structure for DMA allocation\n");
133 freed
= dma_release_from_contiguous(dev
,
137 swiotlb_free_coherent(dev
, size
, vaddr
, dma_handle
);
140 static void *__dma_alloc(struct device
*dev
, size_t size
,
141 dma_addr_t
*dma_handle
, gfp_t flags
,
142 struct dma_attrs
*attrs
)
145 void *ptr
, *coherent_ptr
;
146 bool coherent
= is_device_dma_coherent(dev
);
147 pgprot_t prot
= __get_dma_pgprot(attrs
, PAGE_KERNEL
, false);
149 size
= PAGE_ALIGN(size
);
151 if (!coherent
&& !(flags
& __GFP_WAIT
)) {
152 struct page
*page
= NULL
;
153 void *addr
= __alloc_from_pool(size
, &page
, flags
);
156 *dma_handle
= phys_to_dma(dev
, page_to_phys(page
));
161 ptr
= __dma_alloc_coherent(dev
, size
, dma_handle
, flags
, attrs
);
165 /* no need for non-cacheable mapping if coherent */
169 /* remove any dirty cache lines on the kernel alias */
170 __dma_flush_range(ptr
, ptr
+ size
);
172 /* create a coherent mapping */
173 page
= virt_to_page(ptr
);
174 coherent_ptr
= dma_common_contiguous_remap(page
, size
, VM_USERMAP
,
182 __dma_free_coherent(dev
, size
, ptr
, *dma_handle
, attrs
);
184 *dma_handle
= DMA_ERROR_CODE
;
188 static void __dma_free(struct device
*dev
, size_t size
,
189 void *vaddr
, dma_addr_t dma_handle
,
190 struct dma_attrs
*attrs
)
192 void *swiotlb_addr
= phys_to_virt(dma_to_phys(dev
, dma_handle
));
194 size
= PAGE_ALIGN(size
);
196 if (!is_device_dma_coherent(dev
)) {
197 if (__free_from_pool(vaddr
, size
))
201 __dma_free_coherent(dev
, size
, swiotlb_addr
, dma_handle
, attrs
);
204 static dma_addr_t
__swiotlb_map_page(struct device
*dev
, struct page
*page
,
205 unsigned long offset
, size_t size
,
206 enum dma_data_direction dir
,
207 struct dma_attrs
*attrs
)
211 dev_addr
= swiotlb_map_page(dev
, page
, offset
, size
, dir
, attrs
);
212 if (!is_device_dma_coherent(dev
))
213 __dma_map_area(phys_to_virt(dma_to_phys(dev
, dev_addr
)), size
, dir
);
219 static void __swiotlb_unmap_page(struct device
*dev
, dma_addr_t dev_addr
,
220 size_t size
, enum dma_data_direction dir
,
221 struct dma_attrs
*attrs
)
223 if (!is_device_dma_coherent(dev
))
224 __dma_unmap_area(phys_to_virt(dma_to_phys(dev
, dev_addr
)), size
, dir
);
225 swiotlb_unmap_page(dev
, dev_addr
, size
, dir
, attrs
);
228 static int __swiotlb_map_sg_attrs(struct device
*dev
, struct scatterlist
*sgl
,
229 int nelems
, enum dma_data_direction dir
,
230 struct dma_attrs
*attrs
)
232 struct scatterlist
*sg
;
235 ret
= swiotlb_map_sg_attrs(dev
, sgl
, nelems
, dir
, attrs
);
236 if (!is_device_dma_coherent(dev
))
237 for_each_sg(sgl
, sg
, ret
, i
)
238 __dma_map_area(phys_to_virt(dma_to_phys(dev
, sg
->dma_address
)),
244 static void __swiotlb_unmap_sg_attrs(struct device
*dev
,
245 struct scatterlist
*sgl
, int nelems
,
246 enum dma_data_direction dir
,
247 struct dma_attrs
*attrs
)
249 struct scatterlist
*sg
;
252 if (!is_device_dma_coherent(dev
))
253 for_each_sg(sgl
, sg
, nelems
, i
)
254 __dma_unmap_area(phys_to_virt(dma_to_phys(dev
, sg
->dma_address
)),
256 swiotlb_unmap_sg_attrs(dev
, sgl
, nelems
, dir
, attrs
);
259 static void __swiotlb_sync_single_for_cpu(struct device
*dev
,
260 dma_addr_t dev_addr
, size_t size
,
261 enum dma_data_direction dir
)
263 if (!is_device_dma_coherent(dev
))
264 __dma_unmap_area(phys_to_virt(dma_to_phys(dev
, dev_addr
)), size
, dir
);
265 swiotlb_sync_single_for_cpu(dev
, dev_addr
, size
, dir
);
268 static void __swiotlb_sync_single_for_device(struct device
*dev
,
269 dma_addr_t dev_addr
, size_t size
,
270 enum dma_data_direction dir
)
272 swiotlb_sync_single_for_device(dev
, dev_addr
, size
, dir
);
273 if (!is_device_dma_coherent(dev
))
274 __dma_map_area(phys_to_virt(dma_to_phys(dev
, dev_addr
)), size
, dir
);
277 static void __swiotlb_sync_sg_for_cpu(struct device
*dev
,
278 struct scatterlist
*sgl
, int nelems
,
279 enum dma_data_direction dir
)
281 struct scatterlist
*sg
;
284 if (!is_device_dma_coherent(dev
))
285 for_each_sg(sgl
, sg
, nelems
, i
)
286 __dma_unmap_area(phys_to_virt(dma_to_phys(dev
, sg
->dma_address
)),
288 swiotlb_sync_sg_for_cpu(dev
, sgl
, nelems
, dir
);
291 static void __swiotlb_sync_sg_for_device(struct device
*dev
,
292 struct scatterlist
*sgl
, int nelems
,
293 enum dma_data_direction dir
)
295 struct scatterlist
*sg
;
298 swiotlb_sync_sg_for_device(dev
, sgl
, nelems
, dir
);
299 if (!is_device_dma_coherent(dev
))
300 for_each_sg(sgl
, sg
, nelems
, i
)
301 __dma_map_area(phys_to_virt(dma_to_phys(dev
, sg
->dma_address
)),
305 static int __swiotlb_mmap(struct device
*dev
,
306 struct vm_area_struct
*vma
,
307 void *cpu_addr
, dma_addr_t dma_addr
, size_t size
,
308 struct dma_attrs
*attrs
)
311 unsigned long nr_vma_pages
= (vma
->vm_end
- vma
->vm_start
) >>
313 unsigned long nr_pages
= PAGE_ALIGN(size
) >> PAGE_SHIFT
;
314 unsigned long pfn
= dma_to_phys(dev
, dma_addr
) >> PAGE_SHIFT
;
315 unsigned long off
= vma
->vm_pgoff
;
317 vma
->vm_page_prot
= __get_dma_pgprot(attrs
, vma
->vm_page_prot
,
318 is_device_dma_coherent(dev
));
320 if (dma_mmap_from_coherent(dev
, vma
, cpu_addr
, size
, &ret
))
323 if (off
< nr_pages
&& nr_vma_pages
<= (nr_pages
- off
)) {
324 ret
= remap_pfn_range(vma
, vma
->vm_start
,
326 vma
->vm_end
- vma
->vm_start
,
333 static int __swiotlb_get_sgtable(struct device
*dev
, struct sg_table
*sgt
,
334 void *cpu_addr
, dma_addr_t handle
, size_t size
,
335 struct dma_attrs
*attrs
)
337 int ret
= sg_alloc_table(sgt
, 1, GFP_KERNEL
);
340 sg_set_page(sgt
->sgl
, phys_to_page(dma_to_phys(dev
, handle
)),
341 PAGE_ALIGN(size
), 0);
346 static struct dma_map_ops swiotlb_dma_ops
= {
347 .alloc
= __dma_alloc
,
349 .mmap
= __swiotlb_mmap
,
350 .get_sgtable
= __swiotlb_get_sgtable
,
351 .map_page
= __swiotlb_map_page
,
352 .unmap_page
= __swiotlb_unmap_page
,
353 .map_sg
= __swiotlb_map_sg_attrs
,
354 .unmap_sg
= __swiotlb_unmap_sg_attrs
,
355 .sync_single_for_cpu
= __swiotlb_sync_single_for_cpu
,
356 .sync_single_for_device
= __swiotlb_sync_single_for_device
,
357 .sync_sg_for_cpu
= __swiotlb_sync_sg_for_cpu
,
358 .sync_sg_for_device
= __swiotlb_sync_sg_for_device
,
359 .dma_supported
= swiotlb_dma_supported
,
360 .mapping_error
= swiotlb_dma_mapping_error
,
363 static int __init
atomic_pool_init(void)
365 pgprot_t prot
= __pgprot(PROT_NORMAL_NC
);
366 unsigned long nr_pages
= atomic_pool_size
>> PAGE_SHIFT
;
369 unsigned int pool_size_order
= get_order(atomic_pool_size
);
371 if (dev_get_cma_area(NULL
))
372 page
= dma_alloc_from_contiguous(NULL
, nr_pages
,
375 page
= alloc_pages(GFP_DMA
, pool_size_order
);
379 void *page_addr
= page_address(page
);
381 memset(page_addr
, 0, atomic_pool_size
);
382 __dma_flush_range(page_addr
, page_addr
+ atomic_pool_size
);
384 atomic_pool
= gen_pool_create(PAGE_SHIFT
, -1);
388 addr
= dma_common_contiguous_remap(page
, atomic_pool_size
,
389 VM_USERMAP
, prot
, atomic_pool_init
);
392 goto destroy_genpool
;
394 ret
= gen_pool_add_virt(atomic_pool
, (unsigned long)addr
,
396 atomic_pool_size
, -1);
400 gen_pool_set_algo(atomic_pool
,
401 gen_pool_first_fit_order_align
,
404 pr_info("DMA: preallocated %zu KiB pool for atomic allocations\n",
405 atomic_pool_size
/ 1024);
411 dma_common_free_remap(addr
, atomic_pool_size
, VM_USERMAP
);
413 gen_pool_destroy(atomic_pool
);
416 if (!dma_release_from_contiguous(NULL
, page
, nr_pages
))
417 __free_pages(page
, pool_size_order
);
419 pr_err("DMA: failed to allocate %zu KiB pool for atomic coherent allocation\n",
420 atomic_pool_size
/ 1024);
424 /********************************************
425 * The following APIs are for dummy DMA ops *
426 ********************************************/
428 static void *__dummy_alloc(struct device
*dev
, size_t size
,
429 dma_addr_t
*dma_handle
, gfp_t flags
,
430 struct dma_attrs
*attrs
)
435 static void __dummy_free(struct device
*dev
, size_t size
,
436 void *vaddr
, dma_addr_t dma_handle
,
437 struct dma_attrs
*attrs
)
441 static int __dummy_mmap(struct device
*dev
,
442 struct vm_area_struct
*vma
,
443 void *cpu_addr
, dma_addr_t dma_addr
, size_t size
,
444 struct dma_attrs
*attrs
)
449 static dma_addr_t
__dummy_map_page(struct device
*dev
, struct page
*page
,
450 unsigned long offset
, size_t size
,
451 enum dma_data_direction dir
,
452 struct dma_attrs
*attrs
)
454 return DMA_ERROR_CODE
;
457 static void __dummy_unmap_page(struct device
*dev
, dma_addr_t dev_addr
,
458 size_t size
, enum dma_data_direction dir
,
459 struct dma_attrs
*attrs
)
463 static int __dummy_map_sg(struct device
*dev
, struct scatterlist
*sgl
,
464 int nelems
, enum dma_data_direction dir
,
465 struct dma_attrs
*attrs
)
470 static void __dummy_unmap_sg(struct device
*dev
,
471 struct scatterlist
*sgl
, int nelems
,
472 enum dma_data_direction dir
,
473 struct dma_attrs
*attrs
)
477 static void __dummy_sync_single(struct device
*dev
,
478 dma_addr_t dev_addr
, size_t size
,
479 enum dma_data_direction dir
)
483 static void __dummy_sync_sg(struct device
*dev
,
484 struct scatterlist
*sgl
, int nelems
,
485 enum dma_data_direction dir
)
489 static int __dummy_mapping_error(struct device
*hwdev
, dma_addr_t dma_addr
)
494 static int __dummy_dma_supported(struct device
*hwdev
, u64 mask
)
499 struct dma_map_ops dummy_dma_ops
= {
500 .alloc
= __dummy_alloc
,
501 .free
= __dummy_free
,
502 .mmap
= __dummy_mmap
,
503 .map_page
= __dummy_map_page
,
504 .unmap_page
= __dummy_unmap_page
,
505 .map_sg
= __dummy_map_sg
,
506 .unmap_sg
= __dummy_unmap_sg
,
507 .sync_single_for_cpu
= __dummy_sync_single
,
508 .sync_single_for_device
= __dummy_sync_single
,
509 .sync_sg_for_cpu
= __dummy_sync_sg
,
510 .sync_sg_for_device
= __dummy_sync_sg
,
511 .mapping_error
= __dummy_mapping_error
,
512 .dma_supported
= __dummy_dma_supported
,
514 EXPORT_SYMBOL(dummy_dma_ops
);
516 static int __init
arm64_dma_init(void)
520 dma_ops
= &swiotlb_dma_ops
;
522 ret
= atomic_pool_init();
526 arch_initcall(arm64_dma_init
);
528 #define PREALLOC_DMA_DEBUG_ENTRIES 4096
530 static int __init
dma_debug_do_init(void)
532 dma_debug_init(PREALLOC_DMA_DEBUG_ENTRIES
);
535 fs_initcall(dma_debug_do_init
);