dma-mapping.c 8.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363
  1. /*
  2. * drivers/base/dma-mapping.c - arch-independent dma-mapping routines
  3. *
  4. * Copyright (c) 2006 SUSE Linux Products GmbH
  5. * Copyright (c) 2006 Tejun Heo <teheo@suse.de>
  6. *
  7. * This file is released under the GPLv2.
  8. */
  9. #include <linux/acpi.h>
  10. #include <linux/dma-mapping.h>
  11. #include <linux/export.h>
  12. #include <linux/gfp.h>
  13. #include <linux/of_device.h>
  14. #include <linux/slab.h>
  15. #include <linux/vmalloc.h>
  16. /*
  17. * Managed DMA API
  18. */
  19. struct dma_devres {
  20. size_t size;
  21. void *vaddr;
  22. dma_addr_t dma_handle;
  23. };
  24. static void dmam_coherent_release(struct device *dev, void *res)
  25. {
  26. struct dma_devres *this = res;
  27. dma_free_coherent(dev, this->size, this->vaddr, this->dma_handle);
  28. }
  29. static void dmam_noncoherent_release(struct device *dev, void *res)
  30. {
  31. struct dma_devres *this = res;
  32. dma_free_noncoherent(dev, this->size, this->vaddr, this->dma_handle);
  33. }
  34. static int dmam_match(struct device *dev, void *res, void *match_data)
  35. {
  36. struct dma_devres *this = res, *match = match_data;
  37. if (this->vaddr == match->vaddr) {
  38. WARN_ON(this->size != match->size ||
  39. this->dma_handle != match->dma_handle);
  40. return 1;
  41. }
  42. return 0;
  43. }
  44. /**
  45. * dmam_alloc_coherent - Managed dma_alloc_coherent()
  46. * @dev: Device to allocate coherent memory for
  47. * @size: Size of allocation
  48. * @dma_handle: Out argument for allocated DMA handle
  49. * @gfp: Allocation flags
  50. *
  51. * Managed dma_alloc_coherent(). Memory allocated using this function
  52. * will be automatically released on driver detach.
  53. *
  54. * RETURNS:
  55. * Pointer to allocated memory on success, NULL on failure.
  56. */
  57. void *dmam_alloc_coherent(struct device *dev, size_t size,
  58. dma_addr_t *dma_handle, gfp_t gfp)
  59. {
  60. struct dma_devres *dr;
  61. void *vaddr;
  62. dr = devres_alloc(dmam_coherent_release, sizeof(*dr), gfp);
  63. if (!dr)
  64. return NULL;
  65. vaddr = dma_alloc_coherent(dev, size, dma_handle, gfp);
  66. if (!vaddr) {
  67. devres_free(dr);
  68. return NULL;
  69. }
  70. dr->vaddr = vaddr;
  71. dr->dma_handle = *dma_handle;
  72. dr->size = size;
  73. devres_add(dev, dr);
  74. return vaddr;
  75. }
  76. EXPORT_SYMBOL(dmam_alloc_coherent);
  77. /**
  78. * dmam_free_coherent - Managed dma_free_coherent()
  79. * @dev: Device to free coherent memory for
  80. * @size: Size of allocation
  81. * @vaddr: Virtual address of the memory to free
  82. * @dma_handle: DMA handle of the memory to free
  83. *
  84. * Managed dma_free_coherent().
  85. */
  86. void dmam_free_coherent(struct device *dev, size_t size, void *vaddr,
  87. dma_addr_t dma_handle)
  88. {
  89. struct dma_devres match_data = { size, vaddr, dma_handle };
  90. dma_free_coherent(dev, size, vaddr, dma_handle);
  91. WARN_ON(devres_destroy(dev, dmam_coherent_release, dmam_match,
  92. &match_data));
  93. }
  94. EXPORT_SYMBOL(dmam_free_coherent);
  95. /**
  96. * dmam_alloc_non_coherent - Managed dma_alloc_noncoherent()
  97. * @dev: Device to allocate non_coherent memory for
  98. * @size: Size of allocation
  99. * @dma_handle: Out argument for allocated DMA handle
  100. * @gfp: Allocation flags
  101. *
  102. * Managed dma_alloc_noncoherent(). Memory allocated using this
  103. * function will be automatically released on driver detach.
  104. *
  105. * RETURNS:
  106. * Pointer to allocated memory on success, NULL on failure.
  107. */
  108. void *dmam_alloc_noncoherent(struct device *dev, size_t size,
  109. dma_addr_t *dma_handle, gfp_t gfp)
  110. {
  111. struct dma_devres *dr;
  112. void *vaddr;
  113. dr = devres_alloc(dmam_noncoherent_release, sizeof(*dr), gfp);
  114. if (!dr)
  115. return NULL;
  116. vaddr = dma_alloc_noncoherent(dev, size, dma_handle, gfp);
  117. if (!vaddr) {
  118. devres_free(dr);
  119. return NULL;
  120. }
  121. dr->vaddr = vaddr;
  122. dr->dma_handle = *dma_handle;
  123. dr->size = size;
  124. devres_add(dev, dr);
  125. return vaddr;
  126. }
  127. EXPORT_SYMBOL(dmam_alloc_noncoherent);
  128. #ifdef CONFIG_HAVE_GENERIC_DMA_COHERENT
  129. static void dmam_coherent_decl_release(struct device *dev, void *res)
  130. {
  131. dma_release_declared_memory(dev);
  132. }
  133. /**
  134. * dmam_declare_coherent_memory - Managed dma_declare_coherent_memory()
  135. * @dev: Device to declare coherent memory for
  136. * @phys_addr: Physical address of coherent memory to be declared
  137. * @device_addr: Device address of coherent memory to be declared
  138. * @size: Size of coherent memory to be declared
  139. * @flags: Flags
  140. *
  141. * Managed dma_declare_coherent_memory().
  142. *
  143. * RETURNS:
  144. * 0 on success, -errno on failure.
  145. */
  146. int dmam_declare_coherent_memory(struct device *dev, phys_addr_t phys_addr,
  147. dma_addr_t device_addr, size_t size, int flags)
  148. {
  149. void *res;
  150. int rc;
  151. res = devres_alloc(dmam_coherent_decl_release, 0, GFP_KERNEL);
  152. if (!res)
  153. return -ENOMEM;
  154. rc = dma_declare_coherent_memory(dev, phys_addr, device_addr, size,
  155. flags);
  156. if (rc) {
  157. devres_add(dev, res);
  158. rc = 0;
  159. } else {
  160. devres_free(res);
  161. rc = -ENOMEM;
  162. }
  163. return rc;
  164. }
  165. EXPORT_SYMBOL(dmam_declare_coherent_memory);
  166. /**
  167. * dmam_release_declared_memory - Managed dma_release_declared_memory().
  168. * @dev: Device to release declared coherent memory for
  169. *
  170. * Managed dmam_release_declared_memory().
  171. */
  172. void dmam_release_declared_memory(struct device *dev)
  173. {
  174. WARN_ON(devres_destroy(dev, dmam_coherent_decl_release, NULL, NULL));
  175. }
  176. EXPORT_SYMBOL(dmam_release_declared_memory);
  177. #endif
  178. /*
  179. * Create scatter-list for the already allocated DMA buffer.
  180. */
  181. int dma_common_get_sgtable(struct device *dev, struct sg_table *sgt,
  182. void *cpu_addr, dma_addr_t handle, size_t size)
  183. {
  184. struct page *page = virt_to_page(cpu_addr);
  185. int ret;
  186. ret = sg_alloc_table(sgt, 1, GFP_KERNEL);
  187. if (unlikely(ret))
  188. return ret;
  189. sg_set_page(sgt->sgl, page, PAGE_ALIGN(size), 0);
  190. return 0;
  191. }
  192. EXPORT_SYMBOL(dma_common_get_sgtable);
  193. /*
  194. * Create userspace mapping for the DMA-coherent memory.
  195. */
  196. int dma_common_mmap(struct device *dev, struct vm_area_struct *vma,
  197. void *cpu_addr, dma_addr_t dma_addr, size_t size)
  198. {
  199. int ret = -ENXIO;
  200. #if defined(CONFIG_MMU) && !defined(CONFIG_ARCH_NO_COHERENT_DMA_MMAP)
  201. unsigned long user_count = vma_pages(vma);
  202. unsigned long count = PAGE_ALIGN(size) >> PAGE_SHIFT;
  203. unsigned long pfn = page_to_pfn(virt_to_page(cpu_addr));
  204. unsigned long off = vma->vm_pgoff;
  205. vma->vm_page_prot = pgprot_noncached(vma->vm_page_prot);
  206. if (dma_mmap_from_coherent(dev, vma, cpu_addr, size, &ret))
  207. return ret;
  208. if (off < count && user_count <= (count - off)) {
  209. ret = remap_pfn_range(vma, vma->vm_start,
  210. pfn + off,
  211. user_count << PAGE_SHIFT,
  212. vma->vm_page_prot);
  213. }
  214. #endif /* CONFIG_MMU && !CONFIG_ARCH_NO_COHERENT_DMA_MMAP */
  215. return ret;
  216. }
  217. EXPORT_SYMBOL(dma_common_mmap);
  218. #ifdef CONFIG_MMU
  219. /*
  220. * remaps an array of PAGE_SIZE pages into another vm_area
  221. * Cannot be used in non-sleeping contexts
  222. */
  223. void *dma_common_pages_remap(struct page **pages, size_t size,
  224. unsigned long vm_flags, pgprot_t prot,
  225. const void *caller)
  226. {
  227. struct vm_struct *area;
  228. area = get_vm_area_caller(size, vm_flags, caller);
  229. if (!area)
  230. return NULL;
  231. area->pages = pages;
  232. if (map_vm_area(area, prot, pages)) {
  233. vunmap(area->addr);
  234. return NULL;
  235. }
  236. return area->addr;
  237. }
  238. /*
  239. * remaps an allocated contiguous region into another vm_area.
  240. * Cannot be used in non-sleeping contexts
  241. */
  242. void *dma_common_contiguous_remap(struct page *page, size_t size,
  243. unsigned long vm_flags,
  244. pgprot_t prot, const void *caller)
  245. {
  246. int i;
  247. struct page **pages;
  248. void *ptr;
  249. pages = kmalloc(sizeof(struct page *) << get_order(size), GFP_KERNEL);
  250. if (!pages)
  251. return NULL;
  252. for (i = 0; i < (size >> PAGE_SHIFT); i++)
  253. pages[i] = nth_page(page, i);
  254. ptr = dma_common_pages_remap(pages, size, vm_flags, prot, caller);
  255. kfree(pages);
  256. return ptr;
  257. }
  258. /*
  259. * unmaps a range previously mapped by dma_common_*_remap
  260. */
  261. void dma_common_free_remap(void *cpu_addr, size_t size, unsigned long vm_flags)
  262. {
  263. struct vm_struct *area = find_vm_area(cpu_addr);
  264. if (!area || (area->flags & vm_flags) != vm_flags) {
  265. WARN(1, "trying to free invalid coherent area: %p\n", cpu_addr);
  266. return;
  267. }
  268. unmap_kernel_range((unsigned long)cpu_addr, PAGE_ALIGN(size));
  269. vunmap(cpu_addr);
  270. }
  271. #endif
  272. /*
  273. * Common configuration to enable DMA API use for a device
  274. */
  275. #include <linux/pci.h>
  276. int dma_configure(struct device *dev)
  277. {
  278. struct device *bridge = NULL, *dma_dev = dev;
  279. enum dev_dma_attr attr;
  280. int ret = 0;
  281. if (dev_is_pci(dev)) {
  282. bridge = pci_get_host_bridge_device(to_pci_dev(dev));
  283. dma_dev = bridge;
  284. if (IS_ENABLED(CONFIG_OF) && dma_dev->parent &&
  285. dma_dev->parent->of_node)
  286. dma_dev = dma_dev->parent;
  287. }
  288. if (dma_dev->of_node) {
  289. ret = of_dma_configure(dev, dma_dev->of_node);
  290. } else if (has_acpi_companion(dma_dev)) {
  291. attr = acpi_get_dma_attr(to_acpi_device_node(dma_dev->fwnode));
  292. if (attr != DEV_DMA_NOT_SUPPORTED)
  293. ret = acpi_dma_configure(dev, attr);
  294. }
  295. if (bridge)
  296. pci_put_host_bridge_device(bridge);
  297. return ret;
  298. }
  299. void dma_deconfigure(struct device *dev)
  300. {
  301. of_dma_deconfigure(dev);
  302. acpi_dma_deconfigure(dev);
  303. }